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


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.9

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.9
File Size Uploaded
narna-0.2.9.tar.gz 303.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for narna 0.2.9
File Interpreter ABI Platform
narna-0.2.9-py3-none-any.whl Python 3 none any Details

Total release size: 632.2 kB

Release files / narna-0.2.9.tar.gz

Download URL narna-0.2.9.tar.gz
Size 303.1 kB
Tags Source
SHA-256 checksum
How to use checksums
924debb509ec053d8f639759c1d85d113c58de8549ff4fd58a7bc0dbb4b7170b
BLAKE2b-256 checksum
How to use checksums
41f8c576a5743d5bb2cc80b001511b42c51ed8d125d6097429c1f016f8c8d1ef
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.9-py3-none-any.whl

Download URL narna-0.2.9-py3-none-any.whl
Size 329.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a937a5ff121f9386dc88cc6400ead8b5ded9c3b755db5bbcb127e50a94d28d06
BLAKE2b-256 checksum
How to use checksums
8ad720934f04ae8ecebb06e1210505985c9517c22492bb87464cd75eb0bcdcd4
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

This release

0.2.9 This release

2 release files

0.2.8

2 release files

0.2.7

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