Skip to main content

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.

License: MIT Website PyPI Spec

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
WhatsApp 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
Facebook webhook UAP_FB_PAGE_ACCESS_TOKEN
YouTube poll comments UAP_YOUTUBE_*
Instagram 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_code RPC, delegate tasks
  • Desktop — Windows / Mac / Linux (download)
  • MCP — narna evaluate, narna_agent_ask for 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)

Source distribution for narna 0.2.7
File Size Uploaded
narna-0.2.7.tar.gz 294.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for narna 0.2.7
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

0.2.9

2 release files

0.2.8

2 release files

This release

0.2.7 This release

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page