Agno (formerly Phidata)

2.5.10 · active · verified Tue Mar 24

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).

Warnings

breaking Complete 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
breaking All 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
breaking Embedder parameter renamed from model= to id=. OllamaEmbedder(model='llama3.2') breaks silently or raises TypeError.
Fix: OllamaEmbedder(id='llama3.2') not model='llama3.2'
breaking CLI 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
gotcha Agent() with no model specified silently defaults to OpenAIChat(gpt-4o). Fails at runtime with ModuleNotFoundError if openai not installed, not at import time.
Fix: Always explicitly pass model= argument. pip install openai if using default.
gotcha phidata 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.*
gotcha Document readers renamed with _reader suffix. phi.document.reader.pdf → agno.document.reader.pdf_reader.
Fix: from agno.document.reader.pdf_reader import PDFReader

Install

pip install agno Python (current)
pip install agno openai Python (with OpenAI — required, agno defaults to OpenAIChat)
pip install phidata Python (legacy — do not use for new projects)

Imports

Agent

from agno.agent import Agent
from agno.models.openai import OpenAIChat
from agno.tools.duckduckgo import DuckDuckGoTools

agent = Agent(
    model=OpenAIChat(id='gpt-4o'),
    tools=[DuckDuckGoTools()],
    markdown=True
)
agent.print_response('Latest AI news', stream=True)

All phi.* imports renamed to agno.*. phi.tools.duckduckgo.DuckDuckGo renamed to agno.tools.duckduckgo.DuckDuckGoTools — all tools now have Tools suffix.

Model classes

from agno.models.openai import OpenAIChat
from agno.models.anthropic import Claude
from agno.models.google import Gemini

Model namespace changed from phi.model.* (singular) to agno.models.* (plural). All model classes moved.

Knowledge / Embedder

from agno.knowledge.pdf import PDFKnowledgeBase
from agno.embedder.openai import OpenAIEmbedder

# Embedders now use id= not model=
embedder = OpenAIEmbedder(id='text-embedding-3-small')

Knowledge namespace changed from phi.knowledge to agno.knowledge. Embedder parameter renamed from model= to id=.

Quickstart

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.')

view raw JSON →