How agno-agi/agno works
Agno is a self-improving agent platform: developers build agents, teams, and workflows; AgentOS serves them as secure, durable APIs and MCP services; and traces, evaluations, and conversation history support improvement. The graph combines documented product capabilities with the principal runtime modules identified by the source index. Several implementation relationships are not visible in the excerpts, so the graph shows only documented links and omits unverified internal call paths.
Main entry points: agent.py Agents · os.py AgentOS services · workflow.py Workflows · team.py Teams
Components 24
Agent authoring
- Agents
libs/agno/agno/agent/agent.py - Teams
libs/agno/agno/team/team.py - Workflows
libs/agno/agno/workflow/workflow.py - Workflow routing
libs/agno/agno/workflow/router.py - Workflow steps
libs/agno/agno/workflow/step.py
Execution runtime
- Agent runs
libs/agno/agno/run/agent.py - Model interface
libs/agno/agno/models/base.py - Tools and integrations
libs/agno/agno/tools/function.py - Knowledge and retrieval
libs/agno/agno - Component registry
libs/agno/agno/registry/registry.py - Runtime errors
libs/agno/agno/exceptions.py
Persistence and learning
- Agent sessions
libs/agno/agno/agent/_storage.py - Team sessions
libs/agno/agno/team/_storage.py - Database layer
libs/agno/agno/db/base.py - Result offloading
libs/agno/agno/offload/store.py - Learning and memory
libs/agno/agno/learn/machine.py
Platform services
- AgentOS services
libs/agno/agno/api/os.py - Authorization
libs/agno/agno/os/authz/native_engine.py - Scheduling
libs/agno/agno/db/schemas/scheduler.py
Monitoring and improvement
- Metrics and traces
libs/agno/agno/metrics.py - Evaluations
libs/agno/agno/eval/performance.py
Other components
- Developer
- Product, MCP, and chat clients
- Control Plane UI
Connections 24
- Developer → Agents: builds
README.md - Developer → Teams: combines agents
README.md - Developer → Workflows: builds
README.md - Workflows → Workflow routing: supports routing
README.md - Workflows → Workflow steps: supports steps
README.md - Agents → Agent runs: executes runs
- Agents → Model interface: uses models
- Agents → Tools and integrations: uses tools
- Agents → Knowledge and retrieval: uses knowledge
README.md - Agents → Agent sessions: persists sessions
libs/agno/agno/agent/_storage.py - Teams → Team sessions: persists sessions
libs/agno/agno/team/_storage.py - Agent sessions → Database layer: stores data
libs/agno/agno/agent/_storage.py - Team sessions → Database layer: stores data
libs/agno/agno/team/_storage.py - Agents → Learning and memory: supports learning
README.md - AgentOS services → Product, MCP, and chat clients: serves API and MCP
README.md - AgentOS services → Authorization: secures access
README.md - AgentOS services → Scheduling: schedules runs
README.md - AgentOS services → Agents: serves agents
README.md - AgentOS services → Teams: serves teams
README.md - AgentOS services → Workflows: serves workflows
README.md - Agents → Metrics and traces: emits metrics
- Agents → Evaluations: supports evaluation
- Metrics and traces → Control Plane UI: monitors activity
README.md - Evaluations → Learning and memory: informs improvement