hope-agent

会记忆、能自主推进目标,动态编排多 Agent 的跨端桌面 AI 助手

hope-agent 是一个用 Rust 编写的跨端桌面 AI 助手,核心特点是具备长期记忆、自主推进目标的能力,并能动态编排多个 Agent 协作完成复杂任务。它解决了传统 AI 助手缺乏上下文延续性和任务主动性的问题,能记住用户偏好和历史交互,自动拆解并执行多步目标,同时支持动态调用不同 Agent 处理子任务。项目支持桌面端和 headless 部署(如 NAS 或云端),可灵活集成到各种环境。技术栈基于 Rust,性能高效,兼容 Anthropic、Gemini 等主流大模型。适合需要个性化、自动化 AI 助手的开发者或极客用户,用于日常任务管理、信息整理、自动化流程等场景。

开源 free 对话助手
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1627
维护状态 活跃
是否开源 是
定价模式 free

项目数据

分类对话助手
开发团队shiwenwen
所属国家
官网地址
定价模式free
价格说明开源项目,MIT 许可证,完全免费,可自行部署使用。
访问状态
是否开源是
开源协议MIT
主要语言Rust
技术栈/模型agent,ai,ai-assistant,anthropic,chatbot,claude,claw,codex,cross-device,desktop-app,gemini,handoff,harness,hermes-agent,llm,local-ai,mcp,openai,openclaw,personal
GitHub 星标★ 1627
30天Star增速
HF 下载量
上线时间2026-03-13 00:00:00
最近更新2026-09-23 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数4

使用教程

难度:入门 约 10 分钟 部署方式:Docker 6 步

环境要求

  • 已安装 Docker(能执行 docker run)
  • 可访问 ghcr.io 拉取镜像,或使用官方镜像站下载安装包
  • 宿主机空闲端口 8420(官方示例默认端口)
  • 浏览器用于访问 Web GUI 完成首次向导

安装与启动步骤

  1. 1启动容器

    用官方镜像在后台启动服务,映射端口 8420 并挂载数据卷 hope-data,数据持久化到 /data

    docker run -d 
      --name hope-agent 
      -p 127.0.0.1:8420:8420 
      -v hope-data:/data 
      ghcr.io/shiwenwen/hope-agent:latest
  2. 2打开 Web GUI

    容器跑起来后,在浏览器访问本机 8420 端口,即打开内嵌的 React Web 界面

  3. 3完成首次向导

    按 Onboarding 向导演操作:选 Provider 模板,填 API Key,或用 Codex OAuth 登录,然后开聊

  4. 4开放局域网访问

    若要手机或另一台电脑访问,先在设置→服务器里设置 API Key,再把监听地址改为 0.0.0.0:8420

  5. 5重启并远程访问

    改完监听地址后重启服务,在其它设备浏览器访问 http://<运行 Hope Agent 的设备 IP>:8420

  6. 6常驻与开机自启

    无 GUI 守护进程模式可用 server start 子命令启动,server install 可注册为 launchd / systemd 开机自启

关键配置

配置项必填说明示例
Provider API Key是首次启动向导中填写,用于对接 Anthropic、Gemini 等大模型sk-xxxxxxxx
监听地址否默认仅本机可访问;改为 0.0.0.0:8420 后可被局域网内其它设备访问0.0.0.0:8420
端口否官方 docker run 示例映射并使用的端口,浏览器访问也用它8420
数据卷否挂载到容器 /data,用于持久化配置、会话与记忆hope-data:/data

如何确认成功

浏览器打开 http://127.0.0.1:8420 能看到完整 Web GUI,并进入 Onboarding 向导配置 Provider 即为成功。

常见问题

Q:访问不了 GitHub 下载安装包怎么办?

A:所有安装包同时镜像在 https://repo.hopeagent.ai/download/latest/,历史版本按 /download/v<版本>/ 保留,桌面自动更新也优先走该镜像。

Q:怎么从手机或另一台电脑访问?

A:在「设置 → 服务器」中设置 API Key,把监听地址改为 0.0.0.0:8420,重启后访问 http://<设备IP>:8420。

Q:怎么升级?

A:应用内「设置 → 关于」检查更新并一键安装,或直接在对话里说「升级」「检查更新」。

Q:镜像支持哪些架构?

A:官方镜像覆盖 linux/amd64 与 linux/arm64,含 Apple Silicon 和树莓派,随每次 Release Tag 自动构建。

注意事项

  • 不要在没有鉴权的情况下把 8420 端口暴露到局域网或公网;公网使用请前置 HTTPS 反向代理。
  • 配置、会话、记忆全部落在 ~/.hope-agent/ 下,Docker 场景请确保数据卷持久化。
  • Docker compose、配合 Ollama 本地 LLM、反向代理与 TLS、升级流程见 docs/deployment/docker.md。
  • 桌面端支持 macOS,Linux / Windows 为实验性;自动更新下载的安装包经内置公钥验签,手动下载的安装包不经这道验签。

核心亮点

  • 长期记忆机制,跨会话保持上下文,个性化体验更佳
  • 自主目标拆解与执行,减少人工干预,提升自动化效率
  • 动态多 Agent 编排,灵活应对复杂任务,扩展性强

不足之处

  • 项目处于成长早期,文档和社区生态待观察
  • Rust 技术栈对非 Rust 开发者有一定上手门槛

适用场景

  • 个人日常任务自动化管理,如邮件整理、日程安排
  • 开发者环境下的代码辅助、文档生成与信息检索
  • NAS 或云端部署,提供常驻的智能助手服务

替代项目

Open Interpreter、AutoGPT、CrewAI

项目介绍

hope-agent 是智能体领域的开源项目,由 shiwenwen 开发,是 2026 年新上线的项目。

在全站 13,090 个收录项目中,它的 GitHub 星标数(1,627)位列前 30%,在智能体分类中处于中上游。

近 42 天,它的 GitHub 星标从 1,406 增加到 1,627,净增 221。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-23。MIT 许可证,完全免费,可自行部署使用。

它主要面向的使用场景是:个人日常任务自动化管理,如邮件整理、日程安排。同类可对比的替代方案包括 Open Interpreter、AutoGPT、CrewAI。

上一篇:TuyaOpen

下一篇:poco-claw

同类项目推荐

xinchao-dynamic-mind 开源

给 AI 装上疲惫和欲望,让交互更真实

独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。

★ 199 2026-08-09
deepseek-harness 开源

把 AI 能力拆成乐高积木,拼出你的专属智能体。

DeepSeek Harness: Everything is a Plugin.

★ 233327 2026-08-15
AutoGPT 开源

开箱即用的 AI 员工,交代任务就自己干完

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···

★ 187492 2026-08-09
EvoAgentX 开源

让 AI 智能体自己迭代变强,越用越聪明

EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents

★ 3351 2026-09-12