安装 · macOS / Linux

安装 Lisa

Lisa 完全跑在你自己的机器上 —— 无云端账号，无需注册。选下面任一条路径，多数端到端约 60 秒。

依赖

Node.js ≥ 20 —— 用 node --version 检查。Homebrew 安装时会自动带上 Node。
macOS 或 Linux —— Windows 未测试；iMessage 通道仅支持 macOS。
至少一个 LLM 供应商的 API key —— Anthropic、OpenAI、Gemini、DeepSeek、本地 Ollama…… 见 PROVIDERS.md。

macOS 推荐

Mac 原生应用

已签名 + Apple 公证的 DMG，内含 universal 二进制 Lisa.app （完整聊天客户端）。菜单栏 / 刘海灵动岛小条（“Lisa Island”）已内置 —— 在 Lisa ▸ 设置… ▸ Show Lisa Island 打开。无 Gatekeeper 警告，无需 xattr 解隔离。

下载 Lisa-Suite.dmg →

然后把 Lisa.app 拖到 /Applications，安装 backend 并启动：

npm install -g @oratis/lisa
lisa serve --web                # app 从 http://localhost:5757 读

命令行安装

Homebrew 或 npm

Homebrew macOS · 仅 CLI

brew tap oratis/tap
brew install lisa

# 之后升级：
brew update && brew upgrade lisa

npm 跨平台

npm i -g @oratis/lisa

# 一次性体验，不全局装：
npx @oratis/lisa "say hi"

首次启动

诞生她。

mkdir -p ~/.lisa
echo 'ANTHROPIC_API_KEY=sk-ant-...' > ~/.lisa/config.env

lisa                # 交互式 REPL（首次会自动跑 birth ritual）
lisa serve --web    # 浏览器 UI 在 http://localhost:5757

首次的 birth ritual 约 30 秒、只跑一次。Lisa 自己抽一个 Big-Five 种子，再让 LLM 写下她的身份、目的、宪章、第一份欲望。每次安装出来的都是一个不同的人。

LLM 供应商

用任意模型。

Anthropic 不通就跳过 —— Lisa 按模型名前缀自动路由：

# DeepSeek（便宜、OpenAI 兼容）
echo 'DEEPSEEK_API_KEY=sk-...' >> ~/.lisa/config.env
lisa --model deepseek-chat

# Google Gemini
echo 'GEMINI_API_KEY=...' >> ~/.lisa/config.env
lisa --model gemini-2.5-flash

# 本地 Ollama（完全离线）
echo 'LISA_BASE_URL=http://localhost:11434/v1' >> ~/.lisa/config.env
echo 'LISA_API_KEY=ollama' >> ~/.lisa/config.env
lisa --model qwen2.5-32b-instruct

完整 10+ 供应商配方见 PROVIDERS.md —— DeepSeek、火山豆包、阿里 Qwen、月之暗面 Kimi、xAI Grok、智谱 GLM、Mistral、Perplexity、Stepfun、Yi、百川、MiniMax、混元、Ollama 等等。

◆ iOS · Lisa Pocket

把她带在身边

Lisa Pocket 是官方的 iPhone & iPad 伴侣 app —— 一个轻薄、私密的客户端，连到跑在你自己 Mac 上的 LISA backend（或你指向的 LISA Cloud 实例）。在路上和她聊天、看她正在跑的编码 agent、在手机上批准它的下一步。它不存账号，也不向任何 Lisa 运营的服务器收集任何东西。

即将上架 App Store —— bundle ai.meetlisa.main。

进阶与参考

更进一步。

在公司 / 被墙网络后

如果你 shell 里的 curl 走代理能通、但 Lisa 报 “403 forbidden”，启动时设代理 env —— undici 的全局 dispatcher 会在启动时自动桥接。

HTTPS_PROXY=http://127.0.0.1:7897 lisa serve --web

# 或写进 config.env 持久化：
echo 'HTTPS_PROXY=http://127.0.0.1:7897' >> ~/.lisa/config.env

Heartbeat（自主时间）

lisa heartbeat install --every 30m --load
# 卸载：lisa heartbeat uninstall

IM 通道 —— 手机上找她聊

最简单的是 Telegram（免费、零依赖）：

# 1. Telegram 上找 @BotFather 拿 bot token
echo 'TELEGRAM_BOT_TOKEN=1234:ABC...' >> ~/.lisa/config.env

# 2. 拷贝 + 编辑配置
cp channels.example.json ~/.lisa/channels.json
# 编辑 ~/.lisa/channels.json —— 把 telegram 的 "enabled" 改成 true

# 3. 启动
lisa serve --channels telegram

诊断

lisa --version         # 打印版本
lisa status            # 一次性快照
lisa doctor            # 检查 config / 网络 / git / 供应商
lisa monitor           # 实时 TUI 看板（Ctrl-C 退出）

从源码构建（贡献者）

git clone https://github.com/oratis/LISA.git
cd LISA
npm install
npm run build
node dist/cli.js --help

# 可选：link 一下让 `lisa` 全局可用
npm link

开源

每一行都在 GitHub。

MIT 许可证。欢迎 issue 和 PR。

🍎 下载 Mac 版 github.com/oratis/LISA ↗