Skip to main content

​
Overview

Nadoo AI is designed to run on your own infrastructure. Whether you need a local development environment, a team demo, or a production deployment, there is a Docker Compose configuration ready for your scenario.

​
Deployment Options

EnvironmentDocker Compose FileExposed PortsUse Case
Localdocker-compose.local.yml5432, 6379Backend dependencies only (Postgres + Redis). Run backend and frontend natively on your machine.
Devdocker-compose.dev.yml15432, 16379, 18000, 13000Full stack with hot-reload. All services run in Docker with mapped ports for debugging.
Demodocker-compose.demo.yml80, 443, 3000, 8000All-in-one demo deployment. Pre-configured for quick evaluation.
Productiondocker-compose.all.yml30000+ rangeMulti-service production deployment with Nginx, Celery workers, and monitoring.

Local Development

The fastest way to start developing. Runs only Postgres and Redis in Docker while you develop the backend and frontend locally.

Environment Variables

Complete reference for all environment variables used by Nadoo AI services.

​
System Requirements

​
Minimum Requirements

ComponentRequirement
DockerDocker Engine 20.10+ and Docker Compose v2+
Node.js22.0 or later (for frontend development)
Python3.11 or later (for backend development)
RAM4 GB minimum (8 GB recommended)
Disk10 GB free space

​
Production Requirements

ComponentRequirement
CPU4+ cores
RAM16 GB+
Disk50 GB+ SSD
OSLinux (Ubuntu 22.04 LTS recommended)

​
Infrastructure Components

Nadoo AI consists of the following services:

​
Core Services

ServiceTechnologyPurpose
Backend APIFastAPI (Python 3.11+)REST API server handling all platform logic
FrontendNext.js (Node.js 22+)Web application UI
Celery WorkersCelery + RedisAsynchronous task processing (document ingestion, batch operations)

​
Data Stores

ServiceTechnologyPurpose
PostgreSQLPostgreSQL 15+ with pgvectorPrimary database with vector search for embeddings
RedisRedis 7+Caching, session storage, Celery message broker, and rate limiting

​
Infrastructure

ServiceTechnologyPurpose
NginxNginxReverse proxy, TLS termination, static file serving (production)

​
Architecture Diagram

​
Quick Start

The fastest way to get started is with the local development setup: 
# Clone the repository
git clone https://github.com/nadoo-ai/nadoo-ai.git
cd nadoo-ai

# Start Postgres and Redis
docker-compose -f infrastructure/docker-compose.local.yml up -d

# Start the backend
cd packages/backend
pip install -r requirements.txt
alembic upgrade head
uvicorn src.main:app --reload --port 8000

# In another terminal, start the frontend
cd packages/frontend
npm install
npm run dev
See the Local Development Setup guide for detailed instructions.
For production deployments, we recommend using docker-compose.all.yml with proper TLS certificates, secret management, and monitoring. See the production deployment guide for details.