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

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.8
File Size Uploaded
narna-0.2.8.tar.gz 299.0 kB Details

Built distribution (wheel)

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

Total release size: 623.0 kB

Release files / narna-0.2.8.tar.gz

Download URL narna-0.2.8.tar.gz
Size 299.0 kB
Tags Source
SHA-256 checksum
How to use checksums
40dc1745b4cedc4329bf6513eb32110c44b33c96c01d77fe04e3432effb5ea55
BLAKE2b-256 checksum
How to use checksums
e97267265001a046add4404428b298d4aea02e77f665f59d98bb45cf190c456b
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.8-py3-none-any.whl

Download URL narna-0.2.8-py3-none-any.whl
Size 324.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
af8376cfbf0bf46fce3cb65a8274893d4e7911aaefff4b13628a1ae432ab330f
BLAKE2b-256 checksum
How to use checksums
d2fa85fdf952581169cca13e9a70355e01250b2f7138ed034c1a06b2ed9b9680
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

This release

0.2.8 This release

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