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

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.5
File Size Uploaded
narna-0.2.5.tar.gz 284.8 kB Details

Built distribution (wheel)

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

Total release size: 590.4 kB

Release files / narna-0.2.5.tar.gz

Download URL narna-0.2.5.tar.gz
Size 284.8 kB
Tags Source
SHA-256 checksum
How to use checksums
f6c06ea48c9a1ff163087e2c4589f7c966bc4e4c8e457e66fea0d327918f1bb4
BLAKE2b-256 checksum
How to use checksums
3261c980b76c4cefebc838ae1d4dcd6ff68dff57fdb5121bb1df1cbf0770bc1f
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.5-py3-none-any.whl

Download URL narna-0.2.5-py3-none-any.whl
Size 305.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7f9b2aef01554deaeb6836283aa378ec265dba99fff631f303ecdc37e2ae80a8
BLAKE2b-256 checksum
How to use checksums
ed3bb054401330d85259cbf92b72cc60b7b4b95ca6dd4651f8fe51f055de76e8
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

This release

0.2.5 This release

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