Agno

Changelog

New Features

• Smallest AI: Added SmallestTools, a text-to-speech toolkit for Smallest AI with text_to_speech (returns audio as a ToolResult artifact, optionally saved to disk) and get_voices. Supports the lightning_v3.1 and lightning_v3.1_pro models.
• AgentOS: Added GET /metrics/refresh/status to observe background metrics refreshes:
• Reports idle, running, completed or failed with started_at, finished_at and error, so clients can poll for completion instead of timing out silently. The state updates even when a refresh finishes without writing new data.
• Available on the client as AgentOSClient.get_metrics_refresh_status()
• OpenSearch: Added OpenSearch vector database support (agno.vectordb.opensearch) with vector, keyword and hybrid search in both sync and async variants, installable via the agno[opensearch] extra. Includes cookbook examples and a run_opensearch.sh script for local setup.

Improvements

• Tools: Cached the Pydantic version lookup during tool wrapping. The package metadata was re-read on every wrap, which made repeated tool wrapping a hot path (100-wrap benchmark: 65.9 ms to 11.0 ms).

Bug Fixes

• AgentOS: POST /metrics/refresh no longer blocks uvicorn workers on large datasets:
• The sync calculate_metrics() call now runs in the threadpool, so other requests keep flowing during a refresh. Same 200 + metrics list response as before.
• New opt-in ?background=true query param returns 202 immediately and runs the refresh as a background task. Background refreshes are single-flight per database.
• GET /metrics with a sync BaseDb also moves its lazy refresh to the threadpool.
• Encoding: Text-mode open() calls now pass explicit encoding="utf-8", so JSON cache and config files written on one platform stay readable on another (Windows defaults to cp1252).

What's Changed

• feat: add Smallest AI text-to-speech toolkit by @harshitajain165 in https://github.com/agno-agi/agno/pull/9015
• docs: fix broken links in cookbook READMEs and CONTRIBUTING.md by @devdattatalele in https://github.com/agno-agi/agno/pull/9195
• [fix] Cache Pydantic version lookup during tool wrapping by @basnijholt in https://github.com/agno-agi/agno/pull/9210
• fix: add explicit encoding="utf-8" to text-mode open() calls by @Ghraven in https://github.com/agno-agi/agno/pull/7984
• fix: run metrics refresh in background to avoid blocking workers by @Mustafa-Esoofally in https://github.com/agno-agi/agno/pull/9263
• feat: support opensearch db by @anhphong22 in https://github.com/agno-agi/agno/pull/3611
• chore: release 2.8.6 by @ysolanky in https://github.com/agno-agi/agno/pull/9271

New Contributors

• @harshitajain165 made their first contribution in https://github.com/agno-agi/agno/pull/9015
• @devdattatalele made their first contribution in https://github.com/agno-agi/agno/pull/9195
• @anhphong22 made their first contribution in https://github.com/agno-agi/agno/pull/3611

Full Changelog: https://github.com/agno-agi/agno/compare/v2.8.5...v2.8.6

<div align="center" id="top">

<a href="https://agno.com">

<picture>

<source media="(prefers-color-scheme: dark)" srcset="https://agno-public.s3.us-east-1.amazonaws.com/assets/logo-dark.svg">

<source media="(prefers-color-scheme: light)" srcset="https://agno-public.s3.us-east-1.amazonaws.com/assets/logo-light.svg">

<img src="https://agno-public.s3.us-east-1.amazonaws.com/assets/logo-light.svg" alt="Agno">

</picture>

</a>

</div>

<p align="center">

Build, run, and manage agent platforms.<br/>

</p>

Introduction

Agno is a framework and runtime for agent platforms. Build agents, run them as a service, manage your platform using a web UI.

• Build your agent platform using the Agno SDK.
• Run your agent platform using the AgentOS runtime.
• Manage everything using the AgentOS UI.

Agno allows you to own your agent stack. Maintain control of your data, memory, and security posture (JWT-based RBAC), and turn your agent platform into a learning loop with simulations and usage data.

<img width="3192" height="2038" alt="demo-os" src="https://github.com/user-attachments/assets/6d21e6bc-111f-4b81-ba29-6550fead89b2" />

Get started

Hand this prompt to your coding agent (Claude Code, Cursor, Codex):

Help me set up my agent platform.

Clone https://github.com/agno-agi/agentos-railway into a folder called
agent-platform, cd in, read the README, and follow the get started guide.

Your coding agent will set up your agent platform and run it locally using Docker, giving you a REST API for serving your agents, a Postgres database for storing your data and traces, an MCP server, and a control plane.

Deploying somewhere else? Use the same prompt but point it to a different repo. The starter templates are identical except for the deploy scripts: swap agentos-railway for agentos-docker, agentos-aws, agentos-gcp, agentos-azure, agentos-fly, agentos-render, agentos-modal, or agentos-helm.

Prefer to code by hand?

• Build your first agent in 20 lines of code.
• Build your own agent platform.
• Read the docs.

Features

• Production API. 50+ endpoints with SSE and websockets to build a product on top.
• Storage. Store sessions, memory, knowledge, and traces in your own database.
• 100+ integrations. Connect to GitHub, Slack, Postgres, and more using pre-built toolkits.
• Context Providers. Access live data from Slack, Drive, wikis, MCP, and custom sources.
• Human approval. Pause runs for user confirmation. Block tools that require admin approval.
• Observability. Monitor with OpenTelemetry tracing, run history, and audit logs.
• Security. Get JWT-based RBAC and multi-user, multi-tenant isolation out of the box.
• Interfaces. Expose your agents via Slack, Telegram, WhatsApp, Discord, AG-UI, A2A.
• Scheduling. Cron-based scheduling and background jobs with no external infrastructure.
• Deploy anywhere. Run on any cloud platform that runs containers. Docker, Railway, AWS, GCP.

Use Agno with your coding agent

Two options:

1. Recommended: Add Agno docs as an MCP server. Add docs.agno.com/mcp to your favourite coding agent.
2. Add Agno docs as an indexed source. In Cursor: Settings → Indexing & Docs → Add https://docs.agno.com/llms-full.txt. Also works in VSCode, Windsurf, and similar tools.

Read the full guide here.

Community

• X: follow for releases and demos
• Newsletter: monthly updates on what's shipping

Contributing

See the contributing guide.

License

Agno is distributed under the Apache-2.0 license.

Telemetry

Agno sends a telemetry event per agent run so we know which model providers to prioritize. Prompts, messages, and outputs are never sent. Disable by setting AGNO_TELEMETRY=false.

<p align="right"><a href="#top">↑ Back to top</a></p>