Skip to content

Latest commit

 

History

History
60 lines (39 loc) · 2.48 KB

README.en.md

File metadata and controls

60 lines (39 loc) · 2.48 KB

OpenSuperAgent

An open-source implementation of DeepSeek's Super-agent design.

English | 简体中文

Inspired by the DeepSeek Harness team's Super-agent Design Exploration: Toward More Autonomous Agent Systems, I build OpenSuperAgent: a self-hosted, open-source implementation of the Super-agent concept.

The goal: an agent that picks up messages from your workflow, keeps track of each task, and moves multiple jobs forward. Give it a goal, add direction along the way, and check in to review progress and results.

The project is still in its early stages. Join in to explore and improve it.

Try it

Requires Node.js >= 22.13.0 and access to a model API.

npm install -g opensuperagent
opensuperagent init
opensuperagent serve

Open http://127.0.0.1:7420. Under System settings → Models and Provider, add a provider, API key, and model, then configure Router and Worker routes. Submit your first task from the console.

Make it yours

Start with 10 Workers and 13 Skills covering development, testing, review, documentation, data analysis, and more. Add your own roles and working methods:

Extension Start here
Worker: role, tools, and model seed/definitions
Skill: reusable instructions and resources seed/skills
Instance configuration config.example.yaml
opensuperagent def import ./my-worker.json
opensuperagent skill import ./my-skill

Configuration and runtime data live in ~/.opensuperagent by default. Select another configuration file with --config <path>.

All CLI commands, including init, select configuration in this order: --config <path> > OPENSUPERAGENT_CONFIG > ./config.yaml > ~/.opensuperagent/config.yaml. A missing explicitly selected file or a missing --config value causes an error. init creates the default config only when no config was selected or discovered.

Develop locally

npm ci
npm ci --prefix web
npm run dev -- serve
# In another terminal
npm run dev:web

Checks and build: npm run typecheck, npm --prefix web run lint, npm test, npm run build.

Try it in your workflow, open an issue, or contribute code to help turn these ideas into a useful everyday tool.

License

Apache License 2.0 · Copyright 2026 OpenSuperAgent contributors.