swarms
Route Swarms users to the right single-agent, CLI, workflow, or tool/MCP guidance.
- License 许可
- Apache-2.0
- 最近更新
- 2026-10-08
- Stars
- ★ 11
- Forks
- 3
01 前言 Front Matter
- name
- swarms
- license
- Apache 2.0
- metadata
- { "disco-role": "operating" }
- description
- Route Swarms users to the right single-agent, CLI, workflow, or tool/MCP guidance.
- disable-model-invocation
- true
02 资源文件 4
- 参考文档references/overview.md1.8 KB
- 参考文档references/repo-provenance.md754 B
- 参考文档references/repo-routing-metadata.json399 B
- 参考文档references/troubleshooting.md2.4 KB
03 SKILL.md 正文
Swarms
Use this repo skill for the swarms Python package when the task is about building,
routing, loading, or debugging Swarms agents and orchestrations.
Start here
- If the user is creating or tuning one
Agent, go tosub-skills/single-agent/. - If the user is using the
swarmsCLI, YAML, or markdown loaders, go tosub-skills/cli-loaders/. - If the user is combining many agents with a swarm, router, graph, debate, vote, or chat pattern, go to
sub-skills/multi-agent-workflows/. - If the user is converting callables to tools or connecting MCP servers, go to
sub-skills/tools-mcp/.
What this skill covers
- Single-agent construction, memory, skills, marketplace prompts, prompt caching, fallback models, and artifact handling.
- CLI commands and file-driven agent creation.
- Multi-agent orchestration patterns, routing, consensus, and collaboration.
- Tool schema conversion, BaseTool helpers, and MCP client/server workflows.
What this skill does not cover
- Release automation, Docker packaging, or repo-maintenance scripts.
- Benchmark harnesses and expensive evaluation loops.
- Voice-agent demos and AOP demo trees.
- Private repo checkout paths or workflow instructions that depend on the original source tree.
Quick install and smoke check
pip install swarms
swarms --help
python -c "from swarms import Agent; print(Agent.__name__)"
Optional runtime signals
WORKSPACE_DIRcontrols where agent memory and workspace files are stored.SWARMS_API_KEYis required for marketplace fetch/publish workflows.OPENAI_API_KEY,ANTHROPIC_API_KEY,GROQ_API_KEY, and similar provider keys are required only for live model-backed runs.graphvizandrustworkxare optional for graph-workflow variety.
Read these next
references/overview.mdfor the package map and route selection notes.references/troubleshooting.mdfor cross-cutting install, import, key, and backend issues.scripts/smoke.shfor a quick offline import and CLI check.
Routing rule of thumb
Choose the narrowest sub-skill that owns the user-facing workflow. Use the root only when the request spans multiple families or is about the package as a whole.
single-agentowns one-agent configuration and its direct support objects.cli-loadersowns command-line entry points and config/file loading.multi-agent-workflowsowns swarm orchestration and routing patterns.tools-mcpowns tool schema helpers and MCP transport/auth workflows.
04 同仓库更多 Skills
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
python-api
Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP/mAP semantics, and source-style import diagnostics.
file-evaluation
Folder-based PASCAL VOC AP/mAP evaluation from ground-truth and detection text files.
object-detection-metrics
Guides legacy Object-Detection-Metrics PASCAL VOC AP/mAP evaluation from detection text folders and direct Python API classes.
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.