Setup

Walk through the guided setup wizard to configure Bohr AI.

The bohr setup wizard configures your model provider, API keys, and optional packages. It runs automatically on first launch, but you can re-run it at any time to change your configuration.

Running setup

bohr setup

The wizard walks you through three stages: model configuration, authentication, and optional package installation.

Stage 1: Model selection

Bohr AI supports multiple model providers. The setup wizard presents a list of available providers and models. Select your preferred default model using the arrow keys:

? Select your default model:
  anthropic:claude-sonnet-4-20250514
> anthropic:claude-opus-4-20250514
  openai:gpt-4o
  openai:o3
  google:gemini-2.5-pro

The model you choose here becomes the default for all sessions. You can override it per-session with the --model flag or change it later via bohr model set <provider/model> or bohr model set <provider:model>.

Stage 2: Authentication

Depending on your chosen provider, setup prompts you for an API key or walks you through OAuth login. For providers that support Pi OAuth (like Anthropic and OpenAI), Bohr AI opens a browser window to complete the sign-in flow. Your credentials are stored securely in the Pi auth storage at ~/.bohr/.

For API key providers, you are prompted to paste your key directly:

? Enter your API key: sk-ant-...

Keys are encrypted at rest and never sent anywhere except the provider’s API endpoint.

Amazon Bedrock

For Amazon Bedrock, choose:

Amazon Bedrock (AWS credential chain)

Bohr AI verifies the same AWS credential chain Pi uses at runtime, including AWS_PROFILE, ~/.aws credentials/config, SSO, ECS/IRSA, and EC2 instance roles. Once that check passes, Bedrock models become available in bohr model list without needing a traditional API key.

Local models: Ollama, LM Studio, vLLM

If you want to use a model running locally, choose the API-key flow and then select:

Custom provider (baseUrl + API key)

For Ollama, the typical settings are:

API mode: openai-completions
Base URL: http://localhost:11434/v1
Authorization header: No
Model ids: llama3.1:8b
API key: local

That same custom-provider flow also works for other OpenAI-compatible local servers such as LM Studio or vLLM. After saving the provider, run:

bohr model list
bohr model set <provider>/<model-id>

to confirm the local model is available and make it the default.

Stage 3: Optional packages

Bohr AI’s core ships with the essentials, but some features require additional packages. The wizard asks if you want to install optional presets:

  • session-search — Enables searching prior session transcripts for past research
  • memory — Automatic preference and correction memory across sessions
  • generative-ui — Interactive HTML-style widgets for rich output

You can skip this step and install packages later with bohr packages install <preset>.

Re-running setup

Configuration is stored in ~/.bohr/settings.json. Running bohr setup again overwrites previous settings. If you only need to change a specific value, edit the config file directly or use the targeted commands like bohr model set or bohr alpha login.