# Chalie (chalie.ai)

> Chalie is an open-source, locally-run AI system with persistent memory, semantic reasoning, and tool execution. It keeps you in control while handling the cognitive overhead of your digital life.

## What Chalie Does

- **Persistent memory** across sessions using a 5-layer hierarchy: working memory, gists, facts, episodes, and concepts — each with 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 OAuth, manifest-driven discovery, and hot-reload
- **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


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

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

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

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

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

- [](https://chalie.ai/docs/05-WORKFLOW/)

- [](https://chalie.ai/docs/06-WORKERS/)

- [](https://chalie.ai/docs/07-COGNITIVE-ARCHITECTURE/)

- [](https://chalie.ai/docs/08-DATA-SCHEMAS/)

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

- [](https://chalie.ai/docs/10-CONTEXT-RELEVANCE/)

- [](https://chalie.ai/docs/11-MULTI-INSTANCE-SETUP/)

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

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


## Build Log (recent)


- [Opening the Black Box](https://chalie.ai/build-log/2026-02-28/) — Feb 28, 2026

- [Cognitive Reflexes and Structured Task Planning](https://chalie.ai/build-log/2026-02-27/) — Feb 27, 2026

- [Zero-Config Voice, Cognitive Legibility, and a Testing Blitz](https://chalie.ai/build-log/2026-02-26/) — Feb 26, 2026

- [Architecting Awareness and Fixing a Broken Build](https://chalie.ai/build-log/2026-02-25/) — Feb 25, 2026

- [Moments and Curiosity Threads](https://chalie.ai/build-log/2026-02-24/) — Feb 24, 2026

- [Meta-Automation and Adaptive Architecture](https://chalie.ai/build-log/2026-02-23/) — Feb 23, 2026

- [The Day of Many Fixes](https://chalie.ai/build-log/2026-02-22/) — Feb 22, 2026

- [Tool UI Fixes & Innate Skills](https://chalie.ai/build-log/2026-02-21/) — Feb 21, 2026

- [CI/CD Automation & Hot Tool Registration](https://chalie.ai/build-log/2026-02-20/) — Feb 20, 2026


## Quick Start

```bash
git clone https://github.com/chalie-ai/chalie.git
cd chalie
docker-compose build && docker-compose up -d
```

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

## License

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