# Install

> Fresh-machine bootstrap of the ralphy CLI binary. Read .agents/skills/install/references/ralphy-install.md FIRST via the Read tool — every time, no exceptions. USE WHEN the ralphy binary is NOT yet on PATH and the user needs to get it onto their machine — install the standalone binary from GitHub Releases, ensure bun + ffmpeg are present, run the interactive setup wizard, link to the user's checkout of ugc-cli. Once `ralphy --version` works and the project is linked, hand off to ralph-core for in-tree dev tasks. TRIGGER (EN): "install ralphy", "set up from scratch", "fresh machine", "first run", "bootstrap the CLI", "I just cloned the repo", "I don't have ralphy yet", "ralphy not found", "/install". ALSO FIRE if `which ralphy` returns nothing in a session about to use ralphy commands, OR `ralphy status` errors with "Could not locate the ugc-cli project". DO NOT FIRE if ralphy is already installed and the user just wants `ralphy doctor` / env check (that is ralph-core), or wants to install template assets from

- Skill: `alecs5am/install` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add alecs5am/install`
- Raw SKILL.md: https://api.skillmd.com/api/skills/alecs5am/install/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: alecs5am (https://skillmd.com/u/alecs5am)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/alecs5am/install

---


# install (shim)

The full role instructions have moved to **[`.agents/skills/install/references/ralphy-install.md`](../../../.agents/skills/install/references/ralphy-install.md)**.

**Read that file completely via the Read tool before bootstrapping a fresh machine.** It walks through the four sub-tasks (check-environment, install-ralphy, run-setup-wizard, verify) and the fallbacks. Do not improvise from this shim.