Skip to main content

Installation

Prerequisites

  • Docker Desktop installed and running
  • Git installed

Clone and start

git clone https://github.com/govtech-responsibleai/kaleidoscope.git
cd kaleidoscope
cp .env.example .env
docker compose up -d

Wait for all containers to start. You can check status with:

docker compose ps

Once all services are healthy, open http://localhost:3000 in your browser. Sign in with dev / dev and start evaluating.

Self-hosting?

If you're deploying Kaleidoscope for your team with shared secrets, review and edit the provider catalog and .env file prior to deployment. See LLM Providers for the full reference.