agno

library3.0.1pypypi✓ verified 26d ago

Open-source framework for building multi-modal AI agents with memory, knowledge, tools, and reasoning. Renamed from Phidata to Agno in January 2025. Complete namespace change from phi.* to agno.*. phidata package still exists on PyPI (2.7.10) but is legacy — new development on agno only. Current version: agno 2.5.10 (Mar 2026).

llm-agents ai-ml

pip install agno

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · AGNO

agno

llm-agentspythonv3.0.1

Install

10.0s avg

Import

1515ms

Disk

109MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v3.0.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.915 runs

installs and imports cleanly · install 0.0s · import 1.569s · 96.1MB

glibc

py 3.10–3.915 runs

installs and imports cleanly · install 10.0s · import 1.462s · 96MB

109MB installed

● package 109MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Agent

✓ from agno.agent import Agent

✗ from agno import Agent

Minimal Agno agent using OpenAI. Current agno 2.x API.

# pip install agno openai from agno.agent import Agent from agno.models.openai import OpenAIChat import os agent = Agent( model=OpenAIChat(id='gpt-4o'), description='You are a helpful assistant.', markdown=True ) agent.print_response('Explain quantum computing in 2 sentences.')

Debug

Known issues

breakingComplete namespace rename: all phi.* imports broken. from phi.agent import Agent raises ModuleNotFoundError on agno package. The entire import tree changed.

fix

Replace all 'from phi.' with 'from agno.' systematically. See full migration guide at docs.agno.com/how-to/phidata-to-agno

affects: agno >= 1.0.0

breakingAll tool classes renamed with Tools suffix. DuckDuckGo → DuckDuckGoTools, YFinanceTools stays same, but many others changed. Import paths also changed.

fix

Check docs.agno.com for updated tool names. Pattern: phi.tools.X.ClassName → agno.tools.X.ClassNameTools

affects: agno >= 1.0.0

breakingEmbedder parameter renamed from model= to id=. OllamaEmbedder(model='llama3.2') breaks silently or raises TypeError.

fix

OllamaEmbedder(id='llama3.2') not model='llama3.2'

affects: agno >= 1.0.0

breakingCLI renamed from phi to ag. All phi init, phi ws up commands broken.

fix

Replace phi commands with ag. phi init → ag init, phi ws up dev → ag ws up dev

affects: agno >= 1.0.0

gotchaAgent() with no model specified silently defaults to OpenAIChat(gpt-4o). This will fail at runtime with a ModuleNotFoundError if `openai` is not installed, or with an authentication error (e.g., 'OPENAI_API_KEY not set') if `openai` is installed but the `OPENAI_API_KEY` environment variable is missing.

fix

Always explicitly pass `model=` argument to `Agent()`. If relying on the default `OpenAIChat(gpt-4o)`, ensure `pip install openai` is run and the `OPENAI_API_KEY` environment variable is set.

affects: agno all

gotchaphidata package still installable on PyPI (2.7.10) but receives no new features. LLMs trained before Feb 2025 will generate phidata/phi.* code. Entirely wrong for current agno.

fix

pip install agno not phidata. Migrate all phi.* imports to agno.*

affects: phidata all

gotchaDocument readers renamed with _reader suffix. phi.document.reader.pdf → agno.document.reader.pdf_reader.

fix

from agno.document.reader.pdf_reader import PDFReader

affects: agno >= 1.0.0

Upgrade

Version history

3.0.1latest on PyPI · released Aug 26, 2026

Audit

Dependencies

openaioptionalDefault model provider. Agent() with no model specified defaults to OpenAIChat(gpt-4o) and fails silently if openai not installed.

agno-dockeroptionalDocker infrastructure moved to separate package agno-docker.

agno-awsoptionalAWS infrastructure moved to separate package agno-aws.

Agent activity

86 hits · last 30 days

node

Perplexity

OpenAI (training)

Resources

githubhttps://github.com/agno-agi/agno ↗

packagehttps://pypi.org/project/agno/ ↗

homepagehttps://agno.com ↗

docshttps://docs.agno.com ↗