any-agent

A single interface to use and evaluate different agent frameworks.

[!IMPORTANT] any-agent is in soft deprecation. It started as a research project to compare agent frameworks and refine a minimal common surface. That distillation has graduated to its own package: mozilla-ai-tinyagent (PyPI: mozilla-ai-tinyagent). For new projects we recommend using tinyagent directly.

any-agent continues to be published and we'll take security/bug-fix PRs, but no new features are planned. Reach for any-agent when you specifically need to run or evaluate agents across multiple frameworks (Agno, Google ADK, LangChain, LlamaIndex, OpenAI Agents SDK, smolagents) under one API. If you only need the core agent loop, mozilla-ai-tinyagent is the leaner path.

Documentation

• Agents
• Tools
• Tracing
• Serving
• Evaluation

Supported Frameworks

Planned for Support (Contributions Welcome!)

Open Github tickets for new frameworks

Requirements

• Python 3.11 or newer

Quickstart

Refer to pyproject.toml for a list of the options available. Update your pip install command to include the frameworks that you plan on using:

pip install 'any-agent'

To define any agent system you will always use the same imports:

from any_agent import AgentConfig, AnyAgent

For this example we use a model hosted by Mistral, but you may need to set the relevant API key for whichever provider being used. See our Model Configuration docs for more information about configuring models.

export MISTRAL_API_KEY="YOUR_KEY_HERE"  # or OPENAI_API_KEY, etc

from any_agent.tools import search_web, visit_webpage

agent = AnyAgent.create(
    "tinyagent",  # See all options in https://docs.mozilla.ai/any-agent/
    AgentConfig(
        model_id="mistral:mistral-small-latest",
        instructions="Use the tools to find an answer",
        tools=[search_web, visit_webpage]
    )
)

agent_trace = agent.run("Which Agent Framework is the best??")
print(agent_trace)

[!TIP] Multi-agent can be implemented using Agents-As-Tools.

Cookbooks

Get started quickly with these practical examples: