NARNA
Open-source AI Agent with Decision Quality built in.
Run on Telegram, WhatsApp, X, Discord, and more.
Every action scored by ADQA before it executes.
NARNA is a standalone AI project — not part of 99X or any exchange codebase.
See docs/ABOUT.md.
What NARNA is
| Layer | What it does |
|---|---|
| NARNA Agent | BYOK agent runtime — tools, browser, memory, skills, desktop, gateway |
| NARNA ADQA | Decision Quality Assurance — evidence, policy, risk, confidence |
| UGS | Open governance standard — portable packages, audit, prove |
Unique vs Hermes / OpenClaw: they optimize how agents act. NARNA adds whether the decision is good enough to act — then learns from outcomes.
User → NARNA Agent → proposed action → ADQA score → ACT / REVIEW / REJECT → Decision Memory
Compatible with OpenClaw, Hermes, LangGraph, CrewAI, MCP — plug in ADQA without replacing your stack.
Quick start
pip install "narna[desktop]"
narna desktop # local agent UI
narna gateway status # social channel readiness
narna ask "Summarize Q3 risks"
Cloud: narna.org · API health: https://api.narna.org/v1/health
OpenClaw + NARNA ADQA
"mcp": {
"servers": {
"narna": {
"url": "https://api.narna.org/mcp",
"headers": { "Authorization": "Bearer uap_live_…" }
}
}
}
Skill: plugins/narna-openclaw/
Social channels (agent everywhere)
| Channel | Mode | Env |
|---|---|---|
| Telegram | poll / webhook | UAP_TELEGRAM_BOT_TOKEN |
| webhook (Twilio) | UAP_TWILIO_* |
|
| Discord | poll / webhook | UAP_DISCORD_BOT_TOKEN |
| Slack | events webhook | UAP_SLACK_BOT_TOKEN |
| X (Twitter) | webhook | UAP_X_BEARER_TOKEN |
| webhook | UAP_FB_PAGE_ACCESS_TOKEN |
|
| YouTube | poll comments | UAP_YOUTUBE_* |
| webhook (beta) | UAP_IG_PAGE_ACCESS_TOKEN |
|
| TikTok | webhook (planned) | UAP_TIKTOK_* |
| Signal / Email | webhook | see docs/SOCIAL-CHANNELS.md |
narna gateway run # long-poll Telegram + Discord + Slack + YouTube
narna gateway channels
Full setup: docs/SOCIAL-CHANNELS.md
Agent capabilities
- 44+ tools — shell, browser (Playwright), code, search, skills, cron, voice
- BYOK — OpenAI, Anthropic, Gemini, DeepSeek, Qwen, local models
- Memory — FTS5 + MEMORY.md / USER.md + Decision Memory
- Skills — SKILL.md hub, zip export/import, OpenClaw-compatible
- Subagents —
execute_codeRPC, delegate tasks - Desktop — Windows / Mac / Linux (download)
- MCP —
narna evaluate,narna_agent_askfor any agent
Hermes/OpenClaw parity tracker: docs/PARITY-ROADMAP.md
Governance (enterprise)
from narna import wrap
agent = wrap(my_langgraph_app, vap=True, mode="enforce")
agent.run("approve vendor contract")
narna decision evaluate --action contract.sign --question "Should we sign?"
| Concept | Role |
|---|---|
| VAP | Verify · Audit · Prove |
| GU | Cloud metering unit |
| Governance Package | EU AI Act, HIPAA, GDPR… portable YAML |
| Decision OS | Evidence · risk · approval · audit trail |
Docs: docs/DECISION-OS.md · docs/DIFFERENTIATION.md
Links
| Site | https://narna.org |
| GitHub | https://github.com/hanyangkai/narna |
| API | https://api.narna.org/v1/health |
| MCP | https://api.narna.org/mcp |
| MVP status | docs/MVP-CHECKLIST.md |
| Social setup | docs/SOCIAL-CHANNELS.md |
| Hermes compare | docs/HERMES-COMPARE.md |
| Ship log | docs/SHIP-LOG.md |
| Install | docs/INSTALL.md |
Compatibility
OpenAI · Anthropic · Google · MCP · OpenTelemetry · LangGraph · CrewAI · OpenClaw · Hermes · Docker
License
MIT
Metadata
Release files for narna 0.2.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| narna-0.2.7.tar.gz | 294.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| narna-0.2.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 610.8 kB
Release files / narna-0.2.7.tar.gz
| Download URL | narna-0.2.7.tar.gz |
|---|---|
| Size | 294.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9060a2f085ca514a34258abdc2d6d6ba2915416501e1adca5ec5ffec8ee75676
|
|
BLAKE2b-256 checksum How to use checksums |
0598505a4d30614a2cb612910f508c2ecf6d0f55616377a62bf39aa61542f605
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / narna-0.2.7-py3-none-any.whl
| Download URL | narna-0.2.7-py3-none-any.whl |
|---|---|
| Size | 316.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
dbad9995c2a58dcad0d9f940bc88c0d2fda3218dde0f084cf2cb6861c034edbf
|
|
BLAKE2b-256 checksum How to use checksums |
db8365a4181bf9bda2b0baf78721d0fcb647f740542bb8b4d8f65b87a24c6bfb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|