项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5014
使用教程
环境要求
- Mac、Linux 或 Windows WSL 环境
- 已安装 curl（用于下载安装脚本）
- 可访问 GitHub、HuggingFace 等外网资源
- 磁盘空间充足：初始化会下载较大的模型文件和向量数据库文件
安装与启动步骤
-
1一键安装节点
运行官方安装脚本，安装默认节点软件栈（WasmEdge、Qdrant、rag-api-server 等），默认装到 $HOME/gaianet。
curl -sSfL 'https://github.com/GaiaNet-AI/gaianet-node/releases/latest/download/install.sh' | bash -
2设置环境变量路径
安装后按屏幕提示执行以 source 开头的命令，把 gaianet 命令加入当前 shell 的环境路径。
-
3初始化节点
下载 $HOME/gaianet/config.json 中指定的模型与向量数据库文件，文件较大可能耗时几分钟，请耐心等待。
gaianet init -
4启动节点
启动 GaiaNet 节点服务，控制台会打印官方节点地址。
gaianet start -
5访问并与 AI 对话
用浏览器打开控制台输出的节点地址（形如 https://0xf6...us.gaianet.network），查看节点信息并与该节点上的 AI 代理聊天。
-
6停止节点
需要关闭节点服务时运行 stop 子命令即可。
gaianet stop -
7可选：安装到其他目录
通过 --base 参数指定自定义安装目录，例如 $HOME/gaianet.alt。
curl -sSfL 'https://raw.githubusercontent.com/GaiaNet-AI/gaianet-node/main/install.sh' | bash -s -- --base $HOME/gaianet.alt
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
chat-url | 否 | 更新对话模型的下载地址 | https://huggingface.co/second-state/Llama-2-13B-Chat-GGUF/re |
chat-ctx-size | 否 | 更新对话模型的上下文长度 | 5120 |
embedding-url | 否 | 更新向量化（embedding）模型地址 | https://huggingface.co/second-state/All-MiniLM-L6-v2-Embeddi |
embedding-ctx-size | 否 | 更新 embedding 模型的上下文长度 | 384 |
port | 否 | 更新 LlamaEdge API Server 的端口 | 8080 |
base | 否 | 指定 GaiaNet 节点的基准目录 | /your/path/gaianet.alt |
如何确认成功
终端打印出形如 https://0xf639...us.gaianet.network 的节点地址，浏览器打开该地址能看到节点信息并与 AI 正常对话。
常见问题
Q：安装后提示找不到 gaianet 命令怎么办？
A：安装脚本结束时屏幕会提示设置环境路径，需要执行以 source 开头的命令使环境变量在当前终端生效，之后才能使用 gaianet 命令。
Q：gaianet init 很慢或卡住了？
A：这一步要下载模型文件和向量数据库文件，体积较大，官方说明可能需要几分钟，请保持网络畅通并耐心等待。
Q：修改了配置为什么不生效？
A：使用 gaianet config 更新配置后，必须重新运行 gaianet init 使配置生效。
Q：如何查看所有可配置项？
A：运行 gaianet config --help，可看到 chat-url、chat-ctx-size、port、system-prompt、rag-policy 等全部选项及说明。
Q：不想装在默认目录可以吗？
A：可以，安装时用 --base 参数指定目录，例如 bash -s -- --base $HOME/gaianet.alt。
注意事项
- 全流程在 Mac、Linux 或 Windows WSL 的终端中执行，Windows 原生 CMD/PowerShell 未在 README 中说明支持。
- 默认安装目录为 $HOME/gaianet，配置文件位于 $HOME/gaianet/config.json。
- 每次用 gaianet config 修改配置后都必须重新执行 gaianet init。
- 更多自定义与说明可参考官方文档 https://docs.gaianet.ai/ 以及中文版 README-cn.md。
核心亮点
- 一键脚本安装，降低部署门槛
- 基于以太坊，实现去中心化 AI 服务
- 支持多种 AI 代理框架，灵活扩展
不足之处
- 文档/社区待观察
- 依赖区块链，可能增加资源消耗
适用场景
- 个人开发者快速搭建 AI 聊天机器人
- 企业构建去中心化 AI 服务网络
- 区块链爱好者探索 AI 与 Web3 结合
替代项目
Ollama、LocalAI、PrivateGPT
上一篇：openagent
下一篇：DeepAnalyze
同类项目推荐
AntSK
开源
本地离线跑 AI 知识库，数据不出门就能智能问答
An AI knowledge base/agent built with .Net 9, AntBlazor, Semantic Kernel, and Kernel···
loong
开源
用 Rust 从零搭自己的 AI 智能体，轻量可改
Lightweight, clear, and fully extensible AI agent infrastructure — learn easily, cu···
OneBox
开源
一个 App 装下所有 AI 助手，安卓上直接跑 Agent
A free AI agent & toolbox for Android | 一站式安卓 AI 智能体 & 工具箱
MiroThinker
开源
深度研究一步到位，复杂问题秒出结论
MiroThinker is a deep research agent optimized for complex research and prediction t···
PromptCraft-Robotics
开源
用聊天指挥机器人，零代码操控无人机
Community for applying LLMs to robotics and a robot simulator with ChatGPT integrati···
OpenBiliClaw
开源
本地运行，跨平台主动帮你找爱看的内容，隐私不泄露。
本地私有、开源的自进化跨平台 AI 内容发现 Agent：先理解你，再主动从 B站、小红书、抖音···
Aivy-OS
开源
会记事、能动手的本地 AI 伙伴，常驻你的桌面
Your own digital life form — local AI companion with persistent memory, IDE workspa···
narrator-ai-cli-skill
开源
让 AI 一键生成专业电影解说，赋能视频创作
AI 解说大师 — Agent skill；封装 narrator-ai-cli 供 Claude/Codex 等工具调用
platypus
开源
把 AI 智能体部署到自家服务器，团队全天候协作
Self-hosted AI Agents for your whole team — on your infrastructure, your models, ar···