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

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.4
File Size Uploaded
narna-0.2.4.tar.gz 282.0 kB Details

Built distribution (wheel)

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

Total release size: 584.7 kB

Release files / narna-0.2.4.tar.gz

Download URL narna-0.2.4.tar.gz
Size 282.0 kB
Tags Source
SHA-256 checksum
How to use checksums
77f90345f018b4aab473790a28da709e35bb6cda832457169d74cfb088693508
BLAKE2b-256 checksum
How to use checksums
bc1790b871c094aa05d2905cc0e0fb75ef64c5f12870f50a1598a574a048fbb8
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.4-py3-none-any.whl

Download URL narna-0.2.4-py3-none-any.whl
Size 302.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5f06a5a7bb4bcea8d380692aa3fc700dfddc31e7898e1f284f00102d62f9e71b
BLAKE2b-256 checksum
How to use checksums
aaccfbfd5dd31fc8544fb0fd8dcf319cac98841ca39d9815a783c3af4279575c
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

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

This release

0.2.4 This release

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