Run Lucid Cove on your computer

A private place for a team of agents — on hardware you already own — that can reach your phone, your laptop, and the people you invite. Not another chat tab. Something that stays.

YOU RUN IT

Self-host Lucid Cove

Free to run at home. Your machine, your data, your rules. The path below is the simple one.

↓ You're here
WE RUN IT

Hosted Lucid Cove

Same product, same software — we keep the machine running. Nothing to install.

See hosting →

The internet keeps asking why there isn’t a real consumer product with agents. A chat window that forgets you isn’t enough. Lucid Cove is a place you stand up once: agents with memory, files, and a steward, living on your computer, ready for your household or your work. If you can paste one line into Terminal and open a link in a browser, you can get there.

WATCH THE INSTALL

Prefer to follow along? This walkthrough covers the install, onboarding, and a look around Mission Control — about 45 minutes. Or skip to the steps below.

BEFORE YOU START

Install Docker Desktop and leave it running (Mac or Windows). That’s the only prep. The installer checks the rest and tells you plainly if something is missing. First run takes a few minutes and some free disk while Lucid Cove downloads what it needs.

1

Paste this in Terminal

Open Terminal on a Mac, or your command line with Docker on Windows (WSL is fine). Copy the whole line, paste it, press Return:

curl -fsSL https://raw.githubusercontent.com/LucidPrinciples/lucid-cove/main/install.sh | bash

It checks Docker, downloads Lucid Cove, builds your stack, and starts it. Leave the window open until it finishes — first run can take several minutes. That’s normal.

2

Open your claim link

When Lucid Cove is ready, the installer prints a claim link — a web address that looks like http://localhost:…/p/….

TERMINAL → BROWSER

Most terminals do not make that address clickable. That’s expected. Select the whole link with your mouse, copy it (⌘C on Mac, Ctrl+C on Windows), open Safari, Chrome, or Edge, paste into the address bar, and press Return.

On a Mac the installer often tries to open the page for you. If a browser window appears, skip the copy step. If nothing opens, use copy and paste — same link either way.

Do this first visit on the computer where you ran the install.

3

Bring Lucid Cove to life

The claim link opens setup in the browser — simple screens, no config files. This is where it stops feeling like software install and starts feeling like something of yours.

What you’ll actually do

  • Say who you are — your name and a unique @handle
  • Name your Lucid Cove — the home for this place (your household, shop, studio…)
  • Bring your personal agent to life — shape who shows up for you, then meet them. Lucid Cove gives a spark of intelligence so that first conversation can happen right away.

Every Lucid Cove also comes with a steward and a full team of specialized agents — builders, researchers, keepers of the house — ready when you are. You’re not bootstrapping a chatbot. You’re standing up a small team on a machine you control.

After that first spark, the rest is inside: connect phones and laptops, invite family or colleagues, add your own API key or a local model when you want deeper work. You already have help in the room.

What you walk away with

A private Lucid Cove on your computer. Agents that remember. Files and voice when you want them. A way for your other devices to reach the same place. Room for the people you trust.

This page is only the front door. Engineers who want internals can open the open-source repo. You don’t need that for the path above.

Rather not run a server?

Same Lucid Cove, none of the install. We provision it and keep it running — you name it and claim it. Ownership of your data matches self-hosting.

HOST IT FOR ME VIEW THE REPO

Open source. Code is Apache 2.0; Canon framework content is CC BY 4.0. Manual install and full technical guide: QUICKSTART.md in the repo.