happier

环境要求

• macOS / Linux / Windows 电脑（安装 CLI 并用它运行 AI 编码会话）
• Node.js 与 npm（若要全局安装 @happier-dev/cli 或从源码构建）
• Yarn（从源码运行需先安装）
• iOS 或 Android 手机（可选，用于远程接管会话）

安装与启动步骤

1. 1安装 CLI（Mac/Linux）

   在电脑终端执行官方安装脚本，自动下载并管理 happier CLI，无需手动配置路径。

   curl -fsSL https://happier.dev/install | bash

   复制

2. 2安装 CLI（Windows）

   Windows 用户在 PowerShell 中执行对应的 PowerShell 安装脚本即可完成安装。

   iwr https://happier.dev/install.ps1 -useb | iex

   复制

3. 3改用 npm 安装 CLI

   如果你更希望用 npm 包而非安装脚本管理，可全局安装官方 npm 包。

   npm install -g @happier-dev/cli

   复制

4. 4下载移动端 App

   从 App Store 安装 happier 客户端；Play Store 版本处于私有测试，需先申请加入。

5. 5从源码克隆并装依赖

   安装 yarn 后克隆仓库进入目录，执行 yarn 安装全部依赖，脚本为仓库本地模式。

   npm i -g yarn
   git clone https://github.com/happier-dev/happier.git
   cd happier
   yarn

   复制

6. 6构建并启动本地栈

   构建产物后激活 CLI，再用 TUI 启动本地开发栈（服务端 + UI + 守护进程）。

   yarn build
   yarn cli:activate
   yarn tui

   复制

7. 7自托管 relay 服务

   在电脑上以系统服务方式安装自托管运行时，默认使用 SQLite 数据库。

   happier relay host install --mode system

   复制

关键配置

如何确认成功

源码方式运行 yarn tui 后出现日志与控制界面即启动成功；自托管后可用手机通过 Tailscale Serve 访问。

常见问题

注意事项

• 自托管运行时默认使用 SQLite 数据库，并以 stable / preview / dev 发布通道模型更新。
• 自托管方式需要你的电脑保持开机，移动端可通过 Tailscale Serve 访问。
• 从源码运行需先安装 yarn，仓库内 yarn 脚本运行在 repo-local 模式（每个 checkout 相互隔离）。
• Docker 部署方式 README 仅提供文档链接，未给出可直接执行的命令。