lite-agent-sdk

A small, async, provider-agnostic agent SDK for Python. It runs one agent turn at a time. You own the transcript.

Install

uv add lite-agent-sdk

The OpenAI and Anthropic SDKs are installed with the package.

API keys

Pass api_key= to Agent, or set the provider environment variable:

export OPENAI_API_KEY=sk-...
export ANTHROPIC_API_KEY=sk-ant-...

Quick start

import asyncio
from datetime import UTC, datetime
from uuid import uuid4

from lite_agent_sdk import Agent, Message


async def main() -> None:
    agent = Agent(
        model="anthropic/claude-haiku-4-5-20251001",
        system_prompt="Be brief.",
    )
    messages = [
        Message(id=str(uuid4()), role="user", content="Hello", created_at=datetime.now(UTC)),
    ]
    result = await agent.run(messages)
    print(result.output)


asyncio.run(main())

model is provider/model-id. Supported providers are openai and anthropic.

Docs

• Usage: agents, transcripts, tools, approval, streaming, and errors.
• Structured output: output_schema and provider notes.
• Technical design: the target API and design decisions.
• Changelog: published versions.

Development

uv sync
make lint
make format
make test

Releases follow docs/releasing.md. Python 3.13 or newer is required.