Skip to content

docs(flash): move the flash lane to the Runpod SDK 2.0 (rp flash) #89

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
justinwlin wants to merge 19 commits into
base: main
Choose a base branch
from
Open

docs(flash): move the flash lane to the Runpod SDK 2.0 (rp flash) #89

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
750099e
docs(flash): move the flash lane to the Runpod SDK 2.0 (rp flash)
justinwlin Oct 16, 2026
bf0dec0
docs(flash): restore SIGINT for background dev sessions so cleanup runs
justinwlin Oct 16, 2026
6e4d5fe
docs(flash): record live results on runpod 2.0.0rc1
justinwlin Oct 16, 2026
b4e3f63
docs(flash): verify the SDK volume handoff via rp flash deploy
justinwlin Oct 16, 2026
fb91d17
docs(flash): verify golden path 08 and call_deployed on the SDK; docu…
justinwlin Oct 16, 2026
7db04f3
docs(flash): make train_then_serve verifiable and verify it live
justinwlin Oct 16, 2026
cdd1dc8
docs(flash): drop SDK workarounds now fixed in runpod 2.0.0rc2
justinwlin Oct 20, 2026
0dcc42a
docs(flash): queue calls stop waiting after 300 s; scope one-file rul…
justinwlin Oct 20, 2026
5ac4316
style(concepts): format flash.yaml
justinwlin Oct 21, 2026
4d00f66
docs(flash): pin runpod>=2.0.1 and say every endpoint gets the API key
justinwlin Oct 22, 2026
5a037b7
docs(flash): fall back to runpod-flash when the SDK path fails
justinwlin Oct 22, 2026
6411449
docs(flash): cite SDK source instead of PRs; drop build history
justinwlin Oct 22, 2026
5925d7d
docs(flash): address review round 1
justinwlin Oct 22, 2026
9451b6e
docs(flash): address review round 2
justinwlin Oct 23, 2026
1d38d89
docs(flash): one fallback venv per project
justinwlin Oct 23, 2026
1495679
docs(volume-cache): load volume-backed models through VolumeCache on …
justinwlin Oct 23, 2026
81c2d69
docs(volume-cache): address review round 5
justinwlin Oct 23, 2026
4dd848e
docs(flash): pass a VolumeCache namespace on tasks
justinwlin Oct 23, 2026
8766329
Merge remote-tracking branch 'origin/main' into pr89-merge
justinwlin Oct 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,3 +9,6 @@ result-*
# Concept graph tooling (ontology/)
node_modules/
ontology/build/

