GaiaNet Node
在自己的机器上部署带知识库的去中心化 AI 节点服务。
- Star 数
- ★ 5k
- 最近更新
- 1 年前
- License
- GPL-3.0
- 主语言
- Shell
- FA 评分
- 44/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台
- 费用
- 免费，无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 希望在 Mac、Linux 或 Windows WSL 机器上运行自有 GaiaNet 节点的开发者。
- 不适合
- 需要图形界面或桌面应用、不愿使用命令行的用户
- 无法接受初始化时下载数 GB 模型与向量库文件、等待数分钟的团队
- 需要官方文档明确说明硬件要求与生产级访问控制的部署场景
- 源码审查
- 44/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
GaiaNet Node 是用于安装、初始化和运行自托管 GaiaNet 节点的命令行软件栈。安装脚本会安装 WasmEdge（含 wasi-nn_ggml 插件）、Qdrant、rag-api-server.wasm 和 dashboard。gaianet init 根据 config.json 下载聊天模型、嵌入模型及 Qdrant 向量数据库快照，并创建或导入集合。gaianet start 启动 Qdrant 和 LlamaEdge API Server，随后在控制台输出节点地址，可通过浏览器查看节点信息并与其 AI 助手聊天。节点可公开运行，也可使用 --local-only 限制为仅 localhost 可访问。
用户先运行安装脚本，再以 gaianet init 读取 $HOME/gaianet/config.json 或指定的远程配置。初始化会下载配置中指定的模型文件和向量数据库文件，启动 Qdrant，删除已有的 default 集合后下载并导入 Qdrant collection snapshot。gaianet start 会启动 Qdrant，并用 WasmEdge 运行 rag-api-server.wasm 形式的 LlamaEdge API Server；示例参数包含聊天模型、嵌入模型、提示词模板、Qdrant 集合和 Web UI。服务启动后输出 GaiaNet 节点 URL；用户可在浏览器打开该地址查看信息并聊天。gaianet config 可修改模型 URL、上下文长度、端口、系统提示词、RAG 提示词、检索阈值、域名和快照等字段，但修改后必须重新执行 gaianet init。
- 希望在 Mac、Linux 或 Windows WSL 机器上运行自有 GaiaNet 节点的开发者。
- 需要用指定模型和 Qdrant 知识库快照部署问答服务的团队原型项目。
- 想用
llama-3-8b-instruct_london预设配置部署含伦敦指南知识库节点的用户。 - 需要将节点仅限本机访问、通过
gaianet start --local-only进行测试的操作者。 - 需要通过
gaianet config更换聊天或嵌入模型 URL，并重新初始化节点的维护人员。
如何安装或部署这个 Agent？
在 Mac、Linux 或 Windows WSL 的 shell 中执行：
curl -sSfL 'https://github.com/GaiaNet-AI/gaianet-node/releases/latest/download/install.sh' | bash按终端提示设置环境路径（命令以 source 开头）。默认安装目录为 $HOME/gaianet；可改用：
curl -sSfL 'https://raw.githubusercontent.com/GaiaNet-AI/gaianet-node/main/install.sh' | bash -s -- --base $HOME/gaianet.alt随后执行 gaianet init 下载模型和向量数据库文件。提供的材料未列出任何必需凭据。
如何使用这个 Agent？
初始化默认节点：
gaianet init也可使用预设或自定义 config.json URL：
gaianet init --config https://raw.githubusercontent.com/GaiaNet-AI/node-configs/main/llama-3-8b-instruct_london/config.json启动节点：
gaianet start仅允许本机访问：
gaianet start --local-only终端会输出节点 URL，可在浏览器中打开并聊天。停止服务：
gaianet stop修改配置后必须再次运行 gaianet init。
这个 Agent 有哪些优点和局限？
- 提供从安装、模型与向量快照下载到服务启动的一组
gaianetCLI 命令。 - 安装流程明确部署 WasmEdge、Qdrant、
rag-api-server.wasm和 dashboard，而非只提供模型文件。 - 支持通过远程
config.json、模型 URL、提示词和 Qdrant 检索参数定制节点。 - 提供
--local-only，可在不暴露公共 GaiaNet URL 的情况下本地运行。
- 初始化需要下载大型模型文件和向量数据库文件，文档明确说明可能需要数分钟。
- 运行依赖 shell、网络、WasmEdge、Qdrant 和 LlamaEdge API Server，部署环境较轻量 CLI 工具更复杂。
- 更新
gaianet config中的字段后必须重新执行gaianet init。 - 提供的材料没有说明硬件需求、资源消耗、认证机制或生产级访问控制。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| GaiaNet Node 当前 | 44 · 缺口较多 | 命令行工具免费 | ★ 5k | 1 年前 | Shell | — |
| ODS 私有 AI 服务器 | 71 · 存在缺口 | 命令行工具免费 | ★ 7.8k | 2 天前 | Python | OpenAI API · Claude API |
| Sim AI 工作区 | 71 · 存在缺口 | 命令行工具免费版 + 付费版 | ★ 30k | 1 天前 | TypeScript | OpenAI API · Claude API |
| Hexabot | 53 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.2k | 2 天前 | TypeScript | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示安装脚本会下载并执行外部二进制文件（WasmEdge、Qdrant、frpc），但未提供校验和验证或签名验证，因此依赖安全仅部分处理。用户确认方面，安装和初始化命令会执行下载和启动服务，但未明确提示风险或征求同意。数据流透明度有限，README 描述了组件和端口，但未详细说明数据流向或隐私影响。敏感数据处理未明确说明，但节点可能处理用户查询和模型数据。外部影响包括启动本地服务和可能暴露公网地址，但未明确警告。回滚方面，提供了 uninstall.sh 但未详细说明回滚步骤。来源归属方面，发布者未验证，但仓库有明确的作者和社区链接。
自一致性方面，README 和 CI 工作流中的命令基本一致，但存在一些不一致，如安装脚本路径和版本。依赖可用性方面，依赖外部服务（Hugging Face、GitHub Releases），但未提供镜像或备用源。失败消息方面，CI 工作流中有日志输出，但用户文档中缺少详细的错误处理说明。
受众和场景方面，README 面向希望运行自己节点的用户，提供了多种配置选项。能力边界方面，文档说明了节点可以做什么，但未明确限制或安全边界。触发精度方面，命令和配置选项描述清晰，但未详细说明触发条件。环境适配方面，支持 Mac、Linux、Windows WSL，但未说明其他平台或硬件要求。
信息架构方面，README 结构清晰，有快速开始、安装、配置等章节。安装说明详细，提供了多种安装方式。命名稳定性方面，命令和配置项命名一致，但未提供版本历史。示例和 FAQ 方面，提供了示例命令和输出，但缺少 FAQ。已知限制方面，未明确列出。许可证方面，提供了 GPL-3.0 许可证文件。版本和变更日志方面，有 release 工作流但未提供变更日志。维护责任方面，有安全联系方式和社区链接，但未明确维护者。
输出可用性方面，节点启动后提供 API 和 Web UI，输出格式标准。边际价值方面，提供了去中心化 AI 节点部署的独特价值。成本效益方面，需要用户自行承担硬件和带宽成本，但未提供成本估算。
声明可追溯性方面，README 中的声明未提供具体证据或链接。跨来源佐证方面，CI 工作流提供了一些测试，但未独立验证。事实与推断分离方面，文档中未明确区分事实和推断。
- 安装脚本直接执行外部下载的二进制文件，未提供校验和或签名验证，存在供应链风险。
- 节点默认可能暴露公网地址，用户需注意隐私和安全。
- 发布者身份未验证，依赖社区信任。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
Major changes: - Upgrade to gaia-nexus 0.8.2 - Upgrade to cardea-agentic-search 0.10.0 - Upgrade to llama-api-server 0.27.0 - Update config.json - Update default chat model to Qwen3-4B-Q5_K_M.gguf and values of relevant configuration items - Remove context_window configuration item - Remove rag_policy configuration item - Remove rag_prompt configuration item Components - CLI Tool v0.6.0 - gaia-nexus v0.8.2 - llama-api-server v0.27.0 - WasmEdge v0.14.1 with ggml plugin b6399 - cardea-agentic-search v0.10.0 - qdrant v1.14.1 - dashboard v3.1 …在 GitHub 查看 ↗ -
0.5.4 GaiaNet-Node v0.5.4
发布说明摘录
Major changes: - Upgrade to llama-api-server 0.25.1 - Upgrade to ggml plugin b6097 - Upgrade to gaia-nexus 0.1.4 Components - CLI Tool v0.5.3 - gaia-nexus v0.1.4 - llama-api-server v0.25.1 - WasmEdge v0.14.1 with ggml plugin b6097 - qdrant v1.14.1 - dashboard v3.1 - vector v0.38.0 - frpc v0.1.3在 GitHub 查看 ↗ -
0.5.3 GaiaNet-Node v0.5.3
发布说明摘录
Major changes: - Upgrade to gaia-nexus 0.1.2 - Upgrade to llama-api-server 0.24.1 - Upgrade to ggml plugin b5896 - Upgrade to Qdrant 1.14.1 Components - CLI Tool v0.5.3 - gaia-nexus v0.1.2 - llama-api-server v0.24.1 - WasmEdge v0.14.1 with ggml plugin b5896 - qdrant v1.14.1 - dashboard v3.1 - vector v0.38.0 - frpc v0.1.3在 GitHub 查看 ↗
常见问题
需要账号或 API 密钥吗？
节点会下载什么？
gaianet init 会按 config.json 下载聊天模型、嵌入模型以及 Qdrant 向量数据库文件或快照。可以只在本机运行吗？
gaianet start --local-only 时，节点仅可经 localhost 访问，不会通过 GaiaNet 公共 URL 提供访问。修改模型或提示词后是否立即生效？
gaianet config 更新字段后，必须再次运行 gaianet init。