agno 2.2.13__py3-none-any.whl → 2.4.3__py3-none-any.whl

{agno-2.2.13.dist-info → agno-2.4.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agno
-Version: 2.2.13
+Version: 2.4.3
 Summary: Agno: a lightweight library for building Multi-Agent Systems
 Author-email: Ashpreet Bedi <ashpreet@agno.com>
 Project-URL: homepage, https://agno.com
@@ -24,7 +24,7 @@ License-File: LICENSE
 Requires-Dist: docstring-parser
 Requires-Dist: gitpython
 Requires-Dist: h11>=0.16.0
-Requires-Dist: httpx
+Requires-Dist: httpx[http2]
 Requires-Dist: packaging
 Requires-Dist: pydantic-settings
 Requires-Dist: pydantic
@@ -46,17 +46,15 @@ Requires-Dist: types-pyyaml; extra == "dev"
 Requires-Dist: types-aiofiles; extra == "dev"
 Requires-Dist: fastapi; extra == "dev"
 Requires-Dist: uvicorn; extra == "dev"
+Requires-Dist: PyJWT; extra == "dev"
+Requires-Dist: mcp; extra == "dev"
+Requires-Dist: openai; extra == "dev"
+Requires-Dist: fakeredis; extra == "dev"
+Requires-Dist: xlwt; extra == "dev"
 Provides-Extra: os
 Requires-Dist: fastapi; extra == "os"
 Requires-Dist: uvicorn; extra == "os"
 Requires-Dist: PyJWT; extra == "os"
-Provides-Extra: integration-tests
-Requires-Dist: exa_py; extra == "integration-tests"
-Requires-Dist: ddgs; extra == "integration-tests"
-Requires-Dist: yfinance; extra == "integration-tests"
-Requires-Dist: sqlalchemy; extra == "integration-tests"
-Requires-Dist: Pillow; extra == "integration-tests"
-Requires-Dist: fastmcp; extra == "integration-tests"
 Provides-Extra: opentelemetry
 Requires-Dist: opentelemetry-sdk; extra == "opentelemetry"
 Requires-Dist: opentelemetry-exporter-otlp; extra == "opentelemetry"
@@ -87,7 +85,7 @@ Requires-Dist: cohere; extra == "cohere"
 Provides-Extra: infinity
 Requires-Dist: infinity_client; extra == "infinity"
 Provides-Extra: google
-Requires-Dist: google-genai; extra == "google"
+Requires-Dist: google-genai>=1.52.0; extra == "google"
 Provides-Extra: groq
 Requires-Dist: groq; extra == "groq"
 Provides-Extra: ibm
@@ -106,6 +104,9 @@ Provides-Extra: openai
 Requires-Dist: openai; extra == "openai"
 Provides-Extra: portkey
 Requires-Dist: portkey-ai; extra == "portkey"
+Provides-Extra: tokenizers
+Requires-Dist: tiktoken; extra == "tokenizers"
+Requires-Dist: tokenizers; extra == "tokenizers"
 Provides-Extra: agentql
 Requires-Dist: agentql; extra == "agentql"
 Provides-Extra: apify
@@ -134,11 +135,11 @@ Requires-Dist: exa_py; extra == "exa"
 Provides-Extra: fal
 Requires-Dist: fal_client; extra == "fal"
 Provides-Extra: firecrawl
-Requires-Dist: firecrawl-py; extra == "firecrawl"
+Requires-Dist: firecrawl-py==3.4.0; extra == "firecrawl"
 Provides-Extra: tavily
 Requires-Dist: tavily-python; extra == "tavily"
 Provides-Extra: crawl4ai
-Requires-Dist: crawl4ai; extra == "crawl4ai"
+Requires-Dist: crawl4ai>=0.6.3; extra == "crawl4ai"
 Provides-Extra: github
 Requires-Dist: PyGithub; extra == "github"
 Provides-Extra: gmail
@@ -153,11 +154,11 @@ Requires-Dist: google-maps-places; extra == "googlemaps"
 Provides-Extra: matplotlib
 Requires-Dist: matplotlib; extra == "matplotlib"
 Provides-Extra: mcp
-Requires-Dist: mcp; extra == "mcp"
+Requires-Dist: mcp>=1.9.2; extra == "mcp"
 Provides-Extra: mem0
 Requires-Dist: mem0ai; extra == "mem0"
 Provides-Extra: memori
-Requires-Dist: memorisdk; extra == "memori"
+Requires-Dist: memori>=3.0.5; extra == "memori"
 Provides-Extra: newspaper
 Requires-Dist: newspaper4k; extra == "newspaper"
 Requires-Dist: lxml_html_clean; extra == "newspaper"
@@ -170,6 +171,8 @@ Requires-Dist: parallel-web; extra == "parallel"
 Provides-Extra: psycopg
 Requires-Dist: psycopg-binary; extra == "psycopg"
 Requires-Dist: psycopg; extra == "psycopg"
+Provides-Extra: redshift
+Requires-Dist: redshift-connector; extra == "redshift"
 Provides-Extra: reportlab
 Requires-Dist: reportlab; extra == "reportlab"
 Provides-Extra: scrapegraph
@@ -200,6 +203,9 @@ Provides-Extra: postgres
 Requires-Dist: psycopg-binary; extra == "postgres"
 Provides-Extra: async-postgres
 Requires-Dist: asyncpg; extra == "async-postgres"
+Provides-Extra: async-mongo
+Requires-Dist: pymongo>=4.9; extra == "async-mongo"
+Requires-Dist: motor; extra == "async-mongo"
 Provides-Extra: sqlite
 Requires-Dist: sqlalchemy; extra == "sqlite"
 Provides-Extra: gcs
@@ -208,13 +214,16 @@ Provides-Extra: firestore
 Requires-Dist: google-cloud-firestore; extra == "firestore"
 Provides-Extra: redis
 Requires-Dist: redis; extra == "redis"
-Requires-Dist: redisvl; extra == "redis"
+Requires-Dist: redisvl>=0.12.1; extra == "redis"
+Provides-Extra: mysql
+Requires-Dist: pymysql; extra == "mysql"
+Requires-Dist: asyncmy; extra == "mysql"
 Provides-Extra: pgvector
 Requires-Dist: pgvector; extra == "pgvector"
 Provides-Extra: chromadb
 Requires-Dist: chromadb; extra == "chromadb"
 Provides-Extra: lancedb
-Requires-Dist: lancedb>=0.24.0; extra == "lancedb"
+Requires-Dist: lancedb==0.24.0; extra == "lancedb"
 Requires-Dist: tantivy; extra == "lancedb"
 Provides-Extra: pylance
 Requires-Dist: pylance; extra == "pylance"
@@ -251,12 +260,16 @@ Provides-Extra: text
 Requires-Dist: aiofiles; extra == "text"
 Provides-Extra: csv
 Requires-Dist: aiofiles; extra == "csv"
+Provides-Extra: excel
+Requires-Dist: openpyxl; extra == "excel"
+Requires-Dist: xlrd; extra == "excel"
 Provides-Extra: markdown
 Requires-Dist: unstructured; extra == "markdown"
 Requires-Dist: markdown; extra == "markdown"
 Requires-Dist: aiofiles; extra == "markdown"
 Provides-Extra: chonkie
-Requires-Dist: chonkie[st]; extra == "chonkie"
+Requires-Dist: chonkie[semantic]; extra == "chonkie"
+Requires-Dist: chonkie[code]; extra == "chonkie"
 Requires-Dist: chonkie; extra == "chonkie"
 Provides-Extra: agui
 Requires-Dist: ag-ui-protocol; extra == "agui"
@@ -285,7 +298,6 @@ Requires-Dist: agno[cohere]; extra == "models"
 Requires-Dist: agno[google]; extra == "models"
 Requires-Dist: agno[groq]; extra == "models"
 Requires-Dist: agno[ibm]; extra == "models"
-Requires-Dist: agno[infinity]; extra == "models"
 Requires-Dist: agno[litellm]; extra == "models"
 Requires-Dist: agno[meta]; extra == "models"
 Requires-Dist: agno[mistral]; extra == "models"
@@ -295,7 +307,6 @@ Requires-Dist: agno[portkey]; extra == "models"
 Provides-Extra: tools
 Requires-Dist: agno[apify]; extra == "tools"
 Requires-Dist: agno[arxiv]; extra == "tools"
-Requires-Dist: agno[brave]; extra == "tools"
 Requires-Dist: agno[exa]; extra == "tools"
 Requires-Dist: agno[cartesia]; extra == "tools"
 Requires-Dist: agno[ddg]; extra == "tools"
@@ -321,6 +332,7 @@ Requires-Dist: agno[opencv]; extra == "tools"
 Requires-Dist: agno[parallel]; extra == "tools"
 Requires-Dist: agno[scrapegraph]; extra == "tools"
 Requires-Dist: agno[valyu]; extra == "tools"
+Requires-Dist: agno[yfinance]; extra == "tools"
 Requires-Dist: agno[confluence]; extra == "tools"
 Requires-Dist: agno[notion]; extra == "tools"
 Requires-Dist: agno[oxylabs]; extra == "tools"
@@ -329,6 +341,7 @@ Requires-Dist: agno[mem0]; extra == "tools"
 Requires-Dist: agno[memori]; extra == "tools"
 Requires-Dist: agno[google_bigquery]; extra == "tools"
 Requires-Dist: agno[psycopg]; extra == "tools"
+Requires-Dist: agno[redshift]; extra == "tools"
 Requires-Dist: agno[reportlab]; extra == "tools"
 Requires-Dist: agno[trafilatura]; extra == "tools"
 Requires-Dist: agno[neo4j]; extra == "tools"
@@ -336,6 +349,7 @@ Provides-Extra: storage
 Requires-Dist: agno[sql]; extra == "storage"
 Requires-Dist: agno[postgres]; extra == "storage"
 Requires-Dist: agno[async_postgres]; extra == "storage"
+Requires-Dist: agno[async_mongo]; extra == "storage"
 Requires-Dist: agno[sqlite]; extra == "storage"
 Requires-Dist: agno[gcs]; extra == "storage"
 Requires-Dist: agno[firestore]; extra == "storage"
@@ -355,18 +369,22 @@ Requires-Dist: agno[clickhouse]; extra == "vectordbs"
 Requires-Dist: agno[pinecone]; extra == "vectordbs"
 Requires-Dist: agno[surrealdb]; extra == "vectordbs"
 Requires-Dist: agno[upstash]; extra == "vectordbs"
+Requires-Dist: agno[pylance]; extra == "vectordbs"
+Requires-Dist: agno[redis]; extra == "vectordbs"
 Provides-Extra: knowledge
 Requires-Dist: agno[pdf]; extra == "knowledge"
 Requires-Dist: agno[docx]; extra == "knowledge"
 Requires-Dist: agno[pptx]; extra == "knowledge"
 Requires-Dist: agno[text]; extra == "knowledge"
 Requires-Dist: agno[csv]; extra == "knowledge"
+Requires-Dist: agno[excel]; extra == "knowledge"
 Requires-Dist: agno[markdown]; extra == "knowledge"
 Requires-Dist: agno[chonkie]; extra == "knowledge"
 Provides-Extra: embedders
 Requires-Dist: agno[huggingface]; extra == "embedders"
 Requires-Dist: agno[vllm]; extra == "embedders"
 Provides-Extra: tests
+Requires-Dist: agno[a2a]; extra == "tests"
 Requires-Dist: agno[dev]; extra == "tests"
 Requires-Dist: agno[models]; extra == "tests"
 Requires-Dist: agno[tools]; extra == "tests"
@@ -377,8 +395,40 @@ Requires-Dist: agno[embedders]; extra == "tests"
 Requires-Dist: agno[performance]; extra == "tests"
 Requires-Dist: agno[cookbooks]; extra == "tests"
 Requires-Dist: agno[agui]; extra == "tests"
+Requires-Dist: agno[integration-tests]; extra == "tests"
 Requires-Dist: twine; extra == "tests"
 Requires-Dist: build; extra == "tests"
+Requires-Dist: grpcio==1.74.0; extra == "tests"
+Provides-Extra: integration-tests
+Requires-Dist: exa_py; extra == "integration-tests"
+Requires-Dist: ddgs; extra == "integration-tests"
+Requires-Dist: yfinance; extra == "integration-tests"
+Requires-Dist: sqlalchemy; extra == "integration-tests"
+Requires-Dist: Pillow; extra == "integration-tests"
+Requires-Dist: fastmcp; extra == "integration-tests"
+Provides-Extra: demo
+Requires-Dist: agno[dev]; extra == "demo"
+Requires-Dist: anthropic; extra == "demo"
+Requires-Dist: chromadb; extra == "demo"
+Requires-Dist: ddgs; extra == "demo"
+Requires-Dist: fastapi[standard]; extra == "demo"
+Requires-Dist: google-genai; extra == "demo"
+Requires-Dist: matplotlib; extra == "demo"
+Requires-Dist: mcp; extra == "demo"
+Requires-Dist: nest_asyncio; extra == "demo"
+Requires-Dist: openai; extra == "demo"
+Requires-Dist: openinference-instrumentation-agno; extra == "demo"
+Requires-Dist: opentelemetry-api; extra == "demo"
+Requires-Dist: opentelemetry-sdk; extra == "demo"
+Requires-Dist: pandas; extra == "demo"
+Requires-Dist: parallel-web; extra == "demo"
+Requires-Dist: pgvector; extra == "demo"
+Requires-Dist: pillow; extra == "demo"
+Requires-Dist: psycopg[binary]; extra == "demo"
+Requires-Dist: pypdf; extra == "demo"
+Requires-Dist: sqlalchemy; extra == "demo"
+Requires-Dist: yfinance; extra == "demo"
+Requires-Dist: youtube-transcript-api; extra == "demo"
 Dynamic: license-file
 
 <div align="center" id="top">
@@ -391,224 +441,127 @@ Dynamic: license-file
   </a>
 </div>
 
+<p align="center">
+  Build, run, manage multi-agent systems.
+</p>
+
 <div align="center">
-  <a href="https://docs.agno.com">Documentation</a>
-  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
-  <a href="https://docs.agno.com/examples/introduction">Examples</a>
-  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
-  <a href="https://www.agno.com/?utm_source=github&utm_medium=readme&utm_campaign=agno-github">Website</a>
-  <br />
+  <a href="https://docs.agno.com">Docs</a>
+  <span>&nbsp;•&nbsp;</span>
+  <a href="https://github.com/agno-agi/agno/tree/main/cookbook">Cookbook</a>
+  <span>&nbsp;•&nbsp;</span>
+  <a href="https://community.agno.com/">Community</a>
+  <span>&nbsp;•&nbsp;</span>
+  <a href="https://www.agno.com/discord">Discord</a>
 </div>
 
 ## What is Agno?
 
-Agno is a multi-agent framework, runtime and control plane. Built for speed, privacy, and scale.
-
-It provides a rich set of tools for building:
-
-- **Agents** with memory, knowledge, session management, and advanced features like human-in-the-loop, guardrails, dynamic context management and best-in-class MCP support.
-- **Multi-Agent Teams** that operate autonomously under a team leader that maintains shared state and context. Perfect for use cases where the scope exceeds beyond a single agent.
-- **Step-based Workflows** for controlled, deterministic execution. Steps can be Agents, Teams, or regular python functions that run sequentially, in parallel, in loops, branches, or conditionally.
-
-Agno also provides a ready-to-use FastAPI app (called the AgentOS) for serving your agents, teams and workflows in production. Stateless, horizontally scalable and designed for scale, the AgentOS gives you major head start in building your AI product.
-
-## Getting started
-
-If you're new to Agno, follow our [quickstart](https://docs.agno.com/introduction/quickstart) to build your first Agent and chat with it using the AgentOS UI.
+Agno is a framework, runtime, and control plane for multi-agent systems.
 
-After that, checkout the [examples gallery](https://docs.agno.com/examples/introduction) and build real-world applications with Agno.
+| Layer | What it does |
+|-------|--------------|
+| **Framework** | Build agents, teams, and workflows with memory, knowledge, guardrails, and 100+ integrations |
+| **AgentOS Runtime** | Run your system in production with a stateless, secure FastAPI backend |
+| **Control Plane** | Test, monitor, and manage your system using the [AgentOS UI](https://os.agno.com) |
 
-## Documentation, Community & More Examples
+## Why Agno?
 
-- Docs: <a href="https://docs.agno.com" target="_blank" rel="noopener noreferrer">docs.agno.com</a>
-- Cookbook: <a href="https://github.com/agno-agi/agno/tree/main/cookbook" target="_blank" rel="noopener noreferrer">Cookbook</a>
-- Community forum: <a href="https://community.agno.com/" target="_blank" rel="noopener noreferrer">community.agno.com</a>
-- Discord: <a href="https://discord.gg/4MtYHHrgA8" target="_blank" rel="noopener noreferrer">discord</a>
+- **Private by design.** AgentOS runs in your cloud. The control plane connects directly to your runtime from your browser. No retention costs, no vendor lock-in, no compliance headaches.
+- **Production-ready on day one.** Pre-built FastAPI runtime with SSE endpoints, ready to deploy.
+- **Fast.** 529× faster instantiation than LangGraph. 24× lower memory. [See benchmarks →](#performance)
 
 ## Example
 
-Here’s an example of an Agent that connects to an MCP server, manages conversation state in a database, is served using a FastAPI application that you can chat with using the [AgentOS UI](https://os.agno.com).
-
-```python agno_agent.py
+An agent with MCP tools, persistent state, served via FastAPI:
+```python
 from agno.agent import Agent
 from agno.db.sqlite import SqliteDb
 from agno.models.anthropic import Claude
 from agno.os import AgentOS
 from agno.tools.mcp import MCPTools
 
-# ************* Create Agent *************
 agno_agent = Agent(
     name="Agno Agent",
     model=Claude(id="claude-sonnet-4-5"),
-    # Add a database to the Agent
     db=SqliteDb(db_file="agno.db"),
-    # Add the Agno MCP server to the Agent
     tools=[MCPTools(transport="streamable-http", url="https://docs.agno.com/mcp")],
-    # Add the previous session history to the context
     add_history_to_context=True,
     markdown=True,
 )
 
-
-# ************* Create AgentOS *************
 agent_os = AgentOS(agents=[agno_agent])
-# Get the FastAPI app for the AgentOS
 app = agent_os.get_app()
 
-# ************* Run AgentOS *************
 if __name__ == "__main__":
     agent_os.serve(app="agno_agent:app", reload=True)
 ```
 
-## AgentOS - Production Runtime for Multi-Agent Systems
-
-Building Agents is easy, running them is hard, and that's where the AgentOS comes in. AgentOS is a high-performance runtime for serving multi-agent systems in production. Key features include:
-
-1. **Pre-built FastAPI app**: AgentOS ships with a ready-to-use FastAPI app for orchestrating your agents, teams, and workflows. This gives you a major head start in building your AI product.
-
-2. **Integrated Control Plane**: The [AgentOS UI](https://os.agno.com) connects directly to your runtime, letting you test, monitor, and manage your system in real time, giving you unmatched control over your system.
-
-3. **Private by Design**: AgentOS runs entirely in your cloud, ensuring complete data privacy. No data ever leaves your system. This is ideal for security-conscious enterprises.
-
-Here's what the [AgentOS UI](https://os.agno.com) looks like in action:
+Run this and connect to the [AgentOS UI](https://os.agno.com):
 
 https://github.com/user-attachments/assets/feb23db8-15cc-4e88-be7c-01a21a03ebf6
 
-## The Complete Agentic Solution
-
-For companies building agents, Agno provides the complete agentic solution:
-
-- The fastest framework for building agents, multi-agent teams and agentic workflows.
-- A ready-to-use FastAPI app that gets you building AI products on day one.
-- A control plane for testing, monitoring and managing your system.
-
-Agno brings a novel architecture that no other framework provides, your AgentOS runs securely in your cloud, and the control plane connects directly to it from your browser. You don't need to send data to any external services or pay retention costs, you get complete privacy and control.
-
-## Designed for Agent Engineering
-
-Agno is an incredibly feature-rich framework, designed for Agent Engineering. Here are some key features:
-
-| **Category** | **Feature** | **Description** |
-|---------------|-------------|-----------------|
-| **Core Intelligence** | **Model Agnostic** | Works with any model provider so you can use your favorite LLMs. |
-|  | **Type Safe** | Enforce structured I/O through `input_schema` and `output_schema` for predictable, composable behavior. |
-|  | **Dynamic Context Engineering** | Inject variables, state, and retrieved data on the fly into context. Perfect for dependency-driven agents. |
-| **Memory, Knowledge, and Persistence** | **Persistent Storage** | Give your Agents, Teams, and Workflows a database to persist session history, state, and messages. |
-|  | **User Memory** | Built-in memory system that allows Agents to recall user-specific context across sessions. |
-|  | **Agentic RAG** | Connect to 20+ vector stores (called **Knowledge** in Agno) with hybrid search + reranking out of the box. |
-|  | **Culture (Collective Memory)** | Shared knowledge that compounds across agents and time. |
-| **Execution & Control** | **Human-in-the-Loop** | Native support for confirmations, manual overrides, and external tool execution. |
-|  | **Guardrails** | Built-in safeguards for validation, security, and prompt protection. |
-|  | **Agent Lifecycle Hooks** | Pre- and post-hooks to validate or transform inputs and outputs. |
-|  | **MCP Integration** | First-class support for the Model Context Protocol (MCP) to connect Agents with external systems. |
-|  | **Toolkits** | 100+ built-in toolkits with thousands of tools, ready for use across data, code, web, and enterprise APIs. |
-| **Runtime & Evaluation** | **Runtime** | Pre-built FastAPI based runtime with SSE compatible endpoints, ready for production on day 1. |
-|  | **Control Plane (UI)** | Integrated interface to visualize, monitor, and debug agent activity in real time. |
-|  | **Natively Multimodal** | Agents can process and generate text, images, audio, video, and files. |
-|  | **Evals** | Measure your Agents' Accuracy, Performance, and Reliability. |
-| **Security & Privacy** | **Private by Design** | Runs entirely in your cloud. The UI connects directly to your AgentOS from your browser, no data is ever sent externally. |
-|  | **Data Governance** | Your data lives securely in your Agent database, no external data sharing or vendor lock-in. |
-|  | **Access Control** | Role-based access (RBAC) and per-agent permissions to protect sensitive contexts and tools. |
+## Features
 
-Every part of Agno is built for real-world deployment — where developer experience meets production performance.
+**Core**
+- Model-agnostic: OpenAI, Anthropic, Google, local models
+- Type-safe I/O with `input_schema` and `output_schema`
+- Async-first, built for long-running tasks
+- Natively multimodal (text, images, audio, video, files)
 
-## Setup Your Coding Agent to Use Agno
+**Memory & Knowledge**
+- Persistent storage for session history and state
+- User memory across sessions
+- Agentic RAG with 20+ vector stores, hybrid search, reranking
+- Culture: shared long-term memory across agents
 
-For LLMs and AI assistants to understand and navigate Agno's documentation, we provide an [llms.txt](https://docs.agno.com/llms.txt) or [llms-full.txt](https://docs.agno.com/llms-full.txt) file. This file is built for AI systems to efficiently parse and reference our documentation.
+**Orchestration**
+- Human-in-the-loop (confirmations, approvals, overrides)
+- Guardrails for validation and security
+- Pre/post hooks for the agent lifecycle
+- First-class MCP and A2A support
+- 100+ built-in toolkits
 
-### IDE Integration
+**Production**
+- Ready-to-use FastAPI runtime
+- Integrated control plane UI
+- Evals for accuracy, performance, latency
+- Durable execution for resumable workflows
+- RBAC and per-agent permissions
 
-When building Agno agents, using Agno documentation as a source in your IDE is a great way to speed up your development. Here's how to integrate with Cursor:
+## Getting Started
 
-1. In Cursor, go to the "Cursor Settings" menu.
-2. Find the "Indexing & Docs" section.
-3. Add `https://docs.agno.com/llms-full.txt` to the list of documentation URLs.
-4. Save the changes.
-
-Now, Cursor will have access to the Agno documentation. You can do the same with other IDEs like VSCode, Windsurf etc.
+1. Follow the [getting started guide](https://github.com/agno-agi/agno/tree/main/cookbook/00_getting_started)
+2. Browse the [cookbook](https://github.com/agno-agi/agno/tree/main/cookbook) for real-world examples
+3. Read the [docs](https://docs.agno.com) to go deeper
 
 ## Performance
 
-If you're building with Agno, you're guaranteed best-in-class performance by default. Our obsession with performance is necessary because even simple AI workflows can spawn hundreds of Agents and because many tasks are long-running -- stateless, horizontal scalability is key for success.
-
-At Agno, we optimize performance across 3 dimensions:
-
-1. **Agent performance:** We optimize static operations (instantiation, memory footprint) and runtime operations (tool calls, memory updates, history management).
-2. **System performance:** The AgentOS API is async by default and has a minimal memory footprint. The system is stateless and horizontally scalable, with a focus on preventing memory leaks. It handles parallel and batch embedding generation during knowledge ingestion, metrics collection in background tasks, and other system-level optimizations.
-3. **Agent reliability and accuracy:** Monitored through evals, which we’ll explore later.
-
-### Agent Performance
-
-Let's measure the time it takes to instantiate an Agent and the memory footprint of an Agent. Here are the numbers (last measured in Oct 2025, on an Apple M4 MacBook Pro):
-
-- **Agent instantiation:** ~3μs on average
-- **Memory footprint:** ~6.6Kib on average
-
-We'll show below that Agno Agents instantiate **529× faster than Langgraph**, **57× faster than PydanticAI**, and **70× faster than CrewAI**. Agno Agents also use **24× lower memory than Langgraph**, **4× lower than PydanticAI**, and **10× lower than CrewAI**.
+Agent workloads spawn hundreds of instances. Stateless, horizontal scalability isn't optional.
 
-> [!NOTE]
-> Run time performance is bottlenecked by inference and hard to benchmark accurately, so we focus on minimizing overhead, reducing memory usage, and parallelizing tool calls.
+| Metric | Agno | LangGraph | PydanticAI | CrewAI |
+|--------|------|-----------|------------|--------|
+| Instantiation | **3μs** | 1,587μs (529×) | 170μs (57×) | 210μs (70×) |
+| Memory | **6.6 KiB** | 161 KiB (24×) | 29 KiB (4×) | 66 KiB (10×) |
 
-### Instantiation Time
-
-Let's measure instantiation time for an Agent with 1 tool. We'll run the evaluation 1000 times to get a baseline measurement. We'll compare Agno to LangGraph, CrewAI and Pydantic AI.
-
-> [!NOTE]
-> The code for this benchmark is available [here](https://github.com/agno-agi/agno/tree/main/cookbook/evals/performance). You should run the evaluation yourself on your own machine, please, do not take these results at face value.
-
-```shell
-# Setup virtual environment
-./scripts/perf_setup.sh
-source .venvs/perfenv/bin/activate
-
-# Agno
-python cookbook/evals/performance/instantiate_agent_with_tool.py
-
-# LangGraph
-python cookbook/evals/performance/comparison/langgraph_instantiation.py
-# CrewAI
-python cookbook/evals/performance/comparison/crewai_instantiation.py
-# Pydantic AI
-python cookbook/evals/performance/comparison/pydantic_ai_instantiation.py
-```
-
-LangGraph is on the right, **let's start it first and give it a head start**. Then CrewAI and Pydantic AI follow, and finally Agno. Agno obviously finishes first, but let's see by how much.
+<sub>Apple M4 MacBook Pro, Oct 2025. [Run benchmarks yourself →](https://github.com/agno-agi/agno/tree/main/cookbook/12_evals/performance)</sub>
 
 https://github.com/user-attachments/assets/54b98576-1859-4880-9f2d-15e1a426719d
 
-### Memory Usage
+## IDE Integration
 
-To measure memory usage, we use the `tracemalloc` library. We first calculate a baseline memory usage by running an empty function, then run the Agent 1000x times and calculate the difference. This gives a (reasonably) isolated measurement of the memory usage of the Agent.
+Add our docs to your AI-enabled editor:
 
-We recommend running the evaluation yourself on your own machine, and digging into the code to see how it works. If we've made a mistake, please let us know.
+**Cursor:** Settings → Indexing & Docs → Add `https://docs.agno.com/llms-full.txt`
 
-### Results
+Also works with VSCode, Windsurf, and similar tools.
 
-Taking Agno as the baseline, we can see that:
+## Contributing
 
-| Metric             | Agno | Langgraph   | PydanticAI | CrewAI     |
-| ------------------ | ---- | ----------- | ---------- | ---------- |
-| **Time (seconds)** | 1×   | 529× slower | 57× slower | 70× slower |
-| **Memory (MiB)**   | 1×   | 24× higher  | 4× higher  | 10× higher |
-
-Exact numbers from the benchmark:
-
-| Metric             | Agno     | Langgraph | PydanticAI | CrewAI   |
-| ------------------ | -------- | --------- | ---------- | -------- |
-| **Time (seconds)** | 0.000003 | 0.001587  | 0.000170   | 0.000210 |
-| **Memory (MiB)**   | 0.006642 | 0.161435  | 0.028712   | 0.065652 |
-
-> [!NOTE]
-> Agno agents are designed for performance and while we share benchmarks against other frameworks, we should be mindful that accuracy and reliability are more important than speed.
-
-## Contributions
-
-We welcome contributions, read our [contributing guide](https://github.com/agno-agi/agno/blob/v2.0/CONTRIBUTING.md) to get started.
+We welcome contributions. See the [contributing guide](https://github.com/agno-agi/agno/blob/v2.0/CONTRIBUTING.md).
 
 ## Telemetry
 
-Agno logs which model an agent used so we can prioritize updates to the most popular providers. You can disable this by setting `AGNO_TELEMETRY=false` in your environment.
+Agno logs which model providers are used to prioritize updates. Disable with `AGNO_TELEMETRY=false`.
 
-<p align="left">
-  <a href="#top">⬆️ Back to Top</a>
-</p>
+<p align="right"><a href="#top">↑ Back to top</a></p>