Getting started
Help and onboarding
setup-check validates Python version, package install, API keys, dependencies, and workspace configuration.
Single-agent examples
Research agent
Code review agent
Agent with MCP
Multi-agent from YAML
Createresearch_team.yaml:
Load agents from Markdown
.md file uses frontmatter for name, model_name, temperature, max_loops, and a body used as the system prompt.
Configuration templates
Troubleshooting
| Issue | What to try |
|---|---|
| Auth errors | swarms check-login, verify .env API keys |
| Missing workspace | export WORKSPACE_DIR=/path/to/workspace |
| Command not found | pip install -U swarms and confirm CLI on PATH |