项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 9628
技术标签
使用教程
环境要求
- 已安装 Node.js 与 npm（用于 npm install / npm run dev）
- 使用 Docker 方式时需已安装 Docker 与 Docker Compose
- 可访问 GitHub 与 npm 源以拉取代码和依赖
- 现代浏览器（用于打开本地开发服务器页面）
安装与启动步骤
-
1获取项目代码
把 Sphere 仓库克隆到本地，然后进入项目根目录。README 的后续命令都在项目根目录执行。
git clone https://github.com/unicity-sphere/sphere.git cd sphere -
2安装依赖
在项目根目录安装 package.json 中声明的全部依赖，首次执行耗时较长，请保持网络畅通。
npm install -
3配置环境变量
把示例环境变量文件复制为 .env，再按文件内注释填写真实配置。不要直接把密钥提交到仓库。
cp .env.example .env -
4启动开发服务器
运行 Vite 开发服务器，默认监听 http://localhost:5173，支持热更新。
npm run dev -
5访问本地页面
在浏览器打开开发服务器地址，确认钱包界面正常渲染；若被占用，以终端实际输出的端口为准。
-
6或用 Docker 启动
不想装依赖时，用仓库自带 compose 文件一键启动，容器暴露 3010 端口。
docker compose up
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
.env | 是 | 环境变量文件，由 .env.example 复制而来，需按注释填写后再启动 | cp .env.example .env |
如何确认成功
开发服务器终端出现监听提示后，浏览器打开 http://localhost:5173 能看到钱包界面即成功；Docker 方式访问 http://localhost:3010。
常见问题
Q：开发服务器端口是多少？
A：README 写明 npm run dev 启动在 http://localhost:5173；Docker 方式 docker compose up 运行在 3010 端口。
Q：不装 Node 能用吗？
A：可以，仓库提供 Docker 方式，执行 docker compose up 即可，无需在宿主机安装 Node 依赖。
Q：环境变量必须配吗？
A：README 的 Setup 中要求 cp .env.example .env 配置环境变量，建议先按示例文件说明填好再启动。
Q：外部 dApp 怎么连钱包？
A：Sphere 实现 ConnectHost，dApp 可用 iframe 模式或 popup 模式连接，用户按授权范围批准或拒绝。
Q：DM 里的 unicity-connect:// 链接是什么？
A：这是自定义协议，Sphere 会渲染成按钮，可选择在 Sphere 内以 iframe 打开或在新标签页浏览器打开。
注意事项
- README 未给出 Node.js 的具体版本要求，建议使用较新的 LTS 版本。
- 端口固定为开发 5173、Docker 3010，被占用时需先释放端口。
- .env 含敏感配置，请勿提交到版本库。
- Deep Link 协议会解析为 https://（本地调试时为 http://）。
核心亮点
- 集成钱包、聊天、市场与 AI 代理，一站式解决 Web3 日常需求
- 基于 Unicity 网络，提供原生多链支持与端到端加密通讯
- 活跃的成长中项目（近万星标），社区关注度高，迭代迅速
不足之处
- 项目仍处于早期，文档和生态工具尚待完善
- 依赖特定 Unicity 网络，可能限制对主流链的兼容性
适用场景
- 个人用户管理多链资产并与好友进行加密聊天
- 开发者基于其 AI 代理框架构建自动化交易机器人
- 创作者在去中心化市场发布和交易数字藏品
替代项目
MetaMask、Phantom、Coinbase Wallet
上一篇：big-AGI
同类项目推荐
Vigla
开源
统一管控多个AI编码代理，隔离执行、审计提交、一键回滚
Open-source mission control for coding agents. Run cross-vendor workers in isolated ···
moai-adk
开源
用 SPEC 驱动 Claude Code，多模型协作省成本
Agentic development harness for Claude Code — SPEC-driven plan/run/sync, TRUST 5 qu···
AgentLoom
开源
用 YAML 编排多智能体，安全可观测，失败能续跑。
Simple, flexible workflow orchestration for multi-agent AI apps, with YAML configura···
EvoCUA
开源
让AI学会操作电脑，自动搞定跨应用任务
EvoCUA: Evolving Computer Use Agent
philoagents-course
开源
用哲学思维拆解AI，边学边练Python，看懂技术背后的伦理与逻辑
When Philosophy meets AI
dat
开源
用大白话问数据，自动生成 SQL 出结果
Asking yours data in a natural language way through pre-modeling (data models and se···
Hello-Agents
开源
从零手写AI Agent系统，进阶生产级多智能体应用
Building AI Agent Systems from Scratch — A comprehensive, practical tutorial from f···
brigade
开源
让智能体用真实退出码和代码图谱自证工作，防止虚假交付。
Brigade Stack: run coding agents anywhere and keep one record of the work. Shared ta···
halofy
开源
给企业 AI Agent 加统一身份、审计与权限管控
Halofy is the open access and governance layer for AI agents across your organizatio···