io-openagent-sdk 0.3.0

Config-as-code agent SDK

OpenAgents SDK

Build protocol-rich agents on top of a small, explicit runtime kernel.

OpenAgents is a config-as-code, async-first SDK for teams that want a clear single-agent runtime, a small set of strong extension seams, and enough room to invent product-specific middle protocols above the kernel.

Key public contracts in 0.3.0:

• RunContext[DepsT] for typed local dependency injection
• RunRequest / RunResult[OutputT] as structured runtime IO
• Runtime.run_stream() for event-level streaming projection
• RunUsage.cost_usd + RunBudget.max_cost_usd for cost tracking / budgeting
• StopReason for typed run termination state
• openagents CLI: schema, validate, list-plugins

What's new in 0.3.0: see CHANGELOG and the 0.2 → 0.3 migration guide.

Start Here

• English README
• 中文 README
• Developer Docs
• Repository Layout
• Examples

Quick Repo Workflow

Sync dependencies:

uv sync

Run the test suite:

uv run pytest -q

Run the smallest maintained example:

uv run python examples/quickstart/run_demo.py

Maintained Repo Shape

openagents/  SDK source
docs/        developer documentation
examples/    maintained runnable examples
tests/       unit and integration coverage

Current maintained examples:

• examples/quickstart/
• examples/production_coding_agent/