Getting Started

Prerequisites

Node.js 20+
MongoDB instance
Norman Engine running (http://localhost:3001)
Norman Agent running (http://localhost:3004) — for v1 mode
ShellApps OAuth credentials

Installation

git clone https://github.com/ShellTechnology/norman-chat.git
cd norman-chat
npm install

Configuration

cp .env.example .env

# Auth
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your-nextauth-secret
SHELLAPPS_CLIENT_ID=your-client-id
SHELLAPPS_CLIENT_SECRET=your-client-secret

# Services
NORMAN_ENGINE_URL=http://localhost:3001
NORMAN_AGENT_URL=http://localhost:3004
NORMAN_LIBRARY_URL=http://localhost:3002

# Database
MONGODB_URI=mongodb://localhost:27017/norman-chat

Development

npm run dev

Open http://localhost:3000 in your browser.

Building

npm run build
npm start

Architecture Configuration