build-with-ag2

🌟 Build with AG2

Are you building with AG2? Add your project to the list by submitting code through pull requests or add a link to your own repository!

A curated collection of awesome agentic applications built with AG2.

• 💡 Practical implementations demonstrating AI agents in action - from custom support to smart email management systems

• 🔥 Cutting-edge AI agent applications that seamlessly integrate models from OpenAI, Anthropic, Gemini, and open-source providers, and a diverse range of tools

• 🎓 Production-ready, extensively documented agentic projects that help you contribute to the thriving AI agent ecosystem

📂 Featured Agentic Apps

• 🛍️ E-Commerce Custom Service for Order Management (last updated and ran on 09/20/2025, ag2 version 0.9.9): A smart, agent-driven system that makes order tracking quick and easy while simplifying returns for both logged-in and guest users.
• 📈 Financial Analysis (last updated and ran on 09/20/2025, ag2 version 0.9.9): A AI-powered stock analysis generating market insights and recommendations.
• 🤖 Automated Machine Learning for Kaggle (last updated and ran on 09/20/2025, ag2 version 0.9.9): An agent system to automate the machine learning pipeline for Kaggle competitions.
• 🧑‍🔬 Deep Research Agent: Reference implementation of the deep research agent.
• ✈️ Travel Planner: An trip planning swarm system that create an itinerary together with a customer.

• 🎮 AI Game Design Agent Team: A collaborative game design system that generates comprehensive game concepts through the coordination of multiple specialized AI agents.

• ☑ Manage Todos With Realtime Agent: A voice-controlled todo assistant with real-time interaction.

🚀 Getting Started

1. Clone the repository

   git clone https://github.com/ag2ai/build-with-ag2.git
   

2. Navigate to the desired project directory

   cd build-with-ag2/travel-planner
   

3. Install the required dependencies

   # Requires Python >= 3.9, < 3.14
   pip install -r requirements.txt
   

4. Follow the project-specific instructions in each project’s README.md file to set up and run the app.

🔗 Links to More Projects Built with AG2

• 📓 AG2 Notebooks: AG2 notebooks
• 🖥️ Waldiez: UI for designing AG2-based workflows using drag-and-drop
• 🦸 HeroYouth: Empowering youth against school bullying
• 🔬 SciAgents: Automating scientific discovery through multi-agent intelligent graph reasoning
• 🌐 Agent-E: A browser automation agent for natural language-driven web interactions and task automation.
• 📱 Aquinas: AI-Powered social media engagement tool
• 🛡️ disarmBot: A multi-agent LM system for analyzing disinformation based on DISARM
• 🛠️ Hercules: An open-source testing agent that turns simple Gherkin steps into fully automated end-to-end tests
• 📊 CMBAgent: Multi-agent system for data analysis and visualization
• 🔏 AutoDefense: Multi-agent LLM Defense against jailbreak attacks
• 🔍 Prompt Leakage Probing: Framework for testing LLM agents for system prompt leaks

🤝 Contributing to AG2 Open Source

Created something with AG2? Contributions are welcome! If you have any ideas, improvements, or new apps to add, please create a new GitHub Issue or submit a pull request. Make sure to follow the existing project structure and include a detailed README.md for each new app.

Option 1: Link to your own repositories built with AG2

Refer to the external repository guide to link to your own repositories showcasing projects built with AG2.

Option 2: Creating a new project

• You can take the project template as a starting point
• Use kebab-case for a new project, e.g. space-time-travel-agent
• Add a requirements.txt file with the required libraries
• Write a concise README.md file, use this as a template
• Add a OAI_CONFIG_LIST_sample file
• Create your project and contribute. Happy coding!

Code Style and Linting

This project uses pre-commit hooks to maintain code quality. Before contributing:

1. Install pre-commit:

pip install pre-commit
pre-commit install

1. The hooks will run automatically on commit, or you can run them manually:

pre-commit run --all-files

🌟 Stay Updated

Star this repository and AG2 to receive notifications about the newest and coolest agentic applications!

This site is open source. Improve this page.