Install

One command. Full cognitive stack.

Vitruvyan installs on any machine with Docker. The installer provisions the kernel, the cognitive bus, semantic memory, and all core services. You're running in minutes.

Requirements

Docker

24+

RAM

4 GB minimum

Disk

10 GB

OS

Linux / macOS

Quick install

Run this on a clean machine or an existing server. The installer detects your environment and pulls only what's needed.

terminal

# Download and run the installer

$ curl -fsSL https://get.vitruvyan.com | bash

# Or with explicit version

$ curl -fsSL https://get.vitruvyan.com/v1.16 | bash

The installer script is auditable — review it before running: curl -fsSL https://get.vitruvyan.com | less

What the installer does

No magic. Here's exactly what runs on your machine.

  1. 01

    Environment check

    Verifies Docker version, available RAM, disk space. Fails fast with clear error messages if requirements aren't met.

  2. 02

    Pull kernel images

    Downloads the core container images — cognitive bus (Redis Streams), semantic memory (Qdrant), persistence (PostgreSQL), and the kernel orchestrator.

  3. 03

    Generate configuration

    Creates a local configuration directory with environment files, secrets, and Docker Compose manifests. All values are machine-local — nothing phones home.

  4. 04

    Start services

    Brings up the full stack via Docker Compose. Health checks run automatically. The installer waits until all services report healthy before returning.

  5. 05

    Install CLI

    Places the `vit` CLI in your PATH. From here, you manage the kernel, create verticals, and monitor the system from your terminal.

After install

The kernel is running. Here's what to do next.

vit status

Verify all kernel services are healthy.

vit vertical create my-domain

Scaffold your first domain vertical.

vit vertical deploy my-domain

Deploy into the running kernel.

Need more control?

Custom Docker Compose setups, GPU acceleration, multi-node deployment, edge configurations — it's all in the knowledge base.

Full documentation