agents-sdk
Build agents with tools, conversations and streaming in Python.
The agents-sdk (fg-agents) provides a simple entry point for a model-backed assistant, plus lower-level control over tools, persistence, middleware and web integration.
Run your first agent → · Tools · API reference
Choose the right starting point
| Need | API | Guide |
|---|---|---|
| One answer | ask() |
Quickstart |
| A conversation with tools | Agent |
Core concepts |
| Incremental output | stream() or Agent.stream() |
Streaming |
| Durable conversations | SQLite or PostgreSQL repository | Persistence |
| Custom hooks and execution control | AgentEngine |
Tools and middleware |
| Coordinated specialists | Orchestrator |
Skills and orchestration |
| An HTTP service | create_app or create_agent_router |
Web integration |
Install
python -m pip install --upgrade "fg-agents[anthropic]"
Python 3.11 or later. Install the extra for your provider or integration. Current
documented release: 0.4.7. Check fg_agents.__version__ in your installed
environment, and pin fg-agents==0.4.7 in reproducible deployments.
Relationship to the environments-sdk
The environments-sdk defines and executes simulation rules. The agents-sdk runs an agent's reasoning and tools. They are independent packages. Use the environment's participant interface when connecting an agent; do not let the agent bypass the environment's rules.
License
Apache-2.0Released under the Apache License 2.0. Read the full license →