Quick Start

Up and running in 60 seconds

Simmetric Chat runs fully offline. Follow the steps below to boot the full stack on your machine.

Install prerequisites

bash

# Node.js ≥ 24, pnpm 11, PostgreSQL 16
node -v && pnpm -v && psql --version

# Optional but recommended: Ollama for local LLM
ollama pull gemma4:latest

Clone and install dependencies

bash

git clone https://github.com/studio-simos/simmetric simmetric-chat
cd simmetric-chat
pnpm install

Configure environment

bash

cp .env.example .env
# Required in the repo-root .env:
#   JWT_SECRET=<strong random value>
#   COLLECTOR_SECRET=<shared with the collector>
# (DATABASE_URL has a code default)

Set up the database

bash

pnpm db:generate    # generate Prisma client
pnpm db:migrate     # apply migrations
pnpm db:seed        # roles, permissions, bootstrap admin (admin / admin123)

Start all services

bash

pnpm dev    # turborepo: server + collector + widget + frontend in parallel

First launch

Open http://localhost:5173. Sign in with the bootstrap admin (admin / admin123) — the setup wizard forces a password change on first login.

Services running locally

Frontend:5173

Server:3000

Collector:3210

Widget:3211

Docker quick start

Prefer containers? A single command boots everything.

bash

docker compose -f docker/docker-compose.yml up --build -d

Read the docs Explore features