Contributing to HUMΛN

Help build the future of Human-AI Orchestration

HUMΛN is an open protocol built by a global community of developers, researchers, and organizations. We welcome contributions of all kinds — code, documentation, agents, workflows, and ideas.

Whether you're fixing a typo, building a new agent, or proposing a major feature — every contribution matters. Let's build something amazing together.

Ways to Contribute

Other Ways to Help

📝 Improve Documentation

Found a typo? See a confusing explanation? Submit a PR to improve our docs. Clear documentation is critical for adoption.

🐛 Report Bugs

Open an issue on GitHub with a clear description and reproduction steps. Good bug reports help us fix problems faster.

💡 Propose Features

Have an idea for improving the protocol? Start a discussion in GitHub Discussions. The best ideas come from the community.

🎓 Teach & Share

Write blog posts, create tutorials, give talks, or make videos about HUMΛN. Help others learn and grow the community.

🤝 Answer Questions

Join our Discord and help answer questions from newcomers. Your experience can save someone hours of frustration.

Getting Started

1

Read the Code of Conduct

We're building an inclusive community. Be respectful, collaborative, and constructive. Read our full Code of Conduct on GitHub.

2

Explore the Codebase

Clone the repo, read through the code, run the tests. Understanding the architecture will help you contribute effectively. Check out our Architecture Guide.

3

Find a Good First Issue

Look for issues labeled "good first issue" on GitHub. These are beginner-friendly tasks that don't require deep knowledge of the codebase.

4

Submit a Pull Request

Fork the repo, make your changes, write tests, and submit a PR. Include a clear description of what you changed and why. We'll review it ASAP!

Join the Community

Connect with other contributors, ask questions, and stay up to date with the latest developments.