Skip to main content
The fastest way to get Bolly running. A single curl command downloads the latest binary, creates your config, and sets up a background service.

​
Install

curl -fsSL https://bollyai.dev/install.sh | bash
This script will:
  1. Detect your operating system and architecture
  2. Download the latest Bolly binary from GitHub releases
  3. Place it in a system-accessible location
  4. Create the default config directory at ~/.bolly/
  5. Generate a default config.toml
  6. Set up a background service (systemd on Linux, launchd on macOS)
The install script is open source. You can review it on GitHub before running.

​
Open Bolly

The install script starts the service automatically. Open http://localhost:26559 in your browser — Bolly will guide you through the initial setup. During onboarding you’ll choose your AI provider:
  • API Key — bring your own Anthropic key from console.anthropic.com. Pay per usage.
  • Claude Code — use your Claude subscription via OAuth login. Requires extra usage enabled.
  • OpenAI — bring your own OpenAI key. Pay per usage.
  • Codex — use your ChatGPT subscription via BYOKEY proxy.
See the API Keys guide for details on all options.

​
Managing the service

​
Check status

bolly status

​
Stop the service

bolly stop

​
Start / restart

bolly start
bolly restart

​
View logs

bolly logs
The bolly CLI wraps platform-specific service management (launchd on macOS, systemd on Linux) so you don’t have to remember the underlying commands.

​
Updating

To update Bolly to the latest version, run the install script again: 
curl -fsSL https://bollyai.dev/install.sh | bash
The script detects existing installations and performs an in-place upgrade while preserving your config and data. See the full updating guide for the built-in update command and release channels.

​
Uninstalling

Run the uninstall script to remove Bolly: 
curl -fsSL https://bollyai.dev/uninstall.sh | bash
This stops the service, removes the binary and service files, and cleans up your PATH. See the full uninstall guide for options like keeping your data.

​
Next steps

Configuration

Customize personality, heartbeat, and memory settings.

API Keys

Learn about optional integrations like Google AI and ElevenLabs.