Getting Started (Agent Users)

1. Install swm

# Homebrew (macOS)
brew tap swm-gpu/swm && brew install swm

# or Python (3.11+)
pipx install swm-gpu

Verify: swm --version

2. Add your API keys

swm config set runpod.api_key YOUR_RUNPOD_KEY

# Optional: storage for workspace sync
swm config set b2.key_id YOUR_B2_KEY
swm config set b2.app_key YOUR_B2_SECRET
swm config set b2.bucket my-swm-bucket

3. Install the SKILL.md

The skill teaches your agent how to use swm. Install it for your platform:

Cursor (easiest)

1. Open Settings (Cmd+Shift+J) → Rules → Add Rule → Remote Rule (GitHub)
2. Paste: https://github.com/swm-gpu/swm

Or copy manually:

mkdir -p .agents/skills/swm-gpu-workflow
curl -sL https://raw.githubusercontent.com/swm-gpu/swm/main/.agents/skills/swm-gpu-workflow/SKILL.md \
  -o .agents/skills/swm-gpu-workflow/SKILL.md

Claude Code

mkdir -p .claude/skills/swm-gpu-workflow
curl -sL https://raw.githubusercontent.com/swm-gpu/swm/main/.agents/skills/swm-gpu-workflow/SKILL.md \
  -o .claude/skills/swm-gpu-workflow/SKILL.md

Codex

mkdir -p .codex/skills/swm-gpu-workflow
curl -sL https://raw.githubusercontent.com/swm-gpu/swm/main/.agents/skills/swm-gpu-workflow/SKILL.md \
  -o .codex/skills/swm-gpu-workflow/SKILL.md

Copilot / Windsurf / Amp / Devin

mkdir -p .agents/skills/swm-gpu-workflow
curl -sL https://raw.githubusercontent.com/swm-gpu/swm/main/.agents/skills/swm-gpu-workflow/SKILL.md \
  -o .agents/skills/swm-gpu-workflow/SKILL.md

See Supported Platforms for the full reference.

4. Start asking

Once the skill is installed, just ask your agent:

• “Spin up an H100 and install vLLM”
• “Find the cheapest A100 and fine-tune with Axolotl”
• “Set up ComfyUI with auto-down after 20 minutes”
• “How much have I spent on GPUs this week?”
• “Pull Qwen3-235B and serve it with vLLM”

Your agent will search 10 clouds, provision the cheapest GPU, install your framework, verify everything works, and hand you a URL.

Next steps

• Skill Overview — how the skill works internally
• Supported Platforms — detailed install for every agent
• Custom Skills — write your own workflows on top of swm