agno 2.3.26__py3-none-any.whl → 2.4.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (128) hide show
  1. agno/agent/__init__.py +4 -0
  2. agno/agent/agent.py +1368 -541
  3. agno/agent/remote.py +13 -0
  4. agno/db/base.py +339 -0
  5. agno/db/postgres/async_postgres.py +116 -12
  6. agno/db/postgres/postgres.py +1229 -25
  7. agno/db/postgres/schemas.py +48 -1
  8. agno/db/sqlite/async_sqlite.py +119 -4
  9. agno/db/sqlite/schemas.py +51 -0
  10. agno/db/sqlite/sqlite.py +1173 -13
  11. agno/db/utils.py +37 -1
  12. agno/knowledge/__init__.py +4 -0
  13. agno/knowledge/chunking/code.py +1 -1
  14. agno/knowledge/chunking/semantic.py +1 -1
  15. agno/knowledge/chunking/strategy.py +4 -0
  16. agno/knowledge/filesystem.py +412 -0
  17. agno/knowledge/knowledge.py +2767 -2254
  18. agno/knowledge/protocol.py +134 -0
  19. agno/knowledge/reader/arxiv_reader.py +2 -2
  20. agno/knowledge/reader/base.py +9 -7
  21. agno/knowledge/reader/csv_reader.py +5 -5
  22. agno/knowledge/reader/docx_reader.py +2 -2
  23. agno/knowledge/reader/field_labeled_csv_reader.py +2 -2
  24. agno/knowledge/reader/firecrawl_reader.py +2 -2
  25. agno/knowledge/reader/json_reader.py +2 -2
  26. agno/knowledge/reader/markdown_reader.py +2 -2
  27. agno/knowledge/reader/pdf_reader.py +5 -4
  28. agno/knowledge/reader/pptx_reader.py +2 -2
  29. agno/knowledge/reader/reader_factory.py +110 -0
  30. agno/knowledge/reader/s3_reader.py +2 -2
  31. agno/knowledge/reader/tavily_reader.py +2 -2
  32. agno/knowledge/reader/text_reader.py +2 -2
  33. agno/knowledge/reader/web_search_reader.py +2 -2
  34. agno/knowledge/reader/website_reader.py +5 -3
  35. agno/knowledge/reader/wikipedia_reader.py +2 -2
  36. agno/knowledge/reader/youtube_reader.py +2 -2
  37. agno/knowledge/utils.py +37 -29
  38. agno/learn/__init__.py +6 -0
  39. agno/learn/machine.py +35 -0
  40. agno/learn/schemas.py +82 -11
  41. agno/learn/stores/__init__.py +3 -0
  42. agno/learn/stores/decision_log.py +1156 -0
  43. agno/learn/stores/learned_knowledge.py +6 -6
  44. agno/models/anthropic/claude.py +24 -0
  45. agno/models/aws/bedrock.py +20 -0
  46. agno/models/base.py +48 -4
  47. agno/models/cohere/chat.py +25 -0
  48. agno/models/google/gemini.py +50 -5
  49. agno/models/litellm/chat.py +38 -0
  50. agno/models/openai/chat.py +7 -0
  51. agno/models/openrouter/openrouter.py +46 -0
  52. agno/models/response.py +16 -0
  53. agno/os/app.py +83 -44
  54. agno/os/middleware/__init__.py +2 -0
  55. agno/os/middleware/trailing_slash.py +27 -0
  56. agno/os/router.py +1 -0
  57. agno/os/routers/agents/router.py +29 -16
  58. agno/os/routers/agents/schema.py +6 -4
  59. agno/os/routers/components/__init__.py +3 -0
  60. agno/os/routers/components/components.py +466 -0
  61. agno/os/routers/evals/schemas.py +4 -3
  62. agno/os/routers/health.py +3 -3
  63. agno/os/routers/knowledge/knowledge.py +3 -3
  64. agno/os/routers/memory/schemas.py +4 -2
  65. agno/os/routers/metrics/metrics.py +9 -11
  66. agno/os/routers/metrics/schemas.py +10 -6
  67. agno/os/routers/registry/__init__.py +3 -0
  68. agno/os/routers/registry/registry.py +337 -0
  69. agno/os/routers/teams/router.py +20 -8
  70. agno/os/routers/teams/schema.py +6 -4
  71. agno/os/routers/traces/traces.py +5 -5
  72. agno/os/routers/workflows/router.py +38 -11
  73. agno/os/routers/workflows/schema.py +1 -1
  74. agno/os/schema.py +92 -26
  75. agno/os/utils.py +84 -19
  76. agno/reasoning/anthropic.py +2 -2
  77. agno/reasoning/azure_ai_foundry.py +2 -2
  78. agno/reasoning/deepseek.py +2 -2
  79. agno/reasoning/default.py +6 -7
  80. agno/reasoning/gemini.py +2 -2
  81. agno/reasoning/helpers.py +6 -7
  82. agno/reasoning/manager.py +4 -10
  83. agno/reasoning/ollama.py +2 -2
  84. agno/reasoning/openai.py +2 -2
  85. agno/reasoning/vertexai.py +2 -2
  86. agno/registry/__init__.py +3 -0
  87. agno/registry/registry.py +68 -0
  88. agno/run/agent.py +57 -0
  89. agno/run/base.py +7 -0
  90. agno/run/team.py +57 -0
  91. agno/skills/agent_skills.py +10 -3
  92. agno/team/__init__.py +3 -1
  93. agno/team/team.py +1145 -326
  94. agno/tools/duckduckgo.py +25 -71
  95. agno/tools/exa.py +0 -21
  96. agno/tools/function.py +35 -83
  97. agno/tools/knowledge.py +9 -4
  98. agno/tools/mem0.py +11 -10
  99. agno/tools/memory.py +47 -46
  100. agno/tools/parallel.py +0 -7
  101. agno/tools/reasoning.py +30 -23
  102. agno/tools/tavily.py +4 -1
  103. agno/tools/websearch.py +93 -0
  104. agno/tools/website.py +1 -1
  105. agno/tools/wikipedia.py +1 -1
  106. agno/tools/workflow.py +48 -47
  107. agno/utils/agent.py +42 -5
  108. agno/utils/events.py +160 -2
  109. agno/utils/print_response/agent.py +0 -31
  110. agno/utils/print_response/team.py +0 -2
  111. agno/utils/print_response/workflow.py +0 -2
  112. agno/utils/team.py +61 -11
  113. agno/vectordb/lancedb/lance_db.py +4 -1
  114. agno/vectordb/mongodb/mongodb.py +1 -1
  115. agno/vectordb/qdrant/qdrant.py +4 -4
  116. agno/workflow/__init__.py +3 -1
  117. agno/workflow/condition.py +0 -21
  118. agno/workflow/loop.py +0 -21
  119. agno/workflow/parallel.py +0 -21
  120. agno/workflow/router.py +0 -21
  121. agno/workflow/step.py +117 -24
  122. agno/workflow/steps.py +0 -21
  123. agno/workflow/workflow.py +427 -63
  124. {agno-2.3.26.dist-info → agno-2.4.0.dist-info}/METADATA +46 -76
  125. {agno-2.3.26.dist-info → agno-2.4.0.dist-info}/RECORD +128 -117
  126. {agno-2.3.26.dist-info → agno-2.4.0.dist-info}/WHEEL +0 -0
  127. {agno-2.3.26.dist-info → agno-2.4.0.dist-info}/licenses/LICENSE +0 -0
  128. {agno-2.3.26.dist-info → agno-2.4.0.dist-info}/top_level.txt +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: agno
