# 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)


- [System Refinements: Testing, Artifacts, and Docs](https://chalie.ai/build-log/2026-04-14/) — Apr 14, 2026

- [Refactor: Document Handling & Memory Pipeline](https://chalie.ai/build-log/2026-04-13/) — Apr 13, 2026

- [Major Memory & Tooling Overhaul](https://chalie.ai/build-log/2026-04-12/) — Apr 12, 2026

- [Major Refactor: Message Processing & System Prompting](https://chalie.ai/build-log/2026-04-11/) — Apr 11, 2026

- [MessageProcessor v2 Core Wiring Complete](https://chalie.ai/build-log/2026-04-10/) — Apr 10, 2026

- [AI Core Updates: DMN, Context, and Performance Boosts](https://chalie.ai/build-log/2026-04-09/) — Apr 9, 2026

- [Core AI Overhaul: Schema, Tools, and Performance Gains](https://chalie.ai/build-log/2026-04-08/) — Apr 8, 2026

- [Major Pipeline Overhaul & Prompt Architecture Refactor](https://chalie.ai/build-log/2026-04-07/) — Apr 7, 2026

- [Memory Pipeline Redesign & Knowledge Recall Boost](https://chalie.ai/build-log/2026-04-06/) — Apr 6, 2026

- [AI Assistant Updates: News, Tasks, and Prompts](https://chalie.ai/build-log/2026-04-05/) — Apr 5, 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.