suparagent README

项目的 README,来自 github.com/Anil-matcha/suparagent。合并为一个 markdown 文件:README.md。

Suparagent

A workspace for AI coworkers.

Create named agents, give each a job and workspace, and bring them together to complete real tasks. Suparagent keeps conversations, memory, routines, and approvals in one place. Use the desktop app or host the server yourself; the hosted service is a separate product.

Bring your own engine and provider account. Suparagent does not include a model or model subscription.

Desktop downloads · Self-hosting · Hosted app · Watch the demo · Discord

▶ Watch: Free Unlimited Grok Bot Alternative: Open-Source, Any Model, No Restrictions

Status: Suparagent is in active development. Desktop releases, self-hosting, agent computers, and newer team features are still evolving. Review known limitations before relying on them for important work.

Contents

Quick start

The desktop app runs from a source checkout. It needs Node.js 22 or newer, uv, and at least one engine available on the same computer. For a CLI engine, install it and sign in before opening Open Duet. You can also configure an API-based engine in Settings → Engines. Docker is only needed for the optional isolated agent computers.

git clone https://github.com/Anil-matcha/suparagent.git
cd suparagent/desktop
npm run app

On first launch, choose an engine, workspace, and approval mode. Then:

  1. Open Settings → Engines and confirm an engine is ready.
  2. Create an agent with a name, a clear job, and a workspace.
  3. Start a chat. Choose Ask first to pause for approval before actions that need it.
  4. Add teammates or create a routine when you want to split up or repeat work.

See the Releases page for current desktop installers and the changelog for changes. Installers are experimental and unsigned. The assisted update flow offers a SHA-256-verified installer for you to open; it does not install updates automatically. The release-to-release update path has not been verified end to end.

What you can do

A request goes to a Claude or Codex team lead, who delegates work to specialists. Teammates can share a project folder, and you review actions when approval is required.

Ways to run Suparagent

Desktop app Self-hosted server Hosted web app Development checkout
Best for A personal workspace on your computer Keeping your agents and routines available on a server you control Using the separately operated Suparagent service Contributing or changing Suparagent
Where workspace data lives Your computer Your server An account-specific hosted workspace Your development machine or configured database
Start here Quick start Self-hosting guide suparagent.ai Development setup
Main requirements Node.js 22+, uv, and an engine Linux server, HTTPS, Docker or Node.js and uv, and an engine An account and an AI provider account Node.js, uv, and Docker if you use PostgreSQL
Status Experimental Experimental; one owner who can invite teammates Separate hosted product —

The hosted service is separate from the open-source desktop and self-hosted core. Hosted account, workspace, and billing data are handled by Suparagent; see the hosted service's Privacy Policy and Terms.

Hosted plans

The hosted preview lets you use your own Boat key for sandbox compute. Paid plans use compute operated by Suparagent, so you do not need to supply a Boat key. In both cases, you bring your AI provider account and pay that provider for model usage.

Plan Monthly Suparagent price Included running compute Machine disk capacity
Free preview $0 Billed to your Boat account Small profile
Starter $15 100 hours per billing period 51 GB
Standard $49 300 hours per billing period 51 GB
Pro $99 720 hours per billing period 111 GB

Paid-plan compute hours count while the sandbox is running, including idle time. At the limit, it stops until the next billing period or a plan change; compute overages are not charged. The disk value is the selected machine's capacity, not a separate storage quota. A stopped sandbox's disk is subject to the provider's retention period, so export important files before a paid plan ends. Paid checkout is enabled for hosted accounts; see the Suparagent pricing page for current plans.

Engines, data, and costs

Connect an engine you already use: Claude Code or Codex CLI, Gemini CLI, Google Gemini through Antigravity, Cursor, another command-line agent using the Agent Client Protocol (ACP), OpenRouter, or an OpenAI-compatible API such as Ollama or LM Studio. Available tools vary by engine; image input and agent computers, for example, are not supported by every engine. See engine setup and capabilities.

For desktop and self-hosted use, conversations, agent notes, routines, and settings are stored in that instance's local data folder or server database. Workspace files stay in the folders you assign to agents. API keys saved through Suparagent are encrypted there; command-line sign-ins remain with the engine installed on that machine.

When an agent answers, the selected engine receives the prompt and the context needed for that turn. This can include text you attach, relevant notes, and workspace content the engine reads. If the engine is a hosted service, that information is handled under that provider's terms. You bring the provider account, CLI sign-in, or API key; model usage may cost money.

