It thinks while you're not looking.
An open-source personal AI that runs on your own machine β it remembers what matters, works while you're away, and asks before it acts.
curl -fsSL https://chalie.ai/install | bash
chalie # β http://localhost:31025Beta β on purpose. The bar is software you'd trust with your own life's admin, and it isn't all the way there yet. Hit a sharp edge? Open an issue β we respond fast.
Most AI tools forget you the moment you close the tab. Chalie runs on your own machine as a reasoning engine that keeps working while you step away: it remembers what matters and lets the rest go, and acts only behind an Allow / Ask / Deny policy spanning you, its own background work, and other agents. One SQLite file, credentials encrypted at rest, zero telemetry, encrypted whole-instance backup β no Redis, no Postgres, no queue, just one Python process.
| π§ Self-managing memory | A background pass distills conversation into durable facts and remembered moments β recalled automatically, never something you save by hand. |
| π― Goals & proactive research | Spots goals from casual mentions; researches topics in the background before you ask. |
| π Vision | Reads photos, screenshots, and scans β and indexes them so you can find an image by what's in it. |
| π Real web browsing | Drives a live browser: clicks, fills forms, scrolls, and inspects its own screenshots. |
| π MCP, in and out | Connects to remote MCP servers and exposes its own tools to other agents. |
| π¬ Email, calendar, contacts | IMAP, CalDAV, CardDAV β the accounts you already have. |
| π Scheduler | Natural-language recurring jobs. |
| π§° Files, shell & code | Searches files, runs guarded shell commands, and delegates coding tasks to an agent that writes and runs TypeScript in its own persistent, sandboxed workspace. |
| π Voice, fully local | Moonshine STT + Kokoro TTS, both ONNX. No cloud transcription, ever. |
| πΎ Backup & restore | Snapshot the whole instance to one file, optionally AES-256 encrypted. |
We ran ten models β frontier and open-weight β through the same battery of real tasks and scored how well each drives Chalie. A 31B open model you can run under your desk landed in the front pack, ahead of a 550B one. Size wasn't the story; the chassis was. β Read the benchmark
Fastest start β the wizard picks your provider on first boot:
curl -fsSL https://chalie.ai/install | bash
chalie # β http://localhost:31025 Β· Anthropic, Gemini, OpenAI, +17 more, or any OpenAI-compatible hostFully local with Ollama β nothing leaves your network:
ollama pull gemma4:31b # the open model that placed in the benchmark's front packFrom source:
git clone https://github.com/chalie-ai/chalie.git && cd chalie
uv pip install --system -e backend/ # all dependencies, voice (TTS/STT/VAD) included Β· Python 3.11+
./run.sh # β http://localhost:31025/on-boarding/Full walkthrough β chalie.ai/guide/installation.
| Platform | Status |
|---|---|
| macOS β Apple Silicon | Supported. Intel Macs are not: onnxruntime no longer publishes wheels for them. |
| Linux β apt (amd64/arm64) | Supported. Verified on Debian 12 and Ubuntu 24.04. |
| Linux β dnf (amd64/arm64) | Supported. Verified on Fedora 40 and 41. |
| Anything else | The installer refuses outright rather than leaving you a half-installed instance. Docker runs anywhere β installation guide. |
Every supported platform is re-proved on each merge to main. installer/verify runs the real installer on a pristine machine, boots Chalie, and passes only once readiness, the web interface, Chromium, a Kokoro β Moonshine voice round trip, and Deno all check out.
What the runtime itself needs β a model's own requirements are separate:
| Python 3.11+ | Already installed. The installer checks for it and deliberately never installs it, so distributions shipping something older β Ubuntu 22.04 (3.10), AlmaLinux 9 (3.9) β are refused until you supply one. |
Root or sudo |
Linux only, for the system build packages and the CLI. macOS needs neither. |
| ~2 GB RAM | Resident set measured at 1.5β1.7 GB once the voice and embedding models have warmed up. Verified on a 4 GB machine; below that is untested. |
| ~3 GB disk | The Python virtualenv and native wheels, the Chromium build Playwright downloads, the local voice models, and Deno. |
| Port 31025 | The default; chalie --port=9000 moves it. |
One Python process. Flask + flask-sock WebSocket. SQLite with sqlite-vec and FTS5 for semantic + lexical recall. Vanilla ES6 modules on the frontend β no build step. The whole cognitive runtime β memory, goals, scheduler, voice β runs as daemon threads inside that one process, and different cognitive functions can use different models.
Curious? β Architecture & internals Β· Schema
chalie # start
chalie --port=9000 # custom port
chalie stop # stop the daemon
chalie update # update to latest
chalie logs # tail the log- Judgment over activity. Fewer high-confidence actions beat many low-confidence ones.
- Restraint builds trust. Every token, notification, and action earns its place.
- Continuity is intelligence. The persistent runtime β not any single response β is the product.
- Constraints are features. Forgetting on purpose, hard limits, and token budgets are what make wisdom emerge.
Full product compass and design rationale live at chalie.ai/docs.
Full documentation lives at chalie.ai.
| π Guide | Setup, providers, and day-to-day usage. |
| π Docs | Technical reference and architecture. |
| π€ Contributing | How to get involved and ship a PR. |
chalie.ai Β· Releases Β· Blog Β· X Β· Reddit
PRs welcome. Start with the contributor handbook β vision, principles, and mechanics in one index β or open an issue. Found a security issue? Read SECURITY.md.
Apache 2.0 β use it, fork it, ship it.


