setup-runpod

Configure RunPod compute for RACA with cluster YAML setup.

Updated May 12, 2026
One-click install
npx skills add https://github.com/wangdepin/raca-codex --skill setup-runpod-wangdepin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-runpod
Source: https://github.com/wangdepin/raca-codex/tree/main/.claude/skills/setup-runpod
Command: npx skills add https://github.com/wangdepin/raca-codex --skill setup-runpod-wangdepin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the friction of connecting RunPod as a compute provider for RACA by guiding you through account setup, API authentication, and cluster configuration without skipping required steps.

Core Features & Use Cases

  • Account + API key setup: Directs you to create a RunPod account and an API key, then validates the key and ensures it is stored only as an environment variable.
  • GPU and pricing guidance: Helps you choose a default GPU type by explaining common options and cloud pricing modes (community vs secure).
  • Pod-focused configuration: Writes the correct entry into .raca/clusters.yaml and performs verification checks so job launching can proceed safely.
  • Platform risk guardrails: Warns about known RunPod issues (e.g., multi-GPU L40S CUDA failures, SSH environment inheritance, disk constraints, CUDA/torch mismatches).

Quick Start

Ask your agent: set up RunPod for RACA and configure .raca/clusters.yaml using my preferred default GPU type.

Frequently Asked Questions about setup-runpod

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure RunPod compute for RACA and write the clusters.yaml entry?

To set up RunPod compute for RACA, you must create an account, validate your API key, select a default GPU type, and write a valid runpod entry into .raca/clusters.yaml with sensible defaults. The process includes verification checks to ensure safe job launching.

How should I securely handle my RunPod API key for SSH pods and training runs?

You must handle your RUNPOD_API_KEY safely by storing it exclusively as an environment variable. This prevents exposing sensitive credentials in configuration files during RACA cluster setup and interactive SSH pod workflows.

What RunPod GPU selection and cloud pricing modes are available for HPC integration?

RunPod GPU selection involves choosing between community and secure cloud pricing modes. The setup process explains common GPU options to help you select a default type for your research workflows and HPC integration.

What are the known limitations and platform risks when setting up RunPod pods?

Known RunPod limitations include multi-GPU L40S CUDA failures, SSH environment inheritance issues, disk constraints, and CUDA/torch mismatches. The setup flow applies platform risk guardrails and warns about these issues to prevent job failures.

Do I need an existing RunPod account to configure compute for raca run-job and dashboards?

Yes, you need an existing RunPod account and a valid API key. The setup flow directs you through account creation and API key validation before configuring clusters.yaml for raca run-job and dashboard integration.