hope-agent

---

Hope Agent 是一个本地优先、桌面优先，也能服务化常驻的个人 AI Agent。它像成熟的桌面软件一样打开即用，又真正具备 Agent 的行动力：理解长期上下文、调用工具完成工作，并在你离开后继续可靠地推进目标。

Hope Agent 很早就开始探索桌面 AI Agent。 在桌面 Agent 还很少见、Codex 尚处早期形态的阶段，我们就已经开始构建这个项目。我们一直专注于产品本身，而不是制造声量。随着桌面 AI Agent 逐渐成为热门方向，越来越多产品开始探索相似路径，也印证了我们最初的判断：AI 助手终将走出聊天框，成为可以长期托付工作的个人软件。

目录

• 核心能力
• 能力全景
• 快速开始
  • 下载安装
  • 自托管（Docker）
  • 开发者
• 运行模式
• 生态一览
• 项目结构
• 文档
• 贡献
• 社区
• 致谢
• Star History
• License

核心能力

能力全景

🎨 设计与知识

🧭 长期任务与自主执行

心智模型：Goal 定义最终结果，Workflow 负责一次具体执行，Loop 决定何时再次推进，Task 呈现当前进度，Mode 控制自主执行强度。它们可以组合，也可以独立使用。

🧠 记忆与成长

🛠 工具与连接

🌐 桌面、服务与跨端

🛡 安全与可靠性

更完整的版本变化请查看 CHANGELOG.md，实现细节见 docs/architecture/。

快速开始

下载安装

📦 各平台完整安装包列表：Releases

🌏 访问不了 GitHub？ 所有安装包同时镜像在 https://repo.hopeagent.ai/download/latest/（Cloudflare R2，与 apt / dnf 软件源同域名），下面每个手动安装入口都给了镜像直链。桌面应用的自动更新也优先走这个镜像，GitHub 作为兜底。历史版本按 https://repo.hopeagent.ai/download/v<版本>/ 长期保留。

macOS

Homebrew（推荐）

brew tap shiwenwen/hope-agent
brew install --cask hope-agent

已经手动装过 Hope Agent.app？在 brew install 后面加 --adopt（接管同版本现有应用，不重新下载）或 --force（强制重下覆盖）。

手动安装（DMG）

到 Releases 下载 Hope.Agent_*.dmg，拖到「应用程序」即可。镜像直链：Hope.Agent_aarch64.dmg。

若启动时提示"已损坏"或"无法验证开发者"，请在终端执行：

sudo xattr -cr /Applications/Hope\ Agent.app
sudo codesign --force --deep --sign - /Applications/Hope\ Agent.app

常规发布提供 Apple Silicon（arm64）原生构建。Intel Mac（x64）安装包由独立构建流程按需提供，请先确认目标版本的 Release 资产确有 x64 DMG；缺失时 Homebrew 和下载页不能提供该版本的 Intel 安装包。

启动方式

• 桌面 GUI：Launchpad / 应用程序文件夹（点 Hope Agent 图标），或终端 open -a "Hope Agent" / hope-agent
• 浏览器 Web GUI：打开桌面应用后访问 http://127.0.0.1:8420；也可以运行 hope-agent server start，只启动服务、不打开桌面窗口
• ACP（IDE 集成）：hope-agent acp

Windows

Scoop（推荐）

scoop bucket add hope-agent https://github.com/shiwenwen/scoop-hope-agent
scoop install hope-agent

手动安装（installer）

到 Releases 下载 Hope.Agent_*-setup.exe 双击安装。镜像直链：Hope.Agent_x64-setup.exe。Windows 端尚未完成充分测试，欢迎反馈问题。

若启动时提示"由于找不到 MSVCP140_1.dll，无法继续执行代码"或类似缺失 VCRUNTIME140.dll / MSVCP140.dll，请安装 Microsoft Visual C++ 2015–2022 运行库（x64）后重启应用。

当前仅 x64。

启动方式

• 桌面 GUI：Start 菜单点「Hope Agent」启动，或 PowerShell hope-agent
• 浏览器 Web GUI：打开桌面应用后访问 http://127.0.0.1:8420；也可以在 PowerShell / cmd 运行 hope-agent server start，只启动服务、不打开桌面窗口
• ACP（IDE 集成）：hope-agent acp

Linux

Arch Linux / Manjaro（AUR）

yay -S hope-agent-bin   # 或 paru / 任意 AUR helper

预编译二进制版（沿用 GitHub Release 的 .deb），不从源码编译。

Debian / Ubuntu（apt）

curl -fsSL https://repo.hopeagent.ai/pubkey.gpg | \
  sudo gpg --dearmor -o /usr/share/keyrings/hope-agent.gpg
echo "deb [signed-by=/usr/share/keyrings/hope-agent.gpg] https://repo.hopeagent.ai/apt stable main" | \
  sudo tee /etc/apt/sources.list.d/hope-agent.list
sudo apt update
sudo apt install hope-agent

Fedora / RHEL / CentOS（dnf / yum）

sudo curl -fsSL https://repo.hopeagent.ai/rpm/hope-agent.repo \
  -o /etc/yum.repos.d/hope-agent.repo
sudo dnf install hope-agent     # 或 sudo yum install hope-agent

历史命令 sudo dnf config-manager --add-repo … 在 dnf5（Fedora 41+）已经废弃，用上面的 curl 写法对 dnf4 / dnf5 / yum / zypper 都兼容。

openSUSE 用户：

sudo zypper addrepo https://repo.hopeagent.ai/rpm/hope-agent.repo
sudo zypper install hope-agent

手动安装（AppImage / deb / rpm）

到 Releases 下载（包名含架构后缀，按你的机器选 _amd64 / _arm64 或 .x86_64 / .aarch64）：

• AppImage：Hope.Agent_*.AppImage —— chmod +x 后直接运行。镜像：amd64 · aarch64