nexus-client

Async Python client for the Nexus AI infrastructure API.

Install

pip install nexus-client

Quick start

import asyncio
from nexus_client import AILayerClient

async def main():
    client = AILayerClient(
        base_url="https://your-nexus-host/api",
        api_key="your-api-key",
    )

    agent = await client.create_agent(
        name="assistant",
        model="openai/gpt-4o-mini",
        system_prompt="You are a helpful assistant.",
    )
    thread = await client.create_thread(agent_id=agent["id"])

    async for event in client.stream_chat(
        agent_id=agent["id"],
        thread_id=thread["id"],
        message={"role": "user", "content": [{"type": "text", "text": "Hello!"}]},
    ):
        if event.type == "delta" and event.text:
            print(event.text, end="", flush=True)

asyncio.run(main())

See the full docs for all methods and stream event types.