Get Started

Running in minutes.

One command. Requires Python 3.9+. Everything installs to ~/.chalie/.

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

Checks dependencies, downloads the latest release, installs the CLI. ~2 minutes.

1. Install → 2. Pick an AI model → 3. Start talking

Start Chalie

chalie                 # Start → http://localhost:31025
chalie --port=9000     # Start on a custom port
chalie stop            # Stop
chalie restart         # Restart
chalie status          # Show running status
chalie update          # Update to latest release
chalie logs            # Follow the log

Complete onboarding

Open http://localhost:31025/on-boarding/ to create an account and configure your AI provider.

Or run with Docker

docker run -d -p 31025:31025 -v ~/.chalie/data:/root/.chalie/app/data chalieai/chalie

Published to Docker Hub for linux/amd64 and linux/arm64 with every release.

AI Provider

Choose your model

Ollama

Recommended

Free, private, runs entirely on your machine.

Install Ollama

Download from ollama.ai

Pull a model

ollama pull gemma4:31b

31B+ recommended for Chalie's reasoning loop.

In onboarding, select Ollama. Endpoint: http://localhost:11434

Configuration

That's it, really

Chalie auto-generates secrets and stores all configuration via the web UI. The only runtime option is the port:

chalie --port=9000     # default: 31025

Voice is installed automatically and appears when its dependencies are available. Pass --no-voice to skip it.

Security

Before going public

Enable HTTPS

Use a reverse proxy (nginx, Caddy, Traefik) to terminate TLS connections.

Use a strong password

Set during initial onboarding. Protects your data and conversations.

Restrict CORS

Update the CORS origin before exposing to a network.

For hackers

Run from source

Clone the repository

git clone https://github.com/chalie-ai/chalie.git && cd chalie

Install dependencies

python3 -m venv .venv && source .venv/bin/activate
pip install -r backend/requirements.txt

Run & test

python backend/run.py            # → http://localhost:31025
cd backend && pytest             # run tests