Contributing

We believe agent-based systems represent a fundamental shift in how software is built, similar to how Linux transformed operating systems and Kubernetes revolutionized cloud infrastructure. Join us in shaping the future of AI governance and automation. Every contribution, no matter how small, helps build a more robust and ethical AI ecosystem.

Why Contribute to AG2?

• Impact the Future: 2025 is the year of AI agents. And we believe 2025-2035 will be the decade of AI agents. You can help shape how AI Agents are created, used, deployed, and governed in production environments. And how multiple AI agents collaborate, communicate, and solve complex problems together. Your work will influence how organizations deploy and orchestrate AI agent systems at scale.

• Learn & Grow: Work directly with cutting-edge AI agent technologies and receive mentorship from experienced researchers and developers in the field. Understand how to:

  • Design sophisticated multi-agent systems
  • Create novel agent interaction patterns
  • Build scalable agent architectures
  • Develop robust testing and evaluation frameworks
  • Build real-world use cases and applications with AI agents
  • Participate in research projects to advance the field of AI agents

• Build Your Portfolio: Gain hands-on experience in a leading open-source AI agent framework project. Your contributions will demonstrate real expertise in one of the most exciting areas of AI development, while earning acknowledgment from the AG2 community.

• Join a Community: Become part of a vibrant ecosystem of developers, researchers, and AI enthusiasts who are passionate about advancing AI agent technology. Share ideas, solve challenges, and grow together with peers who share your interests.

• Career Growth: AG2 is at the forefront of AI agent development. Your open-source contributions here are highly valued by employers in the AI industry, particularly those working on next-generation AI systems and agent-based architectures.

Resources About AG2

• AG2 homepage
• AG2 on Github
• AG2 community on Discord
• AG2 docs
• AG2 on Youtube
• AG2 on X
• AG2 on LinkedIn

Step 0: Getting Started

1. Take our contributor survey if you haven't done so
2. Join our Discord community and become a verified GitHub developer
3. Read through this contribution guide

If you are new to GitHub, here is a detailed help source on getting involved with development on GitHub.

Step 1: Explore Contribution Opportunities

Find Your Path

We believe everyone has something valuable to contribute. Here's how you can get started:

For New Contributors:

• Begin with our curated good first issues
• Perfect for those new to open source or AG2 - Experienced maintainers and contributors are ready to guide you through your first PR

For Experienced Contributors:

• Dive into our roadmap issues to tackle complex challenges
• Shape core features and architectural decisions
• Mentor newcomers and help build our community
• Propose innovative improvements to AG2

Ways to Contribute

Your skills can make a difference in many ways:

• Submit Pull Requests (PRs) to improve our codebase
• Review existing PRs and help maintain code quality
• Share your knowledge in our AG2 community Discord channels
• Enrich our documentation to help others learn
• Add cool examples and use cases
• Get inspired by existing notebook examples and video demos
• Report bugs and suggest feature improvements:
  • Bug report
  • Feature request

Step 2: Join Contributor Scrum Meetings

Be part of our vibrant community through regular collaboration:

• Daily meetings with core contributors
• Tuesday/Friday scrum meetings with community contributors
• Regular technical discussions and knowledge sharing sessions
• Opportunities to present your work and get feedback

Note: To ensure productive meetings and meaningful progress, we ask that you commit to contributing at least 2 hours per week before joining the scrum meetings.

Recognition Program

We value our contributors and celebrate their achievements through:

• Regular contributor spotlights on our blog
• Acknowledgment in release notes
• Opportunities to become core maintainers
• Special access to AG2 community events and workshops

Becoming a Reviewer

There is currently no formal reviewer solicitation process. Current reviewers identify reviewers from active contributors. If you are willing to become a reviewer, you are welcome to let us know on Discord.

Contact Maintainers

The project is currently maintained by a dynamic group of volunteers from several organizations. Contact project administrators Chi Wang and Qingyun Wu via support@ag2.ai if you are interested in becoming a maintainer.

License Headers

To maintain proper licensing and copyright notices, please include the following header at the top of each new source code file you create, regardless of the programming language:

# Copyright (c) 2023 - 2025, AG2ai, Inc., AG2ai open-source projects maintainers and core contributors
#
# SPDX-License-Identifier: Apache-2.0

For files that contain or are derived from the original MIT-licensed code from https://github.com/microsoft/autogen, please use this extended header:

# Copyright (c) 2023 - 2025, AG2ai, Inc., AG2ai open-source projects maintainers and core contributors
#
# SPDX-License-Identifier: Apache-2.0
#
# Portions derived from https://github.com/microsoft/autogen are under the MIT License.
# SPDX-License-Identifier: MIT

Please ensure you update the year range as appropriate. If you're unsure which header to use or have any questions about licensing, please don't hesitate to ask in your pull request or reach out to the maintainers.

Ready to begin? Your journey with AG2 starts now. Every line of code, documentation edit, or helpful comment makes a difference. Join us in building the future of AI Agents!