# 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. The full text of every guide page is available in one file: https://chalie.ai/llms-full.txt ## What Chalie Does - **Persistent memory** across sessions: a running transcript, episodic memory that consolidates over time, and a decaying key-value graph with per-type lifespans. Memory forgets on purpose so only what matters survives. - **ACT loop** — each turn the LLM decides whether to respond directly, call a Skill, or both, then loops until the task is complete. No separate routing step. - **Tool execution** in a restricted sandbox with manifest-driven discovery and hot-reload (add Skills 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/ - Guide: https://chalie.ai/guide/ - Docs: https://chalie.ai/docs/ - Build Log: https://chalie.ai/build-log/ - Contribute: https://chalie.ai/contribute/ - Abilities — built-in abilities and capabilities: https://chalie.ai/abilities/ ## User Guide - [Connect to MCP Servers](https://chalie.ai/guide/mcp/): Give Chalie new abilities by connecting it to external MCP servers — their tools become Chalie's tools. - [Installation](https://chalie.ai/guide/installation/): Get Chalie running in minutes — install, pick a model, and go. Works with Ollama, OpenAI, Anthropic, and Gemini. - [Agent-to-Agent](https://chalie.ai/guide/agent-to-agent/): Let your AI tools talk to Chalie — ask questions, share context, and coordinate work. - [Agent-to-Agent Setup](https://chalie.ai/guide/agent-to-agent/setup/): Connect your AI tools to Chalie's MCP server. - [Using Agent-to-Agent](https://chalie.ai/guide/agent-to-agent/usage/): Practical examples of how your AI tools can work with Chalie. - [Browser](https://chalie.ai/guide/browser/): Ask Chalie to browse the web, interact with pages, fill forms, and capture screenshots. - [Calendar](https://chalie.ai/guide/calendar/): Check your schedule, find free time, and manage events through natural conversation. - [Calendar Setup](https://chalie.ai/guide/calendar/setup/): How Chalie gets access to your calendar. - [Using Calendar](https://chalie.ai/guide/calendar/usage/): Check your schedule, find free time, and manage events. - [Code & Terminal](https://chalie.ai/guide/code/): Delegate coding tasks to an agent with its own file workspace, and run shell commands, right from the conversation. - [Contacts](https://chalie.ai/guide/contacts/): Look up contact details from your personal address book through natural conversation. - [Contacts Setup](https://chalie.ai/guide/contacts/setup/): How Chalie gets access to your address book. - [Using Contacts](https://chalie.ai/guide/contacts/usage/): Look up contact details and use them across Chalie's capabilities. - [Documents](https://chalie.ai/guide/documents/): Create, search, and manage personal notes and documents through conversation. - [Email](https://chalie.ai/guide/email/): Read, search, and send emails through Chalie using natural language. - [Email Setup](https://chalie.ai/guide/email/setup/): Connect your email account to Chalie with your address and an app password. - [Using Email](https://chalie.ai/guide/email/usage/): Read, search, reply, and send emails through Chalie. - [Files](https://chalie.ai/guide/files/): Read, write, create, move, and search files on your device through conversation. - [Getting Started](https://chalie.ai/guide/getting-started/): Learn the basics of Chalie and how to get the most out of your AI assistant. - [Provider Setup](https://chalie.ai/guide/getting-started/providers/): Connect Chalie to an LLM provider — Ollama, Anthropic, OpenAI, Gemini, OpenRouter, or any OpenAI-compatible service. - [Threads](https://chalie.ai/guide/threads/): Branch any answer into its own focused conversation, without losing the thread of what you were doing. - [Lists](https://chalie.ai/guide/lists/): Create and manage lists for shopping, tasks, ideas, and anything else you want to track. - [Memory](https://chalie.ai/guide/memory/): Teach Chalie things about you so it can be more helpful in every conversation. - [News](https://chalie.ai/guide/news/): Get the latest news headlines and stories on any topic you care about. - [Places](https://chalie.ai/guide/places/): Save named locations so Chalie can use them in directions, scheduling, and local searches. - [Policies](https://chalie.ai/guide/policies/): Control what Chalie can do on its own and what requires your approval, across every context. - [Programming Docs](https://chalie.ai/guide/programming-docs/): Look up official documentation for 23 languages and frameworks without leaving the conversation. - [Scheduling](https://chalie.ai/guide/scheduling/): Set up recurring tasks, daily briefings, and automated actions that run on a schedule. - [Skills](https://chalie.ai/guide/skills/): Teach Chalie new procedures and workflows so it handles complex tasks the way you want. - [Smart Home Setup](https://chalie.ai/guide/smart-home/setup/): Connect your home automation platform to Chalie. - [Using Smart Home](https://chalie.ai/guide/smart-home/usage/): Control your home devices and create routines through conversation. - [Smart Home](https://chalie.ai/guide/smart-home/): Control your smart home devices through natural conversation with Chalie. - [Timers](https://chalie.ai/guide/timers/): Set timers and reminders for cooking, workouts, deadlines, and anything time-sensitive. - [Vision](https://chalie.ai/guide/vision/): Show Chalie an image and ask questions about what it sees. - [External Agents (MCP)](https://chalie.ai/guide/external-agents/): Connect other AI agents to Chalie so they can ask questions, check your calendar, and coordinate on your behalf. - [Voice](https://chalie.ai/guide/voice/): Speak naturally with Chalie and hear its responses out loud. - [Weather](https://chalie.ai/guide/weather/): Get real-time weather forecasts and conditions for any location. - [Web Download](https://chalie.ai/guide/web-download/): Download files from the internet directly to your device through conversation. - [Web Search](https://chalie.ai/guide/search/): Search the web for real-time information, facts, and recommendations. ## Documentation - [Architecture Overview](https://chalie.ai/docs/architecture/): The runtime that turns a message into action — the core components, the provider layer, and how the pieces fit together. - [Memory & Cognition](https://chalie.ai/docs/memory-and-cognition/): How Chalie remembers and thinks between turns — the memory layers, recall at turn start, decay, and the background cognition loop. - [Message Flow](https://chalie.ai/docs/message-flow/): What happens between a user message and a reply — the turn lifecycle, the act loop, tool calls, and compaction. - [Threads](https://chalie.ai/docs/threads/): How a reply becomes a thread — the turn model, auto-generated labels, per-thread context and thinking mode, and the REST surface that drives it. - [Ambient Awareness](https://chalie.ai/docs/ambient-awareness/): How Chalie stays aware of the world — the world-state snapshot and the background services that feed it into every turn. - [Tools & Abilities](https://chalie.ai/docs/tools-and-abilities/): How Chalie acts — the ability model, tool discovery, the result contract, dispatch, and permission gating. - [Agent & MCP Integration](https://chalie.ai/docs/mcp-and-agents/): How other agents and tools connect to Chalie over MCP, and how Chalie talks to external MCP servers. ## Build Log (recent) - [The Data Graph Loses Its Dead Weight](https://chalie.ai/build-log/2026-08-09/) — Aug 9, 2026 - [Deleted the Memory System I Spent Days Building](https://chalie.ai/build-log/2026-08-08/) — Aug 8, 2026 - [Stopped Guessing How Much Room Is Left](https://chalie.ai/build-log/2026-08-07/) — Aug 7, 2026 - [One Registry Replaces Four Places to Remember](https://chalie.ai/build-log/2026-08-04/) — Aug 4, 2026 - [Read Gives Up URLs for Good](https://chalie.ai/build-log/2026-08-02/) — Aug 2, 2026 - [v1.2.0-beta, and Two Workflows That Were Already Broken](https://chalie.ai/build-log/2026-07-31/) — Jul 31, 2026 - [A Test That Cannot Fail Isn't a Test](https://chalie.ai/build-log/2026-07-30/) — Jul 30, 2026 - [The Context-Window Bug Had a Second Door](https://chalie.ai/build-log/2026-07-29/) — Jul 29, 2026 - [Every File Operation Gets Exactly One Owner](https://chalie.ai/build-log/2026-07-28/) — Jul 28, 2026 - [A Success Response Was Lying By Omission](https://chalie.ai/build-log/2026-07-27/) — Jul 27, 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:/root/.chalie/app/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. ## Optional > Built-in skill playbooks — detailed, secondary reference. Safe to skip in shorter contexts. - [A3 Problem Analysis](https://chalie.ai/guide/skills/built-in/a3-problem-analysis/): Comprehensive structured problem analysis covering background, root cause, countermeasures, and follow-up plan. - [Archive Management](https://chalie.ai/guide/skills/built-in/archive-management/): Create, extract, or inspect archive files including tarballs, zip files, and compressed archives for backup or file bundling. - [Board Deck Builder](https://chalie.ai/guide/skills/built-in/board-deck-builder/): Assembling board meeting decks, investor updates, and quarterly business reviews with narrative structure. - [Brain Dump Capture](https://chalie.ai/guide/skills/built-in/brain-dump-capture/): Organize a chaotic stream of mixed thoughts, tasks, and ideas into a clean actionable structure. - [Budget Tracker](https://chalie.ai/guide/skills/built-in/budget-tracker/): Track income and expenses, categorise spending, calculate variances against a budget, and surface overspend alerts. - [Cause and Effect Analysis](https://chalie.ai/guide/skills/built-in/cause-and-effect-analysis/): Systematically exploring all potential causes of a problem across multiple categories using a Fishbone (Ishikawa) structure. - [Certificate Checker](https://chalie.ai/guide/skills/built-in/certificate-checker/): Inspect SSL/TLS certificates on remote servers to check expiry dates, certificate chain validity, and issuer details. - [Cold Email Writer](https://chalie.ai/guide/skills/built-in/cold-email-writer/): Write or improve B2B cold outreach emails to unknown recipients and follow-up sequences that sound human and get replies. - [Competitive Teardown](https://chalie.ai/guide/skills/built-in/competitive-teardown/): Deep competitor analysis synthesizing pricing, reviews, job postings, and SEO signals into structured intelligence with feature matrices and battlecards. - [Compliance Readiness Check](https://chalie.ai/guide/skills/built-in/compliance-readiness-check/): Pressure-testing any compliance program before starting a new framework, planning an audit calendar, or preparing for certification stage 1. - [Concise Writing](https://chalie.ai/guide/skills/built-in/concise-writing/): Improving clarity and strength of any writing — emails, documents, messages, or notes — by applying established editing principles. - [Content Strategy Planner](https://chalie.ai/guide/skills/built-in/content-strategy-planner/): Plan what content to create — pillars, topic clusters, content calendar, and priority topics. - [Contract Reviewer](https://chalie.ai/guide/skills/built-in/contract-reviewer/): Review a contract or agreement, surface key clauses, flag unusual terms, and produce a plain-language summary. - [Contract Writer](https://chalie.ai/guide/skills/built-in/contract-writer/): Draft a freelance contract, project proposal, SOW, NDA, or MSA with jurisdiction-appropriate clauses. - [Daily Planner](https://chalie.ai/guide/skills/built-in/daily-planner/): Organise today's tasks, schedule time blocks, surface calendar conflicts, and set focus priorities for the day. - [Data Analysis](https://chalie.ai/guide/skills/built-in/data-analysis/): Analyse a dataset, calculate statistics, run comparisons, and produce charts or summary tables. - [Decision Log](https://chalie.ai/guide/skills/built-in/decision-log/): Recording, reviewing, and tracking key decisions and action items with owners and deadlines. - [Deep Research](https://chalie.ai/guide/skills/built-in/deep-research/): Produce a comprehensive, cited research report with multi-source evidence tracking, counter-review, and confidence markers. - [Disk Cleanup](https://chalie.ai/guide/skills/built-in/disk-cleanup/): Find large files, old files, or directories consuming excessive disk space and produce a cleanup plan to reclaim storage. - [Document Summariser](https://chalie.ai/guide/skills/built-in/document-summariser/): Read and summarise a long document, PDF, or webpage into key points, an executive summary, or a Q&A. - [Email Drafter](https://chalie.ai/guide/skills/built-in/email-drafter/): Draft a professional email — outreach, follow-up, internal update, negotiation, or difficult conversation. - [Email Sequence Designer](https://chalie.ai/guide/skills/built-in/email-sequence-designer/): Create a lifecycle email sequence — welcome, onboarding, nurture, re-engagement, or post-purchase drip. - [Entity Research](https://chalie.ai/guide/skills/built-in/entity-research/): Build a comprehensive dossier on a person, company, or organisation from public sources. - [EU AI Act Readiness](https://chalie.ai/guide/skills/built-in/eu-ai-act-readiness/): Assessing EU AI Act compliance for AI systems before EU deployment or during annual compliance refresh. - [Experiment Designer](https://chalie.ai/guide/skills/built-in/experiment-designer/): Planning product experiments, writing testable hypotheses, estimating sample sizes, prioritizing tests, and interpreting A/B outcomes. - [Experiment Tracker](https://chalie.ai/guide/skills/built-in/experiment-tracker/): Plan and track iterative experiments with goal, hypothesis, outcome, and learnings logged per attempt. - [Fact Checker](https://chalie.ai/guide/skills/built-in/fact-checker/): Verify specific factual claims in text against authoritative sources and produce a correction report. - [Financial Analysis](https://chalie.ai/guide/skills/built-in/financial-analysis/): Calculating financial ratios, running DCF valuations, analyzing budget variances, and building rolling forecasts. - [Fitness Routine Builder](https://chalie.ai/guide/skills/built-in/fitness-routine-builder/): Designing personalised workout routines and exercise plans. - [Five Whys Root Cause Analysis](https://chalie.ai/guide/skills/built-in/five-whys-root-cause-analysis/): Drilling from surface symptoms to root causes by iteratively asking why a problem occurred. - [GDPR Audit Prep](https://chalie.ai/guide/skills/built-in/gdpr-audit-prep/): Pressure-testing GDPR compliance before internal audits, DPA investigations, breach responses, or acquisition due diligence. - [General Research](https://chalie.ai/guide/skills/built-in/general-research/): Lightweight / single-thread research on any topic — breaks the question into sub-questions, searches multiple sources, and synthesizes a cited briefing. - [Idea Brainstorm](https://chalie.ai/guide/skills/built-in/idea-brainstorm/): Developing a rough idea into a well-formed plan or design through structured exploration, alternative generation, and collaborative refinement. - [Implementation Planner](https://chalie.ai/guide/skills/built-in/implementation-planner/): Produce a structured implementation plan with risk assessment for any bug, feature request, or improvement. - [Inbox Triage](https://chalie.ai/guide/skills/built-in/inbox-triage/): Process and organize recent emails — classify them, surface action items, and draft replies without sending. - [Internal Narrative Builder](https://chalie.ai/guide/skills/built-in/internal-narrative-builder/): Building and maintaining a coherent company story across employees, investors, customers, and candidates. - [International Expansion Planner](https://chalie.ai/guide/skills/built-in/international-expansion-planner/): Evaluating international markets, planning market entry, and building regional go-to-market strategy. - [Knowledge Base Builder](https://chalie.ai/guide/skills/built-in/knowledge-base-builder/): Read a set of URLs or documents and build a structured, searchable knowledge base saved as persistent documents. - [Market Sizing](https://chalie.ai/guide/skills/built-in/market-sizing/): Estimate the total addressable market (TAM), serviceable addressable market (SAM), and serviceable obtainable market (SOM) for a product or business idea. - [Marketing Copy](https://chalie.ai/guide/skills/built-in/marketing-copy/): Write conversion-focused marketing copy — landing pages, ad copy, product descriptions, or taglines. - [Media Conversion](https://chalie.ai/guide/skills/built-in/media-conversion/): Convert video or audio files between formats using ffmpeg, including re-encoding, resizing, extracting audio, creating GIFs, and adjusting quality settings. - [Meeting Analyzer](https://chalie.ai/guide/skills/built-in/meeting-analyzer/): Analyzing meeting transcripts to surface communication patterns, speaking dynamics, and actionable coaching feedback. - [Meeting Prep](https://chalie.ai/guide/skills/built-in/meeting-prep/): Prepare for an upcoming meeting — research attendees, surface context, draft an agenda, and set a follow-up reminder. - [Network Diagnostics](https://chalie.ai/guide/skills/built-in/network-diagnostics/): Diagnose network connectivity issues by checking if hosts are reachable, resolving DNS, inspecting network interfaces, and measuring response times. - [News Briefing](https://chalie.ai/guide/skills/built-in/news-briefing/): Produce a concise news briefing on one or more topics, companies, or industries for a specific time window. - [Partnership Architect](https://chalie.ai/guide/skills/built-in/partnership-architect/): Evaluating prospective partners, classifying partner tier, designing 90-day joint GTM plans, and modeling revshare economics. - [Performance Review Writing](https://chalie.ai/guide/skills/built-in/performance-review-writing/): Writing structured performance reviews for team members. - [Plan-Do-Check-Act (PDCA)](https://chalie.ai/guide/skills/built-in/plan-do-check-act-pdca/): Running iterative improvement cycles for any goal — personal habits, workflows, or recurring challenges — with measurable outcomes and structured learning. - [Pricing Strategy](https://chalie.ai/guide/skills/built-in/pricing-strategy/): Design SaaS pricing tiers, optimize existing pricing, or plan a price increase. - [Process Inspector](https://chalie.ai/guide/skills/built-in/process-inspector/): Find what process is using a specific port, identify resource-heavy processes, or investigate what is running on the system. - [Product Analytics](https://chalie.ai/guide/skills/built-in/product-analytics/): Defining product KPIs, building metric dashboards, running cohort analysis, and interpreting feature adoption trends. - [Product Audit](https://chalie.ai/guide/skills/built-in/product-audit/): Run a structured UX, messaging, or information-architecture audit on a product website or app. - [Product Discovery](https://chalie.ai/guide/skills/built-in/product-discovery/): Validating product opportunities, mapping assumptions, planning discovery sprints, and testing problem-solution fit before committing to build. - [Prompt Refiner](https://chalie.ai/guide/skills/built-in/prompt-refiner/): Transform a vague or loose prompt into a precise, structured specification with concrete conditions and measurable outcomes. - [RFP Response Planner](https://chalie.ai/guide/skills/built-in/rfp-response-planner/): Parsing RFPs and RFIs, mapping requirements to proof points, and producing a bid or no-bid recommendation. - [Roadmap Communicator](https://chalie.ai/guide/skills/built-in/roadmap-communicator/): Preparing roadmap narratives, release notes, changelogs, and stakeholder updates tailored for executives, engineering teams, and customers. - [SaaS Metrics Coach](https://chalie.ai/guide/skills/built-in/saas-metrics-coach/): Calculating and benchmarking SaaS health metrics including ARR, churn, LTV, CAC, and NRR with prioritized advice. - [Scenario War Room](https://chalie.ai/guide/skills/built-in/scenario-war-room/): Modeling cascading what-if scenarios across business functions when facing compound adversity or major strategic decisions. - [SEO Site Audit](https://chalie.ai/guide/skills/built-in/seo-site-audit/): Audit a website's SEO health — identify technical issues, on-page problems, and content gaps with a prioritized fix list. - [Smart Shopping](https://chalie.ai/guide/skills/built-in/smart-shopping/): Research a purchase — compare products, find the best price, check reviews, and recommend the best option. - [Social Media Strategy](https://chalie.ai/guide/skills/built-in/social-media-strategy/): Build or audit a social media strategy — platform selection, content pillars, posting cadence, and 90-day growth plan. - [Social Post Writer](https://chalie.ai/guide/skills/built-in/social-post-writer/): Draft social media posts (LinkedIn, Twitter/X, Instagram, or newsletter blurbs) for a product, announcement, or idea. - [Stock Data Lookup](https://chalie.ai/guide/skills/built-in/stock-data-lookup/): Retrieve current market data, financial statements, and analyst estimates for a publicly traded company. - [Strategic Alignment Check](https://chalie.ai/guide/skills/built-in/strategic-alignment-check/): Detecting misalignment between company goals and team execution, cascading strategy from board to IC level. - [System Health Check](https://chalie.ai/guide/skills/built-in/system-health-check/): Check overall system health including disk space, memory usage, CPU load, and running processes to diagnose performance issues or confirm the machine is healthy. - [Team Update Writer](https://chalie.ai/guide/skills/built-in/team-update-writer/): Drafting internal communications including 3P updates, company newsletters, status reports, and leadership updates. - [Technology Evaluation Framework](https://chalie.ai/guide/skills/built-in/technology-evaluation-framework/): Evaluating and comparing technology options for a specific use case. - [Topic Pulse](https://chalie.ai/guide/skills/built-in/topic-pulse/): Find out what people are saying about a topic right now — trends, sentiment, problems, or opportunities. - [Travel Planning](https://chalie.ai/guide/skills/built-in/travel-planning/): Plan a trip — destination research, itinerary, places to visit, weather check, and travel reminders. - [Twitter Thread Reader](https://chalie.ai/guide/skills/built-in/twitter-thread-reader/): Fetch, read, and summarise a tweet, Twitter/X thread, or X Article with full media and metadata. - [UX Research](https://chalie.ai/guide/skills/built-in/ux-research/): Generating user personas from research data, creating journey maps, planning usability tests, and synthesizing research findings. - [Video Content Strategy](https://chalie.ai/guide/skills/built-in/video-content-strategy/): Plan a video content strategy, write a video script, or build a YouTube or short-form video pipeline. - [Weekly Meal Planning](https://chalie.ai/guide/skills/built-in/weekly-meal-planning/): Planning meals for the week with shopping lists and prep schedules.