soev-agents
Overview
Build and run agents. The runtime records each turn in a typed trace, and HTTP entrypoints serve an agent.
soev-agents is an event-sourced agent runtime: an agent turns inputs into an append-only, typed trace of events. The trace is the only state of a thread. What a model receives on a call follows from the code and the trace before that call, and from nothing else.
Install
soev-agents needs Python 3.12 or later.
pip install soev-agentsExtras add optional dependencies:
| Extra | Adds |
|---|---|
postgres | psycopg and its connection pool, for the Postgres stores |
otel | The OpenTelemetry API and SDK |
For example, pip install "soev-agents[postgres]" installs soev-agents with psycopg.
Where to start
- Tutorials: six tutorials that each build one agent, step by step. Start with the first one.
- How-to guides: recipes for one task each.
- Reference of
soev_agents: build agents withsoev_agents.runtimeandsoev_agents.toolkit, connect models and stores withsoev_agents.adapters, serve agents withsoev_agents.entrypoints.http, and test them withsoev_agents.testing. The reference ends with a glossary of its terms.