# Chalie (chalie.ai)

> Chalie is an open-source, locally-run AI runtime with persistent memory, an LLM-driven ACT loop, 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
- **ACT loop** — each turn the LLM decides whether to respond directly, call an ability (tool), or both, then loops until the task is complete. No separate routing step.
- **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/
- Guide: https://chalie.ai/guide/
- Build Log: https://chalie.ai/build-log/
- Contribute: https://chalie.ai/contribute/
- Embodiments — built-in skills and capabilities: https://chalie.ai/embodiments/

## User Guide


- [Agent-to-Agent](https://chalie.ai/guide/agent-to-agent/)

- [Agent-to-Agent Setup](https://chalie.ai/guide/agent-to-agent/setup/)

- [Using Agent-to-Agent](https://chalie.ai/guide/agent-to-agent/usage/)

- [Browser](https://chalie.ai/guide/browser/)

- [Calendar](https://chalie.ai/guide/calendar/)

- [Calendar Setup](https://chalie.ai/guide/calendar/setup/)

- [Using Calendar](https://chalie.ai/guide/calendar/usage/)

- [Contacts](https://chalie.ai/guide/contacts/)

- [Contacts Setup](https://chalie.ai/guide/contacts/setup/)

- [Using Contacts](https://chalie.ai/guide/contacts/usage/)

- [Documents](https://chalie.ai/guide/documents/)

- [Email](https://chalie.ai/guide/email/)

- [Email Setup](https://chalie.ai/guide/email/setup/)

- [Using Email](https://chalie.ai/guide/email/usage/)

- [Getting Started](https://chalie.ai/guide/getting-started/)

- [Provider Setup](https://chalie.ai/guide/getting-started/providers/)

- [Lists](https://chalie.ai/guide/lists/)

- [Memory](https://chalie.ai/guide/memory/)

- [News](https://chalie.ai/guide/news/)

- [Policies](https://chalie.ai/guide/policies/)

- [Scheduling](https://chalie.ai/guide/scheduling/)

- [Skills](https://chalie.ai/guide/skills/)

- [Smart Home Setup](https://chalie.ai/guide/smart-home/setup/)

- [Using Smart Home](https://chalie.ai/guide/smart-home/usage/)

- [Smart Home](https://chalie.ai/guide/smart-home/)

- [Timers](https://chalie.ai/guide/timers/)

- [Voice](https://chalie.ai/guide/voice/)

- [Weather](https://chalie.ai/guide/weather/)

- [Web Search](https://chalie.ai/guide/search/)


## Build Log (recent)


- [Gemini model listing fixed in /list-models](https://chalie.ai/build-log/2026-06-01/) — Jun 1, 2026

- [MCP Outbound Client, Vision Probe, and Cleanup Sprint](https://chalie.ai/build-log/2026-05-31/) — May 31, 2026

- [CompactionAbility, Memory as SYSTEM Tool, and Light Theme Shadows](https://chalie.ai/build-log/2026-05-30/) — May 30, 2026

- [v0.8.0 RC Polish: Lint, Theme, and Test Improvements](https://chalie.ai/build-log/2026-05-29/) — May 29, 2026

- [Document OCR, vault DEK safety, and code_eval fixes](https://chalie.ai/build-log/2026-05-28/) — May 28, 2026

- [Skills go subconscious, token table gains full coverage](https://chalie.ai/build-log/2026-05-27/) — May 27, 2026

- [ACT Loop, Subagent Actions & Error Surface](https://chalie.ai/build-log/2026-05-26/) — May 26, 2026

- [Voice on Demand, Bash Shell, and 435 Lines Lighter](https://chalie.ai/build-log/2026-05-25/) — May 25, 2026

- [Tool spec alignment, chmod ability, and find_tools enrichment](https://chalie.ai/build-log/2026-05-24/) — May 24, 2026

- [New Abilities and 62-Playbook Skill Library Arrive](https://chalie.ai/build-log/2026-05-23/) — May 23, 2026


## Quick Start

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

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

## Docker

```bash
docker run -d -p 31025:31025 -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.