rudder-profiles-setuplisted
Install: claude install-skill rudderlabs/rudder-agent-skills
# RudderStack Profiles Setup
Set up the local Profiles toolchain so later skills can discover warehouse metadata, generate YAML, and run `pb` commands safely.
## Prerequisites
Check these before anything else:
| Prerequisite | Check | If missing |
|-------------|-------|------------|
| Python 3.10+ | `which python3` and `python3 --version` | Install from python.org or system package manager |
| uv | `which uv` | Install from https://docs.astral.sh/uv/getting-started/installation/ |
| git | `which git` | Install from git-scm.com or system package manager |
## Workflow
1. **Check prerequisites** — `which python3`, `which uv`, `which git`. If any are missing, explain what to install and stop.
2. **Clone profiles-mcp** — `git clone https://github.com/rudderlabs/profiles-mcp` into a user-approved location. Skip if already cloned.
3. **Configure `.env`** — The `.env` file needs `RUDDERSTACK_PAT`, `IS_CLOUD_BASED`, and `USE_PB_QUERY`. Do not ask the user to paste secrets into chat. Instead, instruct them to copy `.env.sample` to `.env` and fill in values, or let `setup.sh` handle it via its interactive `env_setup.py` step.
4. **Run `./setup.sh`** — From the `profiles-mcp` checkout. This script:
- validates the OS and Python version,
- installs `uv` if missing,
- generates a `start.sh` wrapper,
- runs `env_setup.py` (interactive — prompts for PAT via masked input),
- installs Python dependencies in a `.venv`,
- installs the `pb` CLI,
- downloads RAG embeddi