Join the MAREF Community
Agent governance is a collective effort. Here's how you can contribute.
Ways to Contribute
Code
Contribute to the core framework, adapters, or tools. All contributions go through PR review on GitHub.
Open a PR →Documentation
Improve tutorials, fix typos, translate content, or write new guides for the community.
Improve docs →Report Issues
Found a bug? Have a feature request? Open an issue on GitHub with a clear description.
Open an issue →Discuss
Join the conversation on GitHub Discussions. Share ideas, ask questions, or help others.
Join discussions →Development Setup
1. Clone the Repository
git clone https://github.com/maref-org/maref.git
cd maref2. Install Dependencies
pip install -e ".[dev]"3. Run Tests
pytest tests/ -v --cov=src/maref4. Code Quality
ruff check src/ # Linting
mypy src/ # Type checking
pytest tests/ # Run all testsContribution Guidelines
Coding Standards
- • Python: PEP 8 + ruff + mypy strict mode
- • TypeScript: ESLint + strict mode
- • All security-critical functions must use
@security_critical
Commit Messages
Use conventional commits: feat(module): description, fix(security): description, docs(readme): description
PR Requirements
- • All tests must pass
- • Code coverage should not decrease
- • New features must include tests
- • Documentation updates for public APIs
Project Governance
MAREF is governed by the core maintainer team. Major decisions are made through RFCs and community discussion.
100+
GitHub Stars
4,300+
Tests Passing
82%
Code Coverage
Stay Connected
Follow MAREF on GitHub to stay updated on releases, RFCs, and community news.