# Python bytecode
*.pyc
2 changes: 1 addition & 1 deletion AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ lane is unclear, then follows its decision table into a lane's `SKILL.md`.
skills/runpod/ router / entrypoint — decides the lane
skills/runpod-mcp/ manage infra via the Runpod MCP server (structured tool calls)
skills/runpodctl/ manage infra via the CLI (+ Hub, file transfer, SSH, doctor)
skills/flash/ write & deploy your own code on Runpod serverless (@remote)
skills/flash/ write & deploy your own code on Runpod serverless (Runpod SDK apps, rp flash)
skills/companion-clis/ prerequisite CLIs (hf, gh, docker, aws)
skills/runpod-usage/ conceptual knowledge ("how Runpod works") — not a tool
reference/*.md detailed topics, loaded on demand
Expand Down
4 changes: 2 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ Gemini, opencode, +more). The first line is all you need; drop any others you wo
```bash
npx skills add runpod/runpod-plugins-official # the skills — any agent (essential)
curl -sSL https://cli.runpod.net | bash # runpodctl — infra CLI (or: brew install runpod/runpodctl/runpodctl)
uv tool install runpod-flash # flash — deploy your own code (optional; or: pip install runpod-flash)
pip install "runpod>=2.0.1" # Runpod SDK + rp CLI — deploy your own code (optional; flash lane)
npx @runpod/mcp-server@latest add # hosted MCP server — guided setup, OAuth (optional)
```

Expand Down Expand Up @@ -180,7 +180,7 @@ Start with the **`runpod`** router; it points at the right lane.
| [`runpod`](plugins/runpod/skills/runpod/SKILL.md) | Router / entrypoint. Start here when the right skill is unclear. |
| [`runpod-mcp`](plugins/runpod/skills/runpod-mcp/SKILL.md) | Manage infra via the Runpod **MCP server**'s structured tool calls. |
| [`runpodctl`](plugins/runpod/skills/runpodctl/SKILL.md) | Manage infra from the **CLI**, plus Hub, file transfer, SSH, `doctor`. |
| [`flash`](plugins/runpod/skills/flash/SKILL.md) | **Write and deploy your own code** on Runpod serverless (`@remote`). |
| [`flash`](plugins/runpod/skills/flash/SKILL.md) | **Write and deploy your own code** on Runpod serverless with the Runpod SDK (`runpod.App`, `rp flash`). |
| [`companion-clis`](plugins/runpod/skills/companion-clis/SKILL.md) | Prerequisite CLIs: `hf`, `docker`, `gh`, `aws`. |
| [`runpod-usage`](plugins/runpod/skills/runpod-usage/SKILL.md) | **Concepts** — pods/serverless, containers, storage, GPU selection, gotchas. |
| [`runpod-templates`](plugins/runpod/skills/runpod-templates/SKILL.md) | **Official pod templates** — what each image ships, ports/paths, readiness, gotchas. |
Expand Down
6 changes: 3 additions & 3 deletions plugins/runpod/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ lane below. If you already know the lane, go straight to it.
| [`runpod`](skills/runpod/SKILL.md) | Router / entrypoint. Start here when the right skill is unclear. |
| [`runpod-mcp`](skills/runpod-mcp/SKILL.md) | Manage infra (pods, endpoints, jobs, templates, volumes, catalog, billing) via the Runpod **MCP server**'s structured tool calls. |
| [`runpodctl`](skills/runpodctl/SKILL.md) | Manage infra from the **CLI**, plus Hub deploys, file transfer (`send`/`receive`), SSH, and `doctor` setup. |
| [`flash`](skills/flash/SKILL.md) | **Write and deploy your own code** on Runpod serverless — `@remote`/`@Endpoint`, `flash dev`, `flash deploy`. |
| [`flash`](skills/flash/SKILL.md) | **Write and deploy your own code** on Runpod serverless with the Runpod SDK — `@app.queue`/`@app.api`/`@app.task`, `rp flash dev`, `rp flash deploy`; migrates legacy `runpod-flash` projects. |
| [`companion-clis`](skills/companion-clis/SKILL.md) | Prerequisite CLIs: `hf` (models), `docker` (images), `gh` (repos/releases), `aws` (S3 to volumes). |
| [`runpod-usage`](skills/runpod-usage/SKILL.md) | **Concepts** — how pods/serverless work, building containers, storage, GPU selection, gotchas. |
| [`runpod-templates`](skills/runpod-templates/SKILL.md) | **Official pod templates** — what each image ships, ports/paths, readiness/runtime gotchas, version pinning; ComfyUI, PyTorch, Ubuntu. |
Expand Down Expand Up @@ -123,7 +123,7 @@ For one-off actions, just ask — the router picks the lane:
- "Create a pod with an RTX 4090"
- "Deploy a serverless endpoint from this image"
- "Which GPU should I use for a 13B model?"
- "Write an `@remote` function and run it on a GPU"
- "Write a Python function and run it on a GPU with the Runpod SDK"
- "Download a model, containerize it, and deploy it"
- "Find the missing model links in this ComfyUI workflow and download the verified files to my Pod"

Expand Down Expand Up @@ -156,7 +156,7 @@ skills/
golden-paths/ worked end-to-end reference tasks (indexed by the router)
runpod-mcp/ Runpod MCP server (structured tool calls)
runpodctl/ Runpod CLI (+ Hub, transfer, SSH, doctor)
flash/ write & deploy your own code (@remote)
flash/ write & deploy your own code (Runpod SDK apps)
companion-clis/ hf / gh / docker / aws prerequisites
runpod-usage/ concepts + reference/*.md
runpod-templates/ official pod templates + repair guide + scripts
Expand Down
Loading
Loading