HolocronGet started

Install

Install Holocron

Holocron runs locally via Docker. You only need Node.js (for the CLI) and Docker Desktop — no Python, Postgres, or manual setup.

Watch the demo video first
  1. 1

    Install Node.js 20 LTS

    Required to run the holocron CLI via npx.

    nodejs.org/en/download →
    • Download Node.js 20 LTS from nodejs.org and run the installer.
  2. 2

    Install Docker

    Holocron ships Postgres, agents, web UI, LaTeX, and Supermemory in Docker images.

    Docker Desktop →
    • Install Docker Desktop and enable WSL 2 when prompted.
    • Restart PowerShell or Terminal after installing Node.
  3. 3

    Verify prerequisites

    npx holocron-research@latest doctor

    All checks should pass before starting.

  4. 4

    Start Holocron

    npx holocron-research@latest start

    First run runs the setup wizard, pulls ~2–4 GB of Docker images (5–10 min on slow connections), and opens http://localhost:3000.

Troubleshooting

  • Docker not running — start Docker Desktop and wait for "Docker is running".
  • Port in use — free ports 3000, 8000, 5432, or 6767.
  • Mock content only — add an LLM API key via setup or Settings.

Need the full feature overview? See features →