macOS / Linux
curl -fsSL https://yuralume.com/install.sh | bash
一行指令用 Docker 把整套服務跑起來。你的角色、記憶、對話都留在本機——自帶 LLM key，不計量、不回傳。
curl -fsSL https://yuralume.com/install.sh | bash
irm https://yuralume.com/install.ps1 | iex
從一行指令到建好角色開始聊，全程實錄，沒有加速也沒有剪接。
先裝 Docker，再執行上面那行。它會下載 image 並把所有服務跑起來。
開 http://127.0.0.1:8012 → Admin → Provider Keys 填一組 LLM key。
建一個角色就能開始聊。記憶、行程、主動訊息都會從這裡開始運作。
唯一的手動步驟：Yuralume 是 BYOK（自帶金鑰），所以聊天至少要一組 LLM provider。到 Admin → Provider Keys 填（OpenAI、OpenRouter、本地模型——相容的都行）；金鑰會加密存進你的資料庫，不會離開你的機器。內建的 fake provider 只是讓 app 能起來做煙霧測試，不會產生真正的對話。
macOS / Windows 用 Docker Desktop，Linux 用 Docker Engine。安裝器會檢查，沒裝就給你下載連結。
自帶即可——OpenAI、OpenRouter、本地 OpenAI 相容端點，相容的都行。裝完再填，不以明文存放。
放 image 加上你的資料。全部跑在容器裡，一行指令就能乾淨移除。
所有指令都在安裝目錄（~/yuralume）裡執行。重跑安裝器也安全——會升級 image 並保留你的密鑰與資料。
看 log
docker compose logs -f app
更新到最新版
docker compose pull && docker compose up -d
停止（保留資料）
docker compose down
重置——刪除所有本機資料
docker compose down -v
| 服務 | Port(localhost) | 用途 |
|---|---|---|
| app | 8012 | API + 網頁介面 |
| postgres | 5554 | 資料庫（named volume） |
| storage-local | 9012 | 物件儲存（./uploads） |
| whatsapp-sidecar | 32190 | 選用的 WhatsApp 管道 |
每個 port 都只綁 127.0.0.1。要在區網或 VPS 對外開放，請放在反向代理後面，並在 .env.container 設好 APP_BASE_URL。
| 變數 | 預設 | 意義 |
|---|---|---|
YURALUME_HOME | ~/yuralume | 安裝目錄 |
YURALUME_IMAGE_TAG | latest | 釘住某個發佈版本（例如 v0.1.0） |
YURALUME_INSTALL_BASE | https://yuralume.com | 從哪裡抓 bundle |
在跑那行指令之前，先在 shell 裡設定這些。
mkdir -p ~/yuralume/prompts/tuned ~/yuralume/uploads && cd ~/yuralume
curl -fsSL https://yuralume.com/selfhost/docker-compose.yml -o docker-compose.yml
curl -fsSL https://yuralume.com/selfhost/env.example -o .env.container
# 編輯 .env.container:把每個 __...__ token 換成一段長亂數
COMPOSE_PROJECT_NAME=yuralume docker compose pull
COMPOSE_PROJECT_NAME=yuralume docker compose up -dimage 已內建 baseline prompt pack，所以這是選用的。要覆寫的話，把 .txt 檔放進 prompts/tuned/，用跟 baseline 一樣的相對路徑（例如 chat/instructions_footer.txt），在 .env.container 設 YURALUME_PROMPT_PACK_DIR=/app/prompts/tuned，再跑 docker compose up -d。啟動 log 就會出現 Prompt pack overlay loaded 並顯示覆寫的範本數。
安裝器會停下並提示。開 Docker Desktop（等鯨魚圖示穩定），或 Linux 上 sudo systemctl start docker，再重跑。
第一次開機可能還在做 migration。用 docker compose ps 與 logs -f app 看；一次性的 migrate 會在 app 啟動前先跑。
有別的東西占了 8012/5554/9012/32190。把它停掉，或在 docker-compose.yml 改 host port 並同步 APP_BASE_URL。
重跑那行會原地升級。想全清的話，docker compose down -v 會移除所有容器與本機資料。
不用安裝就能玩 live demo，或進 Discord 找自架支援。