Skip to main content

Installation

rtl_buddy is available on PyPI and installed into your project environment with uv.

Prerequisites​

  • Python 3.11 or later
  • uv
  • Simulation tool on PATH: Verilator (macOS/Linux) or VCS (Linux)
  • Optional Verible binaries if you want to use uv run rb verible ...
  • Optional system-level coverage tools:
    • lcov for .info export and HTML reports
    • Antmicro coverview for Coverview package generation

rtl_buddy can be used with different project-specific tool setups, but the primary supported flows are Verilator and VCS. Basic Verible command integration exists; broader first-class Verible and PeakRDL workflows are on the roadmap.

Install Into A Project With uv​

Add rtl_buddy to your project environment:

uv add rtl_buddy

Then verify the install:

uv run rb --version

Updating​

To move a project to a newer rtl_buddy version:

uv add rtl_buddy@latest
uv sync

Commit the resulting lockfile change in your project repo.

Set Up The Agent Skill​

rtl_buddy ships an agent skill for Claude Code and Codex. After installing rtl_buddy, run once per machine:

uv run rtl-buddy skill install

This writes SKILL.md to ~/.claude/skills/rtl_buddy/ and ~/.codex/skills/rtl_buddy/. Agents pick it up automatically. Re-run after upgrading rtl_buddy to refresh the content.

To install at project scope instead (overrides the user-level copy for that project):

uv run rtl-buddy skill install --project

See For Agents for scope semantics and .gitignore guidance.