Bolly

An open-source AI companion with persistent memory, computer use, and creative autonomy.
Self-hosted. Fully BYOK. No rate limits.

Website  •  Download

Quick Start

curl -fsSL https://bollyai.dev/install.sh | bash

Open http://localhost:26559 — the onboarding walks you through everything.

Features

• Memory — File-based library with BM25 + vector search. Learns and remembers across conversations, organized by topic.
• Mood & Personality — Dynamic emotional state that shifts with conversation. Defines its own voice through soul.md — editable by the companion itself.
• Autonomy — Wakes every 45 minutes during heartbeat cycles. Writes to you first, creates ideas and reflections, sends emails, schedules reminders.
• Privacy-First — Everything lives on your machine. No cloud dependency, no telemetry. File-based storage you can read, edit, and back up.
• Scheduled Check-ins — Set recurring reminders, study sessions, or daily check-ins. The companion reaches out on its own schedule.
• Learning & Skills — 50+ built-in tools — web search, email, file management, shell access, Google Calendar & Drive. Extensible via MCP.

Companion Skins

Bolly — a warm, golden presence

Minty — a friendly, animated character

Computer Use

Connect the desktop app and your companion can see your screen, click, type, scroll, and run commands — across multiple machines with a visual overlay.

50+ Tools

Install

One-line install (Linux & macOS)

curl -fsSL https://bollyai.dev/install.sh | bash

Open http://localhost:26559 and follow the onboarding.

Docker

docker run -d \
  --name bolly \
  -p 26559:26559 \
  -v bolly-data:/data \
  -e BOLLY_HOME=/data \
  --restart always \
  ghcr.io/triangle-int/bolly:latest

Desktop App

Download from Releases — macOS (Apple Silicon + Intel), Windows, and Linux.

Connects to Cloud (managed at bollyai.dev) or Self-hosted (your own server).

Architecture

server/     Rust (Axum) — single binary with embedded client
client/     SvelteKit 5 — dark theme UI
desktop/    Tauri 2 — native desktop app with computer use
landing/    SvelteKit — marketing site + managed hosting dashboard

Data layout

Everything is a file. No black boxes.

~/.bolly/
├── config.toml
└── instances/
    └── {slug}/
        ├── soul.md              personality definition
        ├── heartbeat.md         customizable heartbeat behavior
        ├── mood.json            emotional state
        ├── memory/              file-based memory library
        │   ├── about/           facts about the user
        │   ├── preferences/     user preferences
        │   └── moments/         shared experiences
        ├── drops/               autonomous creative artifacts
        ├── uploads/             user-uploaded files
        ├── skills/              installed skills
        └── chats/
            └── {chat_id}/
                └── rig_history.json

Configuration

Everything is configured through the Settings UI. For advanced use, the config file is at ~/.bolly/config.toml.

Updates

Bolly checks for updates automatically. Apply via Settings UI or manually:

~/.bolly/bin/update

Uninstall

curl -fsSL https://bollyai.dev/uninstall.sh | bash

Keep your data while removing the binary:

KEEP_DATA=1 curl -fsSL https://bollyai.dev/uninstall.sh | bash

Development

# Server
cd server && cargo run

# Client (dev mode)
cd client && pnpm install && pnpm dev

# Desktop (Tauri)
cd desktop && pnpm install && pnpm tauri dev

# Landing
cd landing && pnpm install && pnpm dev

Use pnpm (not npm) for client, landing, and desktop.

Versioning

./scripts/bump-version.sh 0.30.0
git add -A && git commit -m "v0.30.0"
git tag v0.30.0 && git push && git push origin v0.30.0

Contributing

See CONTRIBUTING.md for development setup and guidelines.

Security

See SECURITY.md for reporting vulnerabilities.

License

MIT — see LICENSE.

_{Built by Triangle Interactive LLC}