Quickstart

The fastest way to build on Cominty is one of the two official SDKs. Both are fully typed clients for the same chat API:

the Python SDK (cominty-sdk on PyPI), async;
the JavaScript SDK (@cominty-ai/sdk on npm), written in TypeScript, for Node, Bun, Deno, and edge workers.

This guide takes you from install to your first agent response.

Prefer raw HTTP? Every call the SDKs make is a standard HTTPS/JSON request against https://ds.cominty.com. Browse them in the API reference, each with a live playground.

Get started

Install the SDK

Python SDK
JavaScript SDK

pip install cominty-sdk        # or: uv add cominty-sdk

Requires Python 3.9+.

npm install @cominty-ai/sdk    # or: pnpm add, yarn add, bun add

Requires Node 20+, or any server-side runtime with a global fetch. The package is ESM only.

Get your credentials

From platform.cominty.ai, grab two things:

API key, from the API keys page.
User id, from your avatar → Profile (looks like user_31HPTBuBvX20xlQNAbvxjOxPbKB).

Export both so the client picks them up automatically. Treat the API key like a password.

export COMINTY_API_KEY="<your API key>"
export COMINTY_USER_ID="user_..."

Send your first message

Pick an agent id from platform.cominty.ai/agents and ask it something.

Python SDK
JavaScript SDK

import asyncio
from cominty_sdk import AsyncCominty

async def main():
    async with AsyncCominty() as client:      # reads COMINTY_API_KEY + COMINTY_USER_ID
        run = await client.chat.start(
            agent_id="__cominty_agents::agent.chat",
            message="What is Cominty?",
        )
        print(await run.text())               # blocks until the agent finishes

asyncio.run(main())

Save this as first-call.mjs and run node first-call.mjs:

import { Cominty } from '@cominty-ai/sdk'

const client = new Cominty() // reads COMINTY_API_KEY + COMINTY_USER_ID

const run = await client.chat.start({
    agentId: '__cominty_agents::agent.chat',
    message: 'What is Cominty?',
})
console.log(await run.text()) // waits until the agent finishes

Run the SDK on your server only. Building a client in a browser throws, so your API key never reaches a web page.

Printed a response? You’re ready to build.

Next, stream the agent’s progress, continue the conversation, and handle errors. See the Python SDK quickstart or the JavaScript SDK quickstart for examples, and the Python or JavaScript reference for the full surface. To control what the agent can use, read Capabilities and its use cases.

Need help? Reach out at hi@cominty.com.

Getting Started

Capabilities

Build with code

Concepts

Get started

​Get started

Get started