gaianet-node

一键部署你自己的去中心化 AI 代理节点

Gaianet-node 是一个去中心化 AI 代理服务的部署工具，旨在让用户轻松安装、运行和部署自己的 AI 代理节点。它解决了中心化 AI 服务的数据隐私和单点故障问题，通过以太坊等区块链技术实现去中心化的 AI 服务网络。核心能力包括一键部署节点、支持多种 AI 代理框架、提供聊天机器人接口，并集成了机器学习功能。项目使用 Shell 脚本简化操作，适合开发者快速搭建个人 AI 服务，同时参与 Hacktoberfest 鼓励社区贡献。

开源 unknown 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 5019

维护状态低维护

是否开源是

定价模式 unknown

项目数据

分类对话助手

开发团队GaiaNet-AI

所属国家

官网地址https://www.gaianet.ai

GitHubhttps://github.com/GaiaNet-AI/gaianet-node

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议GPL-3.0

主要语言Shell

技术栈/模型agentic-ai,agentic-framework,ai,ai-agents,chatbot,decentralized,ethereum,hacktoberfest,hacktoberfest-accepted,machine-learning,mcp,ml,web3

GitHub 星标★ 5019

30天Star增速

HF 下载量

上线时间2024-03-06 00:00:00

最近更新2026-09-18 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 15 分钟部署方式：本地安装 7 步

环境要求

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

项目介绍

gaianet-node 是智能体领域的开源项目，由 GaiaNet-AI 开发，2024 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（5,019）位列前 9%，在智能体分类的 2,517 个项目里位列前 9%。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-18。从国内网络环境看，当前已无法正常访问。

它主要面向的使用场景是：个人开发者快速搭建AI聊天机器人。同类可对比的替代方案包括 Ollama、LocalAI、PrivateGPT。

上一篇：openagent

下一篇：DeepAnalyze