vibedonate

vibedonate

软件包 · 设置 · 运行时接口 · 对比

vibedonate 是一项面向编码 Agent 用户的开源、可自托管计算共享实验。 您的硬件，由您选择加入，并按使用量计量。它在 Vibe Suite 中提供对等传输、捐赠控制和本地账本。 当前 CLI 网状网络运行的是 echo 存根；独立的 Ollama 运行器未连接到网状网络作业。

安装

npm install -g vibedonate

需要 Node.js 18 或更高版本。包含 TypeScript 声明和三个直接运行时依赖项。

运行首次本地检查

vibedonate status

全新安装时，输出会报告节点尚未启用。 无需凭据或环境变量。此命令不会启动任何共享。 CLI 会读取已导出的环境变量；不会加载 .env 文件。

如需选择加入传输演示，请在一个终端中运行此捐赠端：

vibedonate share --compute --idle 00:00-23:59 --cap 2M --pool allowlist:consumer --handle donor

在另一个终端中运行使用端：

vibedonate request "hello" --pool allowlist:consumer --handle consumer

在 UTC 时间窗口内存在可连接的对等节点时，使用端会打印 olleh。这是 echo 存根，并非 AI 推理。 按 Ctrl+C 停止捐赠端，然后运行 vibedonate stop 撤销已持久化的同意。

工作原理

share -> saved config + consent -> Hyperswarm pool discovery
                                      |
consumer prompt -> donor checks -> echo stub -> result + metering receipt

status / MCP preflight -> separate Ollama availability check
payment flags -> stub wallet + local payment ledger

公告包含句柄、池、计算等级和可选的支付条款。提示词和结果会通过已连接的对等链路传输。 不会公告原始使用量总计。本地文件默认存放在 ~/.vibedonate。

存在的原因

vibedonate 探索围绕闲置本地计算资源的选择加入式捐赠控制。 Petals 分发模型执行；Ray Serve 提供模型服务基础设施。 此软件包专注于同意、计划安排、接收方池和计量，并提供实验性的对等传输。

对比

于 2026-10-14 根据 Petals 研究论文和 Ray Serve 文档进行核查。

属性	vibedonate	Petals	Ray Serve
范围	捐赠控制和 echo 网状网络演示	协作式模型推理和微调	分布式模型服务
执行	默认网状网络使用 echo 存根	分布式模型区块	已部署的模型服务应用
接口	Node.js 库、CLI、Agent 预检	模型推理接口	Python 部署和推理 API

覆盖情况

集成或等级	状态	源码行为
Hyperswarm	已实现	同池对等节点发现及请求／结果传输
Ollama	独立运行器	检测可执行文件；调用 ollama run；未接入网状网络 CLI
Echo 网状网络模型	存根	反转提示词；每个默认作业记录 100 个令牌
USDC / x402 风格支付	存根	确定性钱包证明和本地账本；不进行结算
Base	脚手架	接受的支付链标签
Ethereum	脚手架	接受的支付链标签
Polygon	脚手架	接受的支付链标签
订阅共享	—	未发布此等级
API 额度路由	—	未发布此等级

有一个默认聊天运行器、一个默认 echo 网状网络模型和两个 MCP 工具。 源码检查和本地测试支持这些区分。未验证任何凭据、链上交易或公共网络服务保证。

常见用例

1. Node.js 开发者：通过导出的库测试同意状态和算力容量决策。
2. Hyperswarm 实验者：在同一池的节点之间交换回声任务。
3. Ollama 用户：在构建自定义集成前检查本地聊天运行器是否可用。
4. Agent 构建者：调用 MCP request_capacity，检查拟议的捐赠额度，而不执行任务。
5. Vibe Suite 用户：在自己的机器上检查哈希链式使用记录和支付记录。

功能

• 同意： share 授予 donate:compute；stop 会在持久化存储中撤销该权限。
• 计划： UTC 空闲时段和可配置的每日令牌上限。
• 接收方池： open、org:<id>,<member> 和 allowlist:<peers>。
• 计量： 本地哈希链式收据，并提供链验证方法。
• 支付： 可选价格元数据和模拟支付记录；默认任务免费。
• 套件钩子： 导出的捐赠生命周期钩子使用 vibe-core 事件和通知。

运行时接口

Node.js 包导出配置解析器、同意辅助函数、容量评估、计量、模拟支付和计算解析功能。

vibedonate share --compute --idle HH:MM-HH:MM --cap 2M --pool open
  [--handle name] [--price 0.001] [--chain base|ethereum|polygon]
vibedonate request "prompt" --pool open
  [--handle name] [--timeout milliseconds] [--pay 0.001]
vibedonate status
vibedonate stop
vibedonate wallet
vibedonate mcp
vibedonate --help / -h
vibedonate --version / -v

vibedonate mcp 会启动一个基于标准输入／输出的 Model Context Protocol（MCP）服务，且仅包含两个工具：

工具	行为
status	配置、同意状态、计算可用性、计划状态和总计
request_capacity	预检 { peer, tokens }；返回允许／拒绝决策，不执行推理，也不生成收据

交付与行为限制

CLI 捐赠方默认使用 createEchoModel()。安装 Ollama 不会将其替换为模型推理。 单独的本地运行时会记录容量收据；它不会执行提示词。 CLI 使用 stubWallet()。支付成功表示模拟证明通过，并不表示 USDC 已在 Base、Ethereum 或 Polygon 上转移。 节点授权会比较已公布的句柄。它不会验证组织成员身份，也不会将句柄绑定到可信身份。 CLI 活动检查默认认为“未忙碌”；捐赠方未接入自动机器空闲检测器。 正在运行的捐赠方会保留其初始配置和同意对象。使用 Ctrl+C 停止它；单独运行 stop 进程不会关闭它。 网格会在任务开始前检查当日总量是否低于上限；单个任务可能会超出剩余额度。 容量预检会严格检查请求是否符合限额。不要假设两条路径执行相同的边界检查。 发现过程默认持续 15 秒；每个尝试的捐赠方最多等待 6 秒。总耗时可能超过发现超时时间。 哈希链可以检测记录内容是否不一致；但无法阻止他人重写整个本地账本。

集成指南

• Ollama 运行器：安装 Ollama 并拉取 qwen2.5:7b；设置 VIBEDONATE_OLLAMA_MODEL 以选择其他已安装的模型。
• 独立状态目录：导出 VIBEDONATE_DIR，将状态目录改为 ~/.vibedonate 之外的位置。
• 演示池（不是访问控制）：在两个节点上使用相同的 allowlist:consumer 字符串，并在请求时使用 --handle consumer。任何公布匹配句柄的节点都会通过检查。
• 组织池：添加明确的成员，例如 org:team,alice；仅使用 org:team 不会授权任何成员。
• Agent 设置：配置 MCP 主机，通过标准输入／输出启动 vibedonate mcp。

状态

版本 0.4.3 为实验性版本，尚未达到 1.0。尚未发布公开案例研究。 尚未配置公开文档网站；本文档已包含完整的操作指南。 如需支持，请使用 GitHub issues；可能需要仓库访问权限。 如需贡献，请运行 npm ci、npm run typecheck、npm run build 和 npm test。

常见问题

哪些集成已经过验证？

vibedonate 有基于源码的节点传输功能，以及独立的 Ollama 运行器。本地测试无法证明公共节点或区块链结算功能可靠。

vibedonate 提供托管推理服务吗？

vibedonate 在你的硬件上运行。它不提供托管推理池、可用性保证或托管账户服务。

CLI 会为捐赠任务运行 Ollama 吗？

vibedonate 使用 echo 存根处理默认 CLI 网状任务。Ollama 聊天运行器作为单独的库路径提供。

vibedonate 与 Petals 有何不同？

vibedonate 探索捐赠控制和请求／结果网状网络。Petals 则将模型执行分布到各参与者。

vibedonate 与 Ray Serve 有何不同？

vibedonate 提供本地捐赠控制和 CLI 实验。Ray Serve 则为已部署的模型服务应用提供基础设施。

我能用 vibedonate 赚取真实的 USDC 吗？

vibedonate 提供存根钱包和本地支付记录。CLI 不会提交或验证真实的区块链支付。

stop 会终止正在运行的捐赠者吗？

vibedonate stop 会更改持久化配置和同意状态。要退出网状网络，请按 Ctrl+C 停止正在运行的捐赠者进程。

vibedonate 会共享订阅配额或 API 额度吗？

vibedonate 仅提供计算层。尚未实现订阅和 API 额度路由。

许可证

MIT。