Browse the source code, open issues, submit pull requests, and star the project.
admina-org/admina βAsk questions, share your setup, propose features, and talk to the maintainer and community.
Join discussions βFound a bug? Have a feature request? Open an issue β we respond within 4 hours.
Open an issue βHow to set up your dev environment, coding conventions, testing, and submitting PRs.
Read CONTRIBUTING.md βHow to contribute
All contributions are welcome, from bug fixes to new governance pillars. Here are the most impactful ways to help.
Report bugs and edge cases
Run Admina in your environment and share what you find. Real-world edge cases improve governance quality for everyone.
Contribute injection patterns
The P2 Firewall uses a library of regex patterns. Add new patterns for attack vectors you've encountered β each one protects all Admina users.
Write connectors
LangChain and CrewAI connectors are on the roadmap. If you use one of these frameworks, a decorator-based integration would be a high-impact contribution.
Improve documentation
Clear docs are as important as good code. Fix typos, improve examples, translate content, or write a tutorial.
Share benchmarks
Run the benchmark suite on your hardware and share the results. Performance data from diverse environments strengthens the project.
Star and spread the word
A GitHub star signals to the community that this project matters. Share Admina with your team, write a blog post, or talk about it at a meetup.
Maintainer
Why "Admina"?
Admina comes from admin β administrative oversight, system governance β shaped into a name with a firm, precise sound, like a trusted system daemon always running quietly in the background.
It also echoes admina as in to administer β the act of managing, enforcing rules, and keeping systems in order. Exactly what Admina does for AI agents.
Stress on the first syllable: Γ-dmi-na. Think of it like Γ dmin + a, not ad-mΓ-na. Three clean syllables, firm and direct β like the governance it provides.
Roadmap
Admina is under active development. Here's what's shipped and what's coming.
- 6-pillar pipeline: Loop Breaker, Firewall, PII, OTEL, Forensic, EU AI Act
- Python reference implementation with full test coverage
- Docker Compose stack (proxy + Redis + MinIO + ClickHouse + Grafana)
- OpenAPI / Swagger UI at
/docs
- Rust core engine via PyO3 β 1.7Γ faster governance pipeline (~14Β΅s)
- OpenClaw skill, adapter, and stdio bridge
- Multi-upstream MCP routing
- SSE streaming passthrough
- EU AI Act Art. 6 compliance classifier endpoint
- Per-agent identity management and capability scoping
- YAML-based policy rules (allow/block/redact per tool/agent)
- Webhook callbacks on governance events
- Claude / GPT-4o native SDK adapters
- Stable public API with semantic versioning guarantees
- LangGraph, AutoGen, and CrewAI adapters
- Real-time governance dashboard (Grafana + ClickHouse)
- EU AI Act Art. 9β15 automated gap-report generation