Skip to content

feat: add hub command to browse and deploy from the runpod hub#262

Open
TimPietruskyRunPod wants to merge 3 commits intomainfrom
feat/hub-command
Open

feat: add hub command to browse and deploy from the runpod hub#262
TimPietruskyRunPod wants to merge 3 commits intomainfrom
feat/hub-command

Conversation

@TimPietruskyRunPod
Copy link
Copy Markdown
Member

@TimPietruskyRunPod TimPietruskyRunPod commented Mar 25, 2026

Summary

  • Adds runpodctl hub command group (list, search, get) to browse the RunPod Hub marketplace via the existing GraphQL listings API
  • Adds --hub-id flag to serverless create as an alternative to --template-id, enabling one-command deployment from hub repos
  • When --hub-id is used, the CLI resolves the listing, extracts the build image and config from the latest release, creates an inline template via the GraphQL saveEndpoint mutation (matching the web UI flow), and deploys the endpoint

New commands

runpodctl hub list                              # top 10 by stars
runpodctl hub list --type SERVERLESS            # only serverless repos
runpodctl hub search vllm                       # search by name
runpodctl hub get runpod-workers/worker-vllm    # get by owner/name
runpodctl hub get <listing-id>                  # get by id

Serverless create from hub

runpodctl hub search vllm
runpodctl serverless create --hub-id cm8h09d9n000008jvh2rqdsmb --name "my-vllm"

GPU IDs and container disk size are automatically pulled from the hub release config. Users can override with --gpu-id.

Test plan

  • Unit tests pass (go test ./...)
  • E2E tests for hub list, search, get (9 tests)
  • E2E tests for serverless create validation (2 tests)
  • E2E test for serverless create from hub with cleanup (1 test)
  • All 12 new e2e tests pass against live API
  • Docs regenerated

@promptless
Copy link
Copy Markdown

promptless bot commented Mar 25, 2026

📝 Documentation updates detected!

Updated existing suggestion: Update runpodctl documentation for v2.0


Tip: Create additional Docs Collections to keep multiple repositories in sync 📚

adds `runpodctl hub` command group to browse, search, and get details
from the runpod hub marketplace. also adds `--hub-id` flag to
`serverless create` to deploy endpoints directly from hub listings
without needing to create a template first.

new commands:
- hub list (with --type, --category, --order-by, --owner filters)
- hub search <term>
- hub get <id-or-owner/name>

serverless create --hub-id resolves the listing, extracts the build
image and config, creates an inline template via graphql, and deploys
the endpoint — matching the web ui flow.
adds two eval scenarios to test whether an agent can discover and
deploy serverless endpoints from the runpod hub using the new
hub commands and --hub-id flag.
…hub release

- serverless template creation via REST fails because the api rejects
  volumeInGb on serverless templates even when set to 0; skip sending
  volume fields when --serverless is set
- include tests field in hub release get response so agents can use
  the pre-built test payloads to call deployed endpoints
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant