项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 9977
使用教程
环境要求
- Python 3.12 或更高版本
- uv(Python 包与项目管理工具)
- 至少一个 LLM 服务商的 API Key:OPENROUTER_API_KEY、OPENAI_API_KEY 或 MINIMAX_API_KEY
安装与启动步骤
-
1准备运行环境
确认本机已装 Python 3.12+,并安装 uv。README 未给出 uv 的安装命令,请按其官方说明自行安装。
-
2安装 Bindu
在你要使用 Bindu 的项目目录下用 uv 添加依赖,uv 会自动安装 bindu 包。
uv add bindu -
3源码方式安装
若想直接改动 Bindu 本体而非当依赖使用,克隆仓库后同步开发依赖。
git clone https://github.com/getbindu/Bindu.git cd Bindu uv sync --dev -
4配置模型密钥
运行示例前设置至少一个 LLM 提供商的 API Key,Quickstart 示例使用 OpenAI。
export OPENAI_API_KEY=sk-xxxxxxxx -
5编写 Agent 脚本
新建 Python 文件,创建 Agent、写好 config 字典与 handler,再调用 bindufy 启动服务。
-
6启动 Agent
运行脚本后代理上线并监听本地 3773 端口;expose 为 True 时会自动开启 FRP 隧道对外暴露。
python research_agent.py -
7调用验证
用 curl 向根路径发送 JSON-RPC 的 message/send 请求,再用同一 taskId 轮询 tasks/get 直到 completed。
curl -X POST http://localhost:3773/ \ -H 'Content-Type: application/json' \ -d '{ "jsonrpc": "2.0", "method": "message/send", "id": "<uuid>", "params": { "message": { "role": "user", "kind": "message", "parts": [{"kind": "text", "text": "Hello"}], "messageId": "<uuid>", "contextId": "<uuid>", "taskId": "<uuid>" } } }'
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
author | 是 | 代理作者标识,示例中填邮箱 | you@example.com |
name | 是 | 代理名称,注册与识别时使用 | research_agent |
description | 是 | 代理功能描述,便于他人了解用途 | Research assistant with web search. |
deployment.url | 是 | 代理监听地址,示例为本地 3773 端口 | http://localhost:3773 |
deployment.expose | 否 | 为 True 时开启 FRP 隧道,公网可直接访问 | true |
skills | 是 | 代理挂载的技能目录列表 | ["skills/question-answering"] |
如何确认成功
脚本运行后 agent 上线于 http://localhost:3773,curl 请求能返回结果,并用同一 taskId 轮询 tasks/get 直到状态为 completed。
常见问题
Q:必须要哪个大模型平台的 API Key?
A:至少一个即可,README 列出 OPENROUTER_API_KEY、OPENAI_API_KEY 或 MINIMAX_API_KEY,Quickstart 示例用的是 OPENAI_API_KEY。
Q:只能用 Python 写吗?
A:不是。官方还有 @bindu/sdk 的 TypeScript 版本,它会在后台自动启动 Python 内核,同一协议、同一 DID,业务代码里不需要写 Python。
Q:deployment 里的 expose 有什么作用?
A:设为 True 会自动开一条 FRP 隧道,让公网直接访问你的代理,无需自己配置端口转发。
Q:怎么知道任务处理完了?
A:发送 message/send 后拿到 taskId,用同一个 taskId 轮询 tasks/get,状态变为 completed 即完成。
Q:只想改 Bindu 源码该怎么办?
A:不要用 uv add bindu,而是克隆仓库后执行 uv sync --dev 同步开发依赖。
注意事项
- 示例默认监听 3773 端口,若被占用需自行调整 deployment.url。
- 先设置好 LLM 的 API Key,否则示例中的模型调用会失败。
- bindufy 之后代理即在线,expose 为 True 意味着服务会对公网开放,注意不要泄露密钥。
- README 未给出 uv 的安装方式,请先按 uv 官方文档完成安装。
核心亮点
- 提供代理身份注册与验证,解决代理间信任问题
- 内置支付通道,支持代理自主完成服务结算
- 遵循欧盟 AI 法案,合规性设计领先同类项目
不足之处
- 项目仍处于早期,文档和生态尚不完善
- 支付和身份体系依赖特定基础设施,通用性待验证
适用场景
- 多代理协作平台的身份认证与通信
- AI 代理自主购买服务或资源的支付场景
- 需要合规审计的代理系统部署
替代项目
Fetch.ai、Autonolas、AgentLayer
下一篇:mini-swe-agent
同类项目推荐
obsidian-claude-sidebar
开源
在 Obsidian 侧边栏直接运行 AI 编程代理,边记边写代码
Run Claude Code, Codex, and other agent CLIs in Obsidian
gemini-flow
开源
用 Gemini CLI 一键拉起 AI 开发团队,自动完成编码任务。
rUv's Claude-Flow, translated to the new Gemini CLI; transforming it into an autonom···
awesome-agent-evolution
开源
一张地图看懂AI智能体进化全貌,快速找到前沿资源。
Open survey and evidence map for AI agent evolution, self-evolving agents, memory, s···
sentient-os
开源
让 AI 读懂你的生活,主动帮你把电脑上的活干了
An on-device LLM understands your entire life, then proactively offers to get your w···
VibeAround
开源
一个入口并行管理所有 AI 编程代理,随时远程调度
Keep your AI coding agents around. Launch Claude Code, Codex CLI, Gemini CLI, Pi Age···
octo-cli
开源
给 AI 智能体一个结构化命令行,告别交互式提示
Metadata-driven CLI for AI Agent Bots — 48 operations across 7 domains, structured ···
CORAL
开源
让编码智能体自主协作,自动完成科研任务
Open-source autoresearch powered by autonomous coding agents. Run Claude Code, OpenC···
MCP-Packet-Tracer
开源
用大白话描述网络需求,自动生成并部署 Cisco 拓扑。
AI-powered Cisco Packet Tracer automation over MCP. Describe a network in natural la···
moling
开源
本地部署的 AI 助手,直接操控电脑和浏览器,解放双手。
MoLing is a computer-use and browser-use based MCP server. It is a locally deployed,···
