ImportError - Missing Dependencies
Map common Agno ImportError messages to the pip extra that installs the missing dependency.
uv pip install agno ships the core SDK only. Models, databases, vector stores, and interfaces load their dependencies lazily and raise an ImportError when the package is missing. Install the matching extra:
uv pip install -U 'agno[anthropic]'
# Extras combine
uv pip install -U 'agno[os,psycopg,sql,pgvector]'| Error mentions | Triggered by | Install |
|---|---|---|
openai not installed | Default model, OpenAIResponses, OpenAIChat, OpenAIEmbedder | uv pip install 'agno[openai]' |
anthropic not installed | Claude | uv pip install 'agno[anthropic]' |
google-genai not installed or not at the latest version | Gemini, GeminiEmbedder | uv pip install 'agno[google]' |
groq not installed | Groq | uv pip install 'agno[groq]' |
No module named fastapi / PyJWT is not installed | AgentOS | uv pip install 'agno[os]' |
mcp not installed | MCPTools | uv pip install 'agno[mcp]' |
fastmcp not installed | AgentOS(mcp=True) | uv pip install 'agno[mcp]' |
sqlalchemy not installed | SqliteDb | uv pip install 'agno[sqlite]' |
sqlalchemy not installed | PostgresDb | uv pip install 'agno[sql,psycopg]' |
sqlalchemy / pgvector not installed | PgVector | uv pip install 'agno[pgvector,sql,psycopg]' |
The qdrant-client package is not installed | Qdrant | uv pip install 'agno[qdrant]' |
lancedb not installed | LanceDb | uv pip install 'agno[lancedb]' |
| Slack dependencies not installed | Slack interface | uv pip install 'agno[slack]' |
pyTelegramBotAPI not installed | Telegram interface | uv pip install 'agno[telegram]' |
regex not installed | PageFileSystem | uv pip install 'agno[pages]' |
pypdf not installed | PDF readers | uv pip install 'agno[pdf]' |
Quote the extra ('agno[...]') so your shell doesn't expand the brackets.
If an error names a package with no matching extra, install the package directly with the command shown in the error message.