Getting Started with NornWeave

NornWeave Documentation

Get NornWeave up and running in minutes.

Installation

Install NornWeave using Docker or from source

Configuration

Environment variables and settings

Quickstart

Create your first inbox and send an email

Prerequisites

Python 3.14+ (quickest: pip install nornweave && nornweave api)
Or: Docker and Docker Compose (recommended for production)
An email provider account (Mailgun, SendGrid, AWS SES, Resend, or IMAP/SMTP)

Quick Install

# Clone the repository
git clone https://github.com/DataCovey/nornweave.git
cd nornweave

# Copy environment configuration
cp .env.example .env

# Start the stack
docker compose up -d

Continue to the Installation Guide for detailed instructions.