Quickstart - Cominty Docs

The fastest way to build on Cominty is the Python SDK — an async, fully-typed client for the chat API. This guide takes you from install to your first streamed agent response.

Prefer raw HTTP? Every call the SDK makes 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

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

Requires Python 3.9+.

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.

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())

Printed a response? You’re ready to build.

Next, stream the agent’s progress, continue the conversation, and handle errors — see the SDK quickstart for runnable examples, and the SDK reference for the full surface.

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

​Get started

Get started