](https://github.com/orchestrator-dev/rosmarium/actions/workflows/ci.yml){kind=link}
🚀 Try the Interactive Demo | 📚 Read the Documentation | 🌐 Visit Website
Most headless CMS tools treat AI as a plugin. Rosmarium treats it as infrastructure, acting as a true Content Orchestration System (COS). Built on a split-stack architecture, a TypeScript/Fastify core handles content branching, visual live previews, auth, REST/GraphQL, and a knowledge graph layer. A Python/FastAPI background worker handles LLM embeddings, RAG pipelines, semantic search, auto-tagging, NER, and graph analytics. Both components share PostgreSQL with pgvector extension natively.
We maintain exhaustive documentation similar to FastAPI and Swagger at rosmarium.com/docs.
Please refer to the site for detailed guides on:
- 🚀 Getting Started: Installation and Docker compose.
- 🏗️ Architecture: Understanding the Node/Python decoupled structure.
- 🧩 Content Modeling: Building composite and nested structures using blocks.
- 🌳 Content Branching: Safe collaboration and three-way merging.
- 👁️ Visual Live Preview: Real-time iframe SDK previews.
- 🔌 API Reference: Comprehensive endpoints for REST and GraphQL.
- 🤖 AI Pipeline: Deep dive into chunking, vector embeddings, and semantic tagging.
- 🕸️ Knowledge Graph: Typed edges, Cypher queries, and graph analytics.
If you inspect the Rosmarium favicon or project assets closely, you might notice references to Atomic Number 42 and Atomic Weight 284.14.
In the official lore of the project, "Rosmarium" (Rs) is the newly synthesized foundational element of modern Content Orchestration:
- Atomic Number 42: A direct nod to Douglas Adams' The Hitchhiker's Guide to the Galaxy. Rosmarium is designed to be the ultimate answer to the chaotic universe of headless CMS sprawl.
- Atomic Weight 284.14: Measured playfully in "Content-Daltons," this represents the exact stabilized atomic weight of a perfectly structured JSON payload bound with Python AI embeddings. (It's also suspiciously close to the molecular weight of certain robust organic compounds found in actual Rosemary extracts!)
# Clone and install
git clone https://github.com/orchestrator-dev/rosmarium
cd rosmarium && pnpm install
# Start infrastructure (PostgreSQL, Redis, MinIO)
pnpm infra:up && pnpm infra:init
# Configure environment and run migrations
cp .env.example .env
pnpm db:migrate
pnpm db:seed
# Start the servers in separate terminals
pnpm --filter @orchestrator.dev/server dev
cd apps/rosmarium-ai-worker && uv run uvicorn rosmarium_ai_worker.main:app --app-dir src --port 8001
pnpm --filter @orchestrator.dev/admin devRosmarium is Apache 2.0 licensed. See CONTRIBUTING.md for how to get involved and the codebase conventions.