Getting Started
Rosmarium is a monorepo built on Turborepo and pnpm. The absolute fastest way to get started is by spinning up the shared infrastructure via Docker Compose and running the Node and Python services natively on your local machine.
⚡️ Prerequisites
[!TIP] Why Docker? We use Docker Compose strictly for the infrastructure (PostgreSQL with pgvector, Redis, and MinIO) to guarantee a reproducible, isolated environment without polluting your local machine. The actual core application runs natively for maximum developer velocity.
Installation
Follow these steps to bootstrap the platform on your local machine.
Clone the repository
git clone https://github.com/orchestrator-dev/rosmarium
cd rosmariumInstall dependencies
This will install packages for all apps and packages in the monorepo.
pnpm installSpin up Infrastructure
Starts PostgreSQL, Redis, and MinIO locally via Docker.
pnpm infra:up
pnpm infra:initConfigure Environment & DB
Copy the env file, apply the Drizzle schema migrations, and seed the admin user.
cp .env.example .env
pnpm db:migrate
pnpm db:seedRunning the Services
Rosmarium consists of three core applications that run simultaneously during development. Open three terminal tabs and run the following:
The core Node.js TypeScript GraphQL / REST server.
pnpm —filter @orchestrator.dev/server devThe Python FastAPI embedding & intelligence pipeline.
cd apps/rosmarium-ai-worker
uv run uvicorn rosmarium_ai_worker.main:app —app-dir src —port 8001 —reloadThe React Vite dashboard. Requires API server running.
pnpm —filter @orchestrator.dev/admin devSeeding the Demo Dataset
To immediately see Rosmarium’s AI features, Knowledge Graph, and Semantic Search in action, you can seed the demo dataset:
pnpm demo:seedThis command will automatically insert sample articles, trigger vector embedding generation in the AI Worker, and run initial graph analytics so you have a fully populated, intelligent repository to explore.