FAQ

FAQ

General

What is MAREF?

MAREF (Multi-Agent Recursive Evolution Framework) is the world's first Agent Governance OS. It manages Agent cluster lifecycle, safety boundaries, state health, and evolution direction.

How is MAREF different from LangGraph/CrewAI/AutoGen?

MAREF focuses on governance depth (10/10 vs 0-3 for competitors). While other frameworks focus on orchestration, MAREF provides formal verification, trust scoring, drift detection, and recursive self-evolution.

Is MAREF production-ready?

Yes, v0.30.0-GA is a stable release with 4,300+ tests and 82% coverage.

---

Installation

What Python version do I need?

Python 3.10 or higher.

Can I run MAREF on Windows?

Yes, MAREF supports macOS, Linux, and Windows. Desktop Agent操控 works on all three platforms.

How do I install the GUI?

cd gui && pnpm install && pnpm electron:dev

---

Governance

What is the "Eight Trigrams" trust state machine?

It's an 8-state trust model (乾→坤→震→巽→坎→离→艮→兑) using Gray Code transitions. Each trust change modifies only one dimension (hamming distance=1), ensuring stability.

How does the CircuitBreaker work?

After 3 consecutive failures, the Agent is automatically locked for 30 seconds. This prevents cascading failures.

What is TLA+ formal verification?

TLA+ is a formal specification language. MAREF uses it to mathematically prove safety properties — ensuring the governance system behaves correctly under all possible states.

---

Security

How do I report a security vulnerability?

Do NOT open a public issue. Report via SECURITY.md.

What encryption does MAREF use?

• Standard: cryptography library for all crypto operations
• Chinese National Standards: SM2/SM3/SM4-GCM (国密算法)
• Audit logs: HMAC-SHA256 signed for tamper-evidence

Can I use MAREF outside China with SM2/SM3/SM4?

Yes, but you're responsible for local cryptographic export compliance. See Security Whitepaper for details.

---

Development

How do I contribute?

See our Contributing Guide.

Do I need to sign a CLA?

Yes, all external contributors must sign the ICLA before their first PR is merged.

What's the test coverage requirement?

New features must maintain ≥80% coverage. Run pytest tests/ -v --cov to verify.

---

← Back to Home