NarraNexus

Frameworks & SDKs 💻 Python ⚖️ Apache-2.0 🟢 Actively maintained
86 stars

NarraNexus is a long-term AI team platform that gives agents persistent identity, evolving memory, and stable social relationships, enabling them to collaborate like colleagues. It solves the problem of disposable AI assistants by letting agents remember past interactions, self-correct, and work together on long-running projects. It is for solo founders, small teams, and developers who want to build a one-person company with AI agents.

NarraNexus demo
🎞️ Demo from the project README

✨ Key features

  • Narrative long-term memory with time-aware storylines and invalidation of outdated facts.
  • Awareness module for persistent identity, responsibilities, and behavioral boundaries.
  • Social Network for remembering relationships and adapting communication per contact.
  • Team collaboration with scoped memory (agent, user, storyline, team, global) and governed sharing.
  • Per-agent Skills and MCP toolsets for hot-pluggable capabilities.
  • MessageBus protocol for agent-initiated communication, group chats, and task handoffs.

🎯 Use cases

  • Continuous market and competitor tracking with a research agent.
  • Multi-role coordinated execution for product, engineering, operations, and content.
  • Client and partnership management with relationship memory.
  • Long-running project execution across days with context continuity.
  • Experience accumulation and business replication for solo founders.

📦 Installation

🧰 Requirements: Local and desktop runs need your own LLM API key; cloud version has a free trial quota. No other prerequisites stated.

From source

git clone https://github.com/NetMindAI-Open/NarraNexus.git
cd NarraNexus
bash run.sh

run.sh checks prerequisites and launches the local services. For the full setup, see the Quick Start.

macOS desktop app

The app bundles its own runtime — no extra Python, Node, or Docker to install.

  1. Download the app
  2. Drag it into the Applications folder
  3. Launch and pick a template

Cloud sign-up

  1. Open agent.narra.nexus
  2. Sign up
  3. Pick a template and go

🚀 Usage

The README does not provide a code example for using the tool beyond installation. It describes starting via cloud sign-up, desktop app, or source. For usage, you would typically launch the app and pick a template. No minimal code example is given.

⚠️ Good to know

Agents aren't 100% out of the box and need corrections; more memory isn't better memory; collaboration needs designed boundaries; local runs need an API key.

❓ FAQ

What makes NarraNexus different from other agent platforms?

It focuses on long-lived AI teams with persistent identity, evolving memory, and social relationships, unlike tools that treat agents as disposable or session-based.

Do I need my own LLM API key?

Yes, for local and desktop runs you need your own LLM API key. The cloud version offers a free trial quota.

Can agents communicate with each other?

Yes, agents can @mention each other over the MessageBus protocol, create rooms, chat in groups, split work, and hand off tasks.

Is there a cloud version?

Yes, you can sign up at agent.narra.nexus and start with a free trial quota.

📊 Repository

Stars★ 86
Forks🍴 16
Open issues🐛 55
Last commit🕒 Sep 2, 2026
Created📅 Feb 2026
Language💻 Python
License⚖️ Apache-2.0

🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.