Example: prepare a weekly project briefing

Create a lead agent and specialists, such as a researcher and an editor. Give them the same project workspace, and set the lead's engine to Claude or Codex. Ask the lead to prepare a briefing from the notes and reports in that folder.

The lead can split the request into smaller tasks and hand them to the specialists. Their work runs in separate conversations, then returns to the lead to assemble. Follow along in chat and approve actions when the settings require it. Once the process works well, make it a weekly routine and review each run in the app.

Scheduling tasks

Routines run prompts on local agents on a schedule, by webhook, or on demand. They run in the backend, so the backend must stay running. The original Telegram bot and Boat sandbox task flow are optional and separate from the agent workspace. See backend scheduling details and environment settings.

Known limitations

Guides

Getting started

Agents and work

Tools and customization

Project

Support

Contributing

Issues and pull requests are welcome. Start with the contributing guide.

To propose a third-party app for the in-app MCP Marketplace, add a Community manifest under marketplace/plugins/community/, regenerate marketplace/catalog.json, and submit both in a pull request. See the MCP Marketplace submission guide for the manifest requirements and validation steps.

License

Suparagent is licensed under the Apache License 2.0.

suparagent (Anil-matcha/suparagent)

正在搜索数据库…

这是什么?一个开源、可自托管的 AI 智能体工作区,用来替代 OpenAI Dots、Claude Cowork、Grok Bot 和 ChatGPT agent 这类付费产品。这个原型聚焦于编程智能体的工作流程:通过 Telegram 或浏览器运行 Claude Code 任务、审核高风险操作,以及定时执行重复的提示词。
这是需要注册使用的托管服务,还是我自己部署运行的东西?需要自己部署运行:一个 FastAPI 后端、一个 Next.js 网页界面和一个可选的 Telegram 机器人,三者共用同一套 API、沙盒和各用户自己的凭据。
我怎么把它跑起来?先填写 backend/.env,然后在仓库根目录运行 ./scripts/dev.sh——它会用 Docker 启动 Postgres、安装依赖、执行数据库迁移,并启动 API、Telegram 机器人和网页界面(Windows 上用 Git Bash 也可以)。按 Ctrl+C 会停掉除 Postgres 以外的所有东西。
要让它真正跑起来,我需要准备什么?本地环境:uv、Node.js 20.9+、用于运行 Postgres 的 Docker(或者实验性的 SQLite 模式)以及 Bash。账号方面:需要一个用于创建沙盒的 'Boat' API 密钥,还要通过 OAuth 登录关联 Claude——这是目前唯一支持的智能体。只有在用机器人或做关联时才需要 Telegram bot token;网页界面的访客模式没有它也能用。
既然标着原型,它到底有多不成熟?还处于早期:README 写明是 'Prototype / active development'(原型 / 积极开发中),并指向一个 Known limitations(已知限制)部分,提醒你在给别人使用之前先读一遍。它还直言自己的功能和那些付费服务不一样,并不是逐项对等的替代品。
我的令牌和任务记录是怎么存储的?凭据用你自己生成的 Fernet 密钥加密,沙盒、任务、权限和定时任务的记录都保存在你自己的 PostgreSQL 里。
这个智能体能搜索网页吗?可以,属于可选项——把 PARALLELSEARCHENABLED 设为 true 后,新建的 Claude 任务就能通过 MCP 免费使用 Parallel 的网页搜索和网页抓取。不需要 Parallel 账号或 API 密钥,但它有速率限制,只适合轻度使用,而且默认关闭;相关的工具调用会通过常规的权限提示让你确认。
为什么不直接花钱用那些智能体,而要自己跑这个?它的卖点是提供一个你自己掌控、可以审查的工作区:编程任务的审批步骤清晰可见,应用和数据都由你在本地控制。README 也坦率说明它的功能与付费服务有所不同,并非一一对应。
不用 Telegram,网页界面也能用吗?能——以访客身份继续即可,使用本地生成的 id,不需要机器人;之后你还可以向机器人发送 /link 来关联 Telegram 身份。有个小细节:在浏览器里创建的定时任务用的是你的时区,而 Telegram 里创建的始终是 UTC。
大小
7.3 MB
星标
7.1K
更新
提交Nov 17
时长
3年
提交 · 90 天