Skip to content

martimfasantos/ai-agents-frameworks

Repository files navigation


Logo

πŸ€– AI Agent Frameworks

A hands-on comparison of modern AI agent and multi-agent frameworks. Get started with practical examples and explore the unique features of each framework.
Report Bug Β· Request Feature

This repository provides a comprehensive, hands-on comparison of modern AI agent and multi-agent frameworks. Each framework is explored through practical examples, showcasing both core functionality and its unique features, capabilities, and use cases.

πŸ€– Frameworks Included

Framework Version Docs Repository
AG2 0.11.4 Docs GitHub
Agno 2.5.10 Docs GitHub
Autogen Autogen 0.7.5 Docs GitHub
Claude Agent SDK Claude Agent SDK 0.1.52 Docs GitHub
CrewAI 1.12.2 Docs GitHub
Google ADK Google ADK 1.26.0 Docs GitHub
LangChain 1.2.13 Docs GitHub
LangGraph LangGraph 0.2.68 Docs GitHub
LlamaIndex LlamaIndex 0.14.14 Docs GitHub
Microsoft Agent Framework Agent Framework 1.0.0rc5 Docs GitHub
OpenAI Agents SDK OpenAI Agents SDK 0.12.5 Docs GitHub
Pydantic-AI 1.38.0 Docs GitHub
smolagents smolagents 1.24.0 Docs GitHub
Strands Agents SDK 1.32.0 Docs GitHub

πŸ“ Structure

The repository is organized by framework, with each top-level folder containing examples, configuration, and a README.md for that framework. The examples range from simple agent tasks to more advanced scenarios, including multi-agent workflows, RAG (Retrieval-Augmented Generation), API integrations, support for state-of-the-art protocols such as A2A and MCP, and much more.

Main modules:

  • ag2/
  • agno/
  • autogen/
  • claude-agents-sdk/
  • crewai/
  • google-adk/
  • langchain/
  • langgraph/
  • llama-index/
  • microsoft-agent-framework/
  • openai-agents-sdk/
  • pydantic-ai/
  • smolagents/
  • strands-agents-sdk/
  • study-agents-differences/

All modules use uv for dependency management (pyproject.toml + uv.lock). Always check the README.md in each module for specific setup and usage instructions.

πŸš€ Getting Started

  1. Choose a framework: Navigate to the relevant folder for the agent framework you want to explore.
  2. Install dependencies: Run uv sync inside the framework folder to install all dependencies.
  3. Configure API keys: Copy .env.example to .env and fill in your API keys.
  4. Run examples: Execute files with uv run <filename>.py.

πŸ§ͺ Comparison and Experiments

The study-agents-differences/ folder contains comprehensive scripts and utilities for comparing frameworks on common tasks, including RAG, API integration, and multi-agent workflows. It provides:

  • Unified agent interfaces for Agno, LangGraph, LlamaIndex, OpenAI, and Pydantic-AI
  • Performance benchmarks measuring response time, token usage, and tool utilization
  • Detailed results and analysis comparing different agent designs and tool integrations
  • Interactive Streamlit UI for real-time comparison (streamlit run agent-ui.py)

🀝 Contributing

All contributions are welcome! If you have suggestions for new examples, frameworks to add, or improvements to existing content, please open an issue or submit a pull request.


Notes

  • All modules use uv for dependency management (pyproject.toml + uv.lock). Check each module's README.md for installation and usage.
  • Install dependencies before running examples.
  • Example .env.example files are provided where needed for API keys and settings.

About

Foundational code repo for learning, exploring, testing, and comparing various state-of-the-art open-source AI Agents Frameworks

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages