Prerequisites

System Requirements

NarraNexus requires a modern development environment with Python and Node.js. The platform has been tested on Linux (Ubuntu 22.04+), macOS (13+), and Windows via WSL2. A minimum of 8 GB RAM is recommended for local development, and 16 GB or more for running multiple agents concurrently.

Required Software

Before installing NarraNexus, ensure the following tools are available on your system:

• Python 3.13+ -- The backend and agent runtime are built with Python using FastAPI and asyncio. Make sure pip is also installed.
• Node.js 20+ -- The frontend is a React 19 application bundled with Vite. npm is used for dependency management.
• Docker and Docker Compose -- MySQL, Redis, and Matrix/Synapse containers are managed via Docker Compose. Ensure the Docker daemon is running.
• Git -- Required for cloning the repository and managing version control.

LLM Provider Keys

NarraNexus supports multiple LLM providers. You will need at least one API key from the following services:

• Anthropic (Claude) -- Recommended as the default provider. Obtain a key from the Anthropic console.
• OpenAI -- Supported via the OpenAI Agents SDK. Requires an OpenAI API key.
• Google Gemini -- Used for both reasoning and the RAG module's file search capabilities.

Optional Dependencies

For production deployments, you may also need nginx for reverse proxying and systemd for service management. AWS-compatible infrastructure is supported for cloud deployments.