CremindInstallation Overview
One-line install scripts for Linux, macOS, and Windows, and the two modes — Docker and native — they can set up.
Cremind is an open personal AI assistant you run yourself — a server, a desktop app, and a CLI in one package. It is early (version 0.0.1), open source, and community-driven. The fastest way to get it running is the one-line install script, which ends with the Setup Wizard open in your browser.
Cremind is MIT-licensed and under active development. Expect rough edges, and treat these docs as a living reference that tracks the installer source closely.
The one-liners
The install scripts detect Docker, ask which mode you want, render the right configuration, start the backend, and open the Setup Wizard. Pick the command for your platform.
Linux / macOS
curl -fsSL https://cremind.io/install.sh | bashYou can fetch the same script straight from GitHub instead:
curl -fsSL https://raw.githubusercontent.com/cremind-ai/cremind/main/install/install.sh | bashWindows (PowerShell)
iwr -useb https://cremind.io/install.ps1 | iexOr from GitHub:
iwr -useb https://raw.githubusercontent.com/cremind-ai/cremind/main/install/install.ps1 | iexTwo install modes
The scripts detect Docker and ask which mode you want. The choice changes where the agent runs and how it is isolated from your machine — it does not lock in your database or vector store, since those are now picked per-service in the Setup Wizard.
| Mode | What you get | When to pick it |
|---|---|---|
| Docker (recommended) | The agent runs inside a sandboxed, VNC-accessible XFCE desktop. You can watch what it does at http://<host>:6080/vnc.html. Postgres, Qdrant, or ChromaDB activate as sibling containers on demand from the wizard. | Anytime Docker is available — the agent is isolated from your host. |
| Native | A Python virtualenv at ~/.cremind/venv with cremind and SQLite. The agent shares your desktop and home directory. | Docker isn't available, or you want a minimal install without containers. |
See Docker mode and Native mode for the full step-by-step of each.
What happens after install
Both scripts finish the same way: the backend comes up, its /health check passes, and your browser opens to the Setup Wizard.
- The installer pulls images (Docker) or builds a venv (native), runs database migrations, and starts the server.
- Your browser opens automatically to
http://<host>:1515/#/setup— the Setup Wizard. - Pick an LLM provider, paste an API key, create your first profile, and you're chatting.
Prefer the terminal? cremind chat gives you a streamed REPL against the same profile, and cremind --help lists every command.
A note on the desktop app
If you don't want to manage a server at all, the Cremind App desktop client (Windows / macOS / Linux) bundles the agent and auto-updates from GitHub Releases — no separate install needed. Grab the prebuilt installer for your OS from the Releases page. These installation docs focus on the script-based server install.