3
- Version: 2.3.26
3
+ Version: 2.4.0
4
4
  Summary: Agno: a lightweight library for building Multi-Agent Systems
5
5
  Author-email: Ashpreet Bedi <ashpreet@agno.com>
6
6
  Project-URL: homepage, https://agno.com
@@ -402,11 +402,13 @@ Requires-Dist: sqlalchemy; extra == "integration-tests"
402
402
  Requires-Dist: Pillow; extra == "integration-tests"
403
403
  Requires-Dist: fastmcp; extra == "integration-tests"
404
404
  Provides-Extra: demo
405
+ Requires-Dist: agno[dev]; extra == "demo"
405
406
  Requires-Dist: anthropic; extra == "demo"
406
407
  Requires-Dist: chromadb; extra == "demo"
407
408
  Requires-Dist: ddgs; extra == "demo"
408
409
  Requires-Dist: fastapi[standard]; extra == "demo"
409
410
  Requires-Dist: google-genai; extra == "demo"
411
+ Requires-Dist: matplotlib; extra == "demo"
410
412
  Requires-Dist: mcp; extra == "demo"
411
413
  Requires-Dist: nest_asyncio; extra == "demo"
412
414
  Requires-Dist: openai; extra == "demo"
@@ -434,150 +436,120 @@ Dynamic: license-file
434
436
  </a>
