Installation Methods
System Requirements
Minimum Hardware
- 2 CPU cores
- 2 GB RAM
- 500 MB disk space (plus storage for memory/drops)
- Internet connection (for LLM API calls)
Supported Platforms
- Linux: x86_64, aarch64 (Ubuntu 20.04+, Debian 11+, Fedora 36+, Arch)
- macOS: Apple Silicon (M1+, macOS 12+)
- Windows: x86_64 (Windows 10+, desktop app only)
- Docker: Any platform with Docker Engine 20+
Required API Keys
Bolly uses a BYOK (Bring Your Own Key) model. You need at minimum:See the API Keys guide for detailed setup instructions for each provider.
Data Directory
All Bolly data lives in~/.bolly/ by default (configurable via BOLLY_HOME environment variable):
What’s Next
Pick your installation method and follow the guide:One-Line Install
The fastest path — a single curl command.
Docker
Containerized deployment with persistent volumes.
Desktop App
Native app with computer use support.
From Source
Build everything from the repository.