Skip to content
NarraNexus
Open-Source Agent Framework

Agents That Remember
Who You Are

Most agent frameworks treat every conversation as day one. NarraNexus gives agents persistent memory, social identity, and evolving expertise — across sessions, topics, and teams.


Why NarraNexus

The problems we solve

Agents forget everything between sessions

Narrative Memory

Conversations are organized into topic-based storylines that persist for weeks. Your agent picks up right where you left off — even if the last message was 3 weeks ago on a different topic.

Agents don’t know who they’re talking to

Social Intelligence

Agents build a graph of everyone they interact with — names, roles, expertise, communication style. They adapt how they work based on who’s asking.

Agent capabilities are monolithic and rigid

Modular Architecture

Hot-swap capability modules without touching core logic. Add memory, jobs, skills, or agent-to-agent communication as independent plugins.


Capabilities

What makes NarraNexus different

Conversations become storylines

Narrative Memory

Every topic becomes a persistent Narrative with its own history, active modules, and summary. The agent routes new messages to the right storyline automatically — or creates a new one when the topic is genuinely new.

Learn more
Agents that build relationships

Social Awareness

Your agent tracks every person, team, and agent it encounters — their roles, expertise, preferences, and history. Follow up on leads, manage stakeholder relationships, coordinate across agents, and never lose context on who’s involved in what.

Learn more
Background tasks that just happen

Autonomous Work

Schedule one-off reminders, recurring checks, or ongoing monitoring tasks. Jobs run in the background with full context and report results through chat when they complete.

Learn more
Nothing is hardcoded

Extensible by Design

Modules are independent and hot-swappable. Skills install from a marketplace. LLM providers swap without code changes. Build with Claude, OpenAI, or Gemini — or switch between them.

Learn more

Architecture

System Overview

A layered pipeline from user interface to persistent storage.

FrontendReact · Tauri Desktop
API GatewayFastAPI · REST + WebSocket
Agent Runtime6-Step Pipeline · Context Engine
Module SystemHot-Swappable · MCP Tools
ServicesNarrative · Memory · Social · Jobs
Data LayerSQLite · MySQL · Vector Store
Module System
AwarenessSelf-knowledge
ChatSession management
MemoryDual-track recall
Social NetworkRelationship graph
JobsBackground tasks
SkillsMarketplace plugins
Agent CommsMulti-agent bus
RAGDocument knowledge

Read the full architecture guide →


In Practice

See it in action

Topic-Aware Conversations

  • 1Messages automatically routed to the right topic storyline
  • 23-stage selection: continuity detection → semantic search → agent decision
  • 38 default Narratives per user — from greetings to deep technical discussions
  • 4Cross-topic awareness: the agent knows what you discussed elsewhere

Use Cases

Who is it for

Personal Assistant

An agent that remembers your preferences, manages reminders, and adapts to how you like to communicate — across days, weeks, and topics.

Team Coordinator

Multi-agent systems where each agent has a specialty — research, scheduling, code review — and they coordinate through the MessageBus.

Developers

Build agents with persistent memory and social awareness in hours, not weeks. Modular architecture means you extend, not rewrite.

Researchers

Experiment with narrative-driven agent architectures. Study how topic-based memory and social graphs affect agent behavior over time.


Quick Start

Try it in 60 seconds

Three ways to get started, from zero-install to full local setup.

CloudFastest

No installation. Open in your browser, create an account, and start chatting with your agent immediately.

Open NarraNexus Web
Desktop AppmacOS

Download the macOS app. Bundled Python, auto-starts all services. No terminal required.

Download latest release →
From SourceDeveloper

Full local setup with tmux, 7 services, and hot-reload for development.

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

Detailed setup guide →


Roadmap

Where we are going

  1. 2026-03
    v1.0FoundationShipped
    • Core agent runtime with 7-step pipeline
    • Narrative memory engine
    • Module system with hot-pluggable capabilities
    • Built-in MCP tools
    • Multi-LLM provider support
  2. 2026-03
    v1.0.5Desktop & CloudShipped
    • macOS desktop app with bundled runtime
    • Cloud deployment with multi-tenant auth
    • Agent-to-agent communication (DM & group chat)
    • Skill system & ClawHub marketplace integration
    • Dashboard v2 with job tracking & cost monitoring
  3. 2026 Q2
    v1.1Scale & Integrate
    • Docker Compose one-command deployment
    • IM platform integrations (Telegram, Lark)
    • Community plugin system
    • Multimodal interaction support