Async

AsyncClient is the async twin of Client — same surface, awaited. It’s the native form (the sync client wraps it on a background event loop), so reach for it in asyncio programs, FastAPI handlers, and pipelines.

import asyncio
from cosmon_agent_sdk import AsyncClient

async def main() -> None:
    async with AsyncClient() as client:
        print(await client.run("What can you do?", agent="nexus").text())

asyncio.run(main())

Streaming is async for, and one process can drive several runs at once — useful behind an HTTP endpoint:

from fastapi import FastAPI
from cosmon_agent_sdk import AsyncClient

app = FastAPI()

@app.post("/analyze")
async def analyze(part_path: str) -> dict[str, str]:
    async with AsyncClient() as client:
        answer = await client.run(
            "Run a static structural study and report peak von Mises.",
            agent="solidworks",
            attachments=[part_path],
        ).text()
    return {"result": answer}

Reference: async

The full AsyncClient / AsyncRun / AsyncSession surface.

Multi-agent handoff Interactive REPL

Getting Started

CAD

CAE

Agent SDK

Deployment

Reference: async