Quick Start

Option 1: macOS Desktop App (Recommended)

Download the NarraNexus desktop app — one-click install with auto-updates.

Download NarraNexus for macOS (Universal)

1. Download the .dmg file
2. Open it and drag NarraNexus to your Applications folder
3. Launch NarraNexus — it handles all service orchestration automatically

No need to install Python, Node.js, or Docker separately. The desktop app manages everything for you.

Option 2: Install from Source (Linux / macOS)

Prerequisites

• Python 3.13+
• Node.js 20+
• Docker (for MySQL)
• Git

Installation

Clone the repository and run the setup script:

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

The run.sh script automatically detects your OS, installs dependencies, sets up MySQL via Docker, and starts all services.

Configuration

After first run, configure your LLM provider in the .env file:

LLM_PROVIDER=claude
ANTHROPIC_API_KEY=your-key-here

Next Steps

• Read the Architecture guide to understand the system
• Check out Examples for real-world usage patterns
• Explore the Modules documentation