configuring-brainpalacelisted

# Configuring BrainPalace Installation and configuration for BrainPalace document search with pluggable providers. ## Contents - [Quick Setup](#quick-setup) - [Setup Wizard](#setup-wizard) - [Prerequisites](#prerequisites) - [Installation](#installation) - [Provider Configuration](#provider-configuration) - [Project Initialization](#project-initialization) - [Verification](#verification) - [When Not to Use](#when-not-to-use) - [Reference Documentation](#reference-documentation) --- ## Multi-Runtime Support BrainPalace supports multiple AI coding runtimes from a single canonical plugin source: | Runtime | Install Command | |---------|----------------| | Claude Code | `brainpalace install-agent --agent claude` | | OpenCode | `brainpalace install-agent --agent opencode` | | Gemini CLI | `brainpalace install-agent --agent gemini` | All runtimes share the same `.brainpalace/` data directory for indexes, configuration, and server state. The `install-agent` command converts the canonical plugin format into each runtime's native format automatically. Use `--global` for user-level installation, or `--dry-run` to preview files before writing. --- ## Quick Setup ### Option A: Local with Ollama (FREE, No API Keys) ```bash # 1. Install packages pip install brainpalace-rag brainpalace-cli # 2. Install and start Ollama brew install ollama # macOS ollama serve & ollama pull nomic-embed-text ollama pull llama3.2 # 3. Configure for Ollama export EMBEDDING_PROVIDER=ollama export