435
437
  </div>
436
438
 
439
+ <p align="center">
440
+ Build, run, manage multi-agent systems.
441
+ </p>
442
+
437
443
  <div align="center">
438
- <a href="https://docs.agno.com">Documentation</a>
439
- <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
444
+ <a href="https://docs.agno.com">Docs</a>
445
+ <span>&nbsp;•&nbsp;</span>
440
446
  <a href="https://github.com/agno-agi/agno/tree/main/cookbook">Cookbook</a>
441
- <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
442
- <a href="https://www.agno.com/?utm_source=github&utm_medium=readme&utm_campaign=agno-github">Website</a>
443
- <br />
447
+ <span>&nbsp;•&nbsp;</span>
448
+ <a href="https://community.agno.com/">Community</a>
449
+ <span>&nbsp;•&nbsp;</span>
450
+ <a href="https://discord.gg/4MtYHHrgA8">Discord</a>
444
451
  </div>
445
452
 
446
453
  ## What is Agno?
447
454
 
448
- Agno is a multi-agent framework, runtime, and control plane. Use it to build private and secure AI products that run in your cloud.
455
+ Agno is a framework, runtime, and control plane for multi-agent systems.
449
456
 
450
- - **Build** agents, teams, and workflows with memory, knowledge, guardrails and 100+ integrations.
451
- - **Run** in production with a stateless FastAPI runtime. Horizontally scalable.
452
- - **Manage** with a control plane that connects directly to your runtime no data leaves your environment.
457
+ | Layer | What it does |
458
+ |-------|--------------|
459
+ | **Framework** | Build agents, teams, and workflows with memory, knowledge, guardrails, and 100+ integrations |
460
+ | **AgentOS Runtime** | Run your system in production with a stateless, secure FastAPI backend |
461
+ | **Control Plane** | Test, monitor, and manage your system using the [AgentOS UI](https://os.agno.com) |
453
462
 
454
463
  ## Why Agno?
455
464
 
456
- - **Your cloud, your data:** Runs entirely in your infrastructure. Nothing leaves your environment.
457
- - **Ready for production on day one:** Pre-built FastAPI runtime with SSE endpoints, ready to deploy.
458
- - **Incredibly fast:** 529× faster than LangGraph, 24× lower memory.
459
-
460
- ## Getting Started
461
-
462
- Start with the [getting started guide](https://github.com/agno-agi/agno/tree/main/cookbook/00_getting_started), then:
463
-
464
- - Browse the [cookbooks](https://github.com/agno-agi/agno/tree/main/cookbook) for real-world examples
465
- - Read the [docs](https://docs.agno.com) to learn more
466
-
467
- ## Resources
468
-
469
- - Docs: <a href="https://docs.agno.com" target="_blank" rel="noopener noreferrer">docs.agno.com</a>
470
- - Cookbook: <a href="https://github.com/agno-agi/agno/tree/main/cookbook" target="_blank" rel="noopener noreferrer">Cookbook</a>
471
- - Community forum: <a href="https://community.agno.com/" target="_blank" rel="noopener noreferrer">community.agno.com</a>
472
- - Discord: <a href="https://discord.gg/4MtYHHrgA8" target="_blank" rel="noopener noreferrer">discord</a>
465
+ - **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.
466
+ - **Production-ready on day one.** Pre-built FastAPI runtime with SSE endpoints, ready to deploy.
467
+ - **Fast.** 529× faster instantiation than LangGraph. 24× lower memory. [See benchmarks →](#performance)
473
468
 
474
469
  ## Example
475
470
 
476
- 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).
477
-
478
- ```python agno_agent.py
471
+ An agent with MCP tools, persistent state, served via FastAPI:
472
+ ```python
479
473
  from agno.agent import Agent
480
474
  from agno.db.sqlite import SqliteDb
481
475
  from agno.models.anthropic import Claude
482
476
  from agno.os import AgentOS
483
477
  from agno.tools.mcp import MCPTools
484
478
 
485
- # ************* Create Agent *************
486
479
  agno_agent = Agent(
487
480
  name="Agno Agent",
488
481
  model=Claude(id="claude-sonnet-4-5"),
489
- # Add a database to the Agent
490
482
  db=SqliteDb(db_file="agno.db"),
491
- # Add the Agno MCP server to the Agent
492
483
  tools=[MCPTools(transport="streamable-http", url="https://docs.agno.com/mcp")],
493
- # Add the previous session history to the context
494
484
  add_history_to_context=True,
495
485
  markdown=True,
496
486
  )
497
487
 
498
-
499
- # ************* Create AgentOS *************
500
488
  agent_os = AgentOS(agents=[agno_agent])
501
- # Get the FastAPI app for the AgentOS
502
489
  app = agent_os.get_app()
503
490
 
504
- # ************* Run AgentOS *************
505
491
  if __name__ == "__main__":
506
492
  agent_os.serve(app="agno_agent:app", reload=True)
507
493
  ```
508
494
 
509
- ## AgentOS - Production Runtime for Multi-Agent Systems
510
-
511
- Building Agents is easy, running them as a secure, scalable service is hard. AgentOS solves this by providing a high performance runtime for serving multi-agent systems in production. Key features include:
512
-
513
- 1. **Pre-built FastAPI app**: AgentOS includes a ready-to-use FastAPI app for running your agents, teams and workflows. This gives you a significant head start when building an AI product.
514
-
515
- 2. **Integrated Control Plane**: The [AgentOS UI](https://os.agno.com) connects directly to your runtime, so you can test, monitor and manage your system in real time with full operational visibility.
516
-
517
- 3. **Private by Design**: AgentOS runs entirely in your cloud, ensuring complete data privacy. No data leaves your environment, making it ideal for security conscious enterprises..
518
-
519
- When you run the example script shared above, you get a FastAPI app that you can connect to the [AgentOS UI](https://os.agno.com). Here's what it looks like in action:
495
+ Run this and connect to the [AgentOS UI](https://os.agno.com):
520
496
 
521
497
  https://github.com/user-attachments/assets/feb23db8-15cc-4e88-be7c-01a21a03ebf6
522
498
 
523
- ## Private by Design
524
-
525
- This is the part we care most about.
526
-
527
- AgentOS runs in **your** cloud. The control plane UI connects directly to your runtime from your browser. Your data never touches our servers. No retention costs, no vendor lock-in, no compliance headaches.
528
-
529
- This isn't a privacy mode or enterprise add-on. It's how Agno works.
530
-
531
499
  ## Features
532
500
 
533
- ### Core:
534
- - Model agnostic — works with OpenAI, Anthropic, Google, local models, whatever
501
+ **Core**
502
+ - Model-agnostic: OpenAI, Anthropic, Google, local models
535
503
  - Type-safe I/O with `input_schema` and `output_schema`
536
504
  - Async-first, built for long-running tasks
537
505
  - Natively multimodal (text, images, audio, video, files)
538
506
 
539
- ### Memory & Knowledge:
507
+ **Memory & Knowledge**
540
508
  - Persistent storage for session history and state
541
- - User memory that persists across sessions
509
+ - User memory across sessions
542
510
  - Agentic RAG with 20+ vector stores, hybrid search, reranking
543
- - Culture shared long-term memory across agents
511
+ - Culture: shared long-term memory across agents
544
512
 
545
- ### Execution:
513
+ **Orchestration**
546
514
  - Human-in-the-loop (confirmations, approvals, overrides)
547
515
  - Guardrails for validation and security
548
516
  - Pre/post hooks for the agent lifecycle
549
517
  - First-class MCP and A2A support
550
518
  - 100+ built-in toolkits
551
519
 
552
- ### Production:
520
+ **Production**
553
521
  - Ready-to-use FastAPI runtime
554
522
  - Integrated control plane UI
555
523
  - Evals for accuracy, performance, latency
556
524
  - Durable execution for resumable workflows
557
525
  - RBAC and per-agent permissions
558
526
 
559
- ## Performance
527
+ ## Getting Started
560
528
 
561
- We're obsessive about performance because agent workloads spawn hundreds of instances and run long tasks. Stateless, horizontal scalability isn't optional.
529
+ 1. Follow the [getting started guide](https://github.com/agno-agi/agno/tree/main/cookbook/00_getting_started)
530
+ 2. Browse the [cookbook](https://github.com/agno-agi/agno/tree/main/cookbook) for real-world examples
531
+ 3. Read the [docs](https://docs.agno.com) to go deeper
562
532
 
563
- **Benchmarks** (Apple M4 MacBook Pro, Oct 2025):
533
+ ## Performance
534
+
535
+ Agent workloads spawn hundreds of instances. Stateless, horizontal scalability isn't optional.
564
536
 
565
537
  | Metric | Agno | LangGraph | PydanticAI | CrewAI |
566
538
  |--------|------|-----------|------------|--------|
567
- | Instantiation | **3μs** | 1,587μs (529× slower) | 170μs (57× slower) | 210μs (70× slower) |
568
- | Memory | **6.6 KiB** | 161 KiB (24× higher) | 29 KiB (4× higher) | 66 KiB (10× higher) |
539
+ | Instantiation | **3μs** | 1,587μs (529×) | 170μs (57×) | 210μs (70×) |
540
+ | Memory | **6.6 KiB** | 161 KiB (24×) | 29 KiB (4×) | 66 KiB (10×) |
569
541
 
570
- Run the benchmarks yourself: [`cookbook/12_evals/performance`](https://github.com/agno-agi/agno/tree/main/cookbook/12_evals/performance)
542
+ <sub>Apple M4 MacBook Pro, Oct 2025. [Run benchmarks yourself ](https://github.com/agno-agi/agno/tree/main/cookbook/12_evals/performance)</sub>
571
543
 
572
544
  https://github.com/user-attachments/assets/54b98576-1859-4880-9f2d-15e1a426719d
573
545
 
574
546
  ## IDE Integration
575
547
 
576
- For AI-assisted development, add our docs to your IDE:
548
+ Add our docs to your AI-enabled editor:
577
549
 
578
550
  **Cursor:** Settings → Indexing & Docs → Add `https://docs.agno.com/llms-full.txt`
579
551
 
580
- Works with VSCode, Windsurf, and other AI-enabled editors too.
552
+ Also works with VSCode, Windsurf, and similar tools.
581
553
 
582
554
  ## Contributing
583
555
 
@@ -585,8 +557,6 @@ We welcome contributions. See the [contributing guide](https://github.com/agno-a
585
557
 
586
558
  ## Telemetry
587
559
 
588
- Agno logs which model providers are used so we can prioritize updates. Disable with `AGNO_TELEMETRY=false`.
560
+ Agno logs which model providers are used to prioritize updates. Disable with `AGNO_TELEMETRY=false`.
589
561
 
590
- <p align="left">
591
- <a href="#top">⬆️ Back to Top</a>
592
- </p>
562
+ <p align="right"><a href="#top">↑ Back to top</a></p>