ClaraVerse

README.md

Your Private AI Workspace

Built by the community, for the community. Private AI that respects your freedom.

Website · Documentation · Quick Start · vs Open WebUI · Community · Contributing

What is ClaraVerse?

ClaraVerse is a private AI workspace built around three things most AI chat UIs treat as an afterthought: agents that work as an actual team, memory that behaves like a real memory system instead of a flat list of notes, and a license that does not start charging you once people notice your project.

Chat, Crew (multi-agent teams with human review), a visual workflow builder, and Telegram integration all live in one app, on your own infrastructure. Use OpenAI, Claude, Gemini, or local models like Ollama and llama.cpp. Chats are stored locally on your device by default, with optional encrypted sync if you want them on more than one machine.

If you have Ollama or LM Studio running on your machine, ClaraVerse detects them automatically and imports all your models. Zero configuration.

Quick Start

One-line install (Linux / macOS)

curl -fsSL https://raw.githubusercontent.com/claraverse-space/ClaraVerse/main/cli/install.sh | bash && claraverse init

Docker Compose

git clone https://github.com/claraverse-space/ClaraVerse.git
cd ClaraVerse
docker compose -f docker-compose.production.yml up -d

Open http://localhost:3000, register your account (first user becomes admin), and start chatting.

Have Ollama running? ClaraVerse auto-detects it and imports all your models. No setup needed. Make sure Ollama is listening on 0.0.0.0 (set OLLAMA_HOST=0.0.0.0 in your Ollama config).

Want it in your terminal too?

claraverse agent install   # builds Clara Agent, puts `claracli` on your PATH
claracli                   # then run /login claraverse to connect it

See Clara Agent below.

Docker run (single command)

docker run -d \
  --name claraverse \
  -p 3000:3000 \
  -v claraverse-data:/app/data \
  -v claraverse-uploads:/app/uploads \
  --add-host=host.docker.internal:host-gateway \
  ghcr.io/claraverse-space/claraverse:latest

This runs ClaraVerse with a single container. For the full stack with MySQL, MongoDB, Redis, SearXNG, Qdrant and the embeddings sidecar (required for Knowledge bases / RAG), use the Docker Compose setup above. Single-container mode boots fine, but the Knowledge tab and search_knowledge tool need the sidecars and will surface "embeddings service unreachable" without them.

Advanced configuration

Prerequisites

Docker & Docker Compose v2+
4 GB RAM minimum (8 GB recommended)
Ollama, LM Studio, or any OpenAI-compatible API

Environment variables

Override defaults by creating a .env file next to docker-compose.production.yml:

# Port (default 3000)
CLARAVERSE_PORT=8080

# Point to a custom Ollama or LM Studio URL
OLLAMA_BASE_URL=http://host.docker.internal:11434
LMSTUDIO_BASE_URL=http://host.docker.internal:1234

Local AI auto-detection

ClaraVerse automatically discovers lo