Community

Join the MAREF Community

Agent governance is a collective effort. Here's how you can contribute.

Watch the 2-min film See MAREF intercept a rogue agent in real time. →
The community wall

Contributors, maintainers, and users building governed AI.

MAREF is governed by the core maintainer team, with major decisions made through RFCs and community discussion. Every contributor — from a one-line docs fix to a core adapter — strengthens the wall.

100+
GitHub Stars
11,000+
Tests Passing
10/10
OWASP Agentic Top 10

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 maref

2. Install Dependencies

pip install -e ".[dev]"

3. Run Tests

pytest tests/ -v --cov=src/maref

4. Code Quality

ruff check src/          # Linting
mypy src/                 # Type checking
pytest tests/             # Run all tests

Contribution 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

Stay Connected

Follow MAREF on GitHub to stay updated on releases, RFCs, and community news.

★ Star on GitHub Join Discussions