README.md

🌟 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

• ✈️ Travel Planner: An trip planning swarm system that create an itinerary together with a customer.
• 🛍️ E-Commerce Custom Service for Order Management: A smart, agent-driven system that makes order tracking quick and easy while simplifying returns for both logged-in and guest users.
• 📈 Financial Analysis: A AI-powered stock analysis generating market insights and recommendations.
• 🎮 AI Game Design Agent Team: A collaborative game design system that generates comprehensive game concepts through the coordination of multiple specialized AI agents.
• 🤖 Automated Machine Learning for Kaggle: An agent system to automate the machine learning pipeline for Kaggle competitions.
• ☑ 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
• 🦸 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

🤝 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

2. 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!