GR

ginkida/rustyhand

部署与 DevOps

本页由 AI 翻译,技术细节请以原文为准。 查看原文

20 stars 7 forks 质量 79 趋势 18MIT

Rust 代理操作系统 — 一个二进制文件,37个代理,26个LLM提供者,37个通道(Telegram/Discord/Slack等),MCP服务器,A2A协议,120+ API端点,网页仪表盘

概览

开源Rust内置代理操作系统。134K LOC。10个箱子。1728次测试。零零剪辑警告。一个二进制文件。自主电报代理。真正为你工作的代理。 快速入门 • CLI 参考 • API 文档 第三次对抗性审计扫描,涵盖API认证、通道、内核调度器/工作流、内存/知识和请求路由——每个结果均被三视角反驳面板封锁。关闭A2A和cron-webhook客户端中的未认证所有者认证绕过(伪装X-Forwarded-For)、基于重定向的SSRF、RHP预共享密钥序列化泄漏、MCP允许列表/文件读硬化、~24×成本配额超计、cron验证/时区正确性、工作流运行泄漏+持久化竞速、知识图多跳遍历和Unicode感知会话搜索。详情请参见发布说明。克隆→货物运行——释放——启动→打开仪表盘→与代理对话。

概述(AI 翻译)

锈手 代理操作系统

Rust 内置的开源代理操作系统。134K LOC。10个箱子。1728次测试。零剪辑警告。 一个二进制。自主电报代理。真正为你工作的代理。

快速入门 • CLI参考 • API 文档


v0.7.87 — 审计迭代3:27次验证确认修复(2026年6月) 第三次对抗性审计扫描,涵盖 API 认证、通道、内核调度器/工作流、内存/知识和请求路由——每个结果均被三镜反驳面板限制。关闭未认证所有者认证绕过(伪造的 X-Forwarded-For)、A2A 和 cron-webhook 客户端中的重定向 SSRF、RHP 预共享密钥序列化泄漏、MCP 允许列表/文件读加固、~24× 成本配额超计、cron 验证/时区正确性、工作流运行泄露 + 持久化竞速、知识图谱多跳遍历以及 Unicode 识别会话搜索。详情请参见发布说明。

克隆→ cargo run --release -- start →打开仪表盘→与一名特工对话。 无需API密钥。 当环境中找不到提供者密钥时,

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

RustyHand The Agent Operating System

Open-source Agent OS built in Rust. 134K LOC. 10 crates. 1,728 tests. Zero clippy warnings. One binary. Autonomous Telegram agent. Agents that actually work for you.

Quick Start • CLI Reference • API Docs


v0.7.87 — Audit iteration 3: 27 verifier-confirmed fixes (June 2026) A third adversarial-audit sweep over API auth, channels, the kernel scheduler/workflows, memory/knowledge, and request routing — each finding gated behind a 3-lens refute panel. Closes an unauthenticated-Owner auth bypass (spoofed X-Forwarded-For), redirect-based SSRF in the A2A and cron-webhook clients, an RHP pre-shared-key serialization leak, MCP allowlist/file-read hardening, a ~24× cost-quota over-count, cron validation/timezone correctness, workflow run-leak + persistence races, knowledge-graph multi-hop traversal, and Unicode-aware session search. See the release notes for details.

Clone → cargo run --release -- start → open the dashboard → talk to an agent. No API key required. When no provider key is found in the environment, RustyHand falls back to a deterministic mock driver and seeds four sample resources so every major dashboard page is interactive on first visit:

  • rusty welcome agent (chat-ready)
  • demo-pipeline workflow (2-step sample, click to run)
  • sample agent-spawn trigger
  • demo-daily-ping cron job (registered, disabled by default)

A welcome modal on first visit lists all four with one-click navigation. The CLI startup banner and Docker entrypoint both announce demo mode as a feature instead of a missing-key warning. Set ANTHROPIC_API_KEY (or a Kimi / DeepSeek / Zhipu / MiniMax / OpenRouter / Ollama key) and restart for real LLM responses, or RUSTYHAND_DISABLE_DEMO_MODE=1 to force a hard fail.

Highlights since v0.7.41:

  • React dashboard — every subsystem is a page: agents, chat, workflows, automation (cron + triggers), channels, analytics, knowledge graph, skills,
在 GitHub 查看完整 README

安装

docker run -p 4200:4200 \
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "rustyhand": { "command": "rustyhand", "args": ["mcp"] } } }