# Chalie (chalie.ai)

> Chalie is an open-source, locally-run AI runtime with persistent memory, deterministic intent classification, and sandboxed tool execution. It runs entirely on your machine, works with any LLM provider, and keeps you in control of every consequential action.

## What Chalie Does

- **Persistent memory** across sessions using a 6-layer hierarchy: working memory, gists, facts, episodes, personal traits, and semantic concepts — each with configurable decay and reinforcement
- **Cognitive routing** via a deterministic mathematical router (~5ms, no extra LLM call) that classifies each interaction into RESPOND, ACT, CLARIFY, or ACKNOWLEDGE
- **Tool execution** inside sandboxed Docker containers with manifest-driven discovery and hot-reload (add embodiments without restarting)
- **Privacy-first**: runs entirely on your machine. No telemetry. No cloud database. All data stays local.
- **Multi-provider**: supports Ollama (local), OpenAI, Anthropic, and Google Gemini — switchable per job

## Pages

- Home: https://chalie.ai/
- Vision: https://chalie.ai/vision/
- How It Works: https://chalie.ai/how-it-works/
- Roadmap: https://chalie.ai/roadmap/
- Get Started: https://chalie.ai/get-started/
- Docs: https://chalie.ai/docs/
- Build Log: https://chalie.ai/build-log/
- Contribute: https://chalie.ai/contribute/
- Embodiments (plugin marketplace): https://chalie.ai/embodiments/

## Documentation


- [VISION](https://chalie.ai/docs/00-vision/)

- [QUICK START](https://chalie.ai/docs/01-quick-start/)

- [PROVIDERS SETUP](https://chalie.ai/docs/02-providers-setup/)

- [WEB INTERFACE](https://chalie.ai/docs/03-web-interface/)

- [ARCHITECTURE](https://chalie.ai/docs/04-architecture/)

- [TOOLS](https://chalie.ai/docs/09-tools/)

- [TESTING](https://chalie.ai/docs/12-testing/)

- [MESSAGE FLOW](https://chalie.ai/docs/13-message-flow/)

- [DEFAULT TOOLS](https://chalie.ai/docs/14-default-tools/)

- [INTERFACES](https://chalie.ai/docs/15-interfaces/)

- [AMBIENT AWARENESS](https://chalie.ai/docs/16-ambient-awareness/)

- [SIGNAL CONTRACT](https://chalie.ai/docs/18-signal-contract/)

- [FAQ](https://chalie.ai/docs/faq/)


## Build Log (recent)


- [AI Core Refactor: XML Markup & Tool Unification](https://chalie.ai/build-log/2026-04-28/) — Apr 28, 2026

- [Ability Framework Migration to Per-Processor Scope](https://chalie.ai/build-log/2026-04-27/) — Apr 27, 2026

- [ACT Visual Feedback & System Refinements](https://chalie.ai/build-log/2026-04-26/) — Apr 26, 2026

- [Subconscious Worker V0.5.0 Refinements](https://chalie.ai/build-log/2026-04-25/) — Apr 25, 2026

- [ONNX Session Enhancements & Voice Features](https://chalie.ai/build-log/2026-04-24/) — Apr 24, 2026

- [ModeGate Revamp and Chat Feature Completion](https://chalie.ai/build-log/2026-04-23/) — Apr 23, 2026

- [SES Daemon & Embedding Optimizations](https://chalie.ai/build-log/2026-04-22/) — Apr 22, 2026

- [Refining Tooling and Enhancing Personalization](https://chalie.ai/build-log/2026-04-21/) — Apr 21, 2026

- [Weather tool handles country-only location](https://chalie.ai/build-log/2026-04-20/) — Apr 20, 2026

- [AI Core Refactor: World State, Memory, and User Summary](https://chalie.ai/build-log/2026-04-19/) — Apr 19, 2026


## Quick Start

```bash
curl -fsSL https://chalie.ai/install | bash
```

Open http://localhost:8081/on-boarding/ in your browser to get started.

## Docker

```bash
docker run -d -p 8081:8081 -v ~/.chalie/data:/data chalieai/chalie
```

Published to Docker Hub (`chalieai/chalie`) with every release. Supports `linux/amd64` and `linux/arm64`.

## License

Apache 2.0 — see https://chalie.ai/contribute/ for contribution guidelines.