rom-manager¶
ROM Converter/Organizer + MCP Server + A2A Agent for the agent-utilities ecosystem — convert game ROMs to CHD/RVZ, extract archives, auto-rename via known game codes, and generate cue sheets.
Official documentation
This site is the canonical reference for rom-manager, maintained alongside every
release.
Overview¶
rom-manager wraps a local ROM conversion pipeline with typed, deterministic MCP
tools and an optional Pydantic-AI agent server. It provides:
RomManager— the real conversion pipeline (rom_manager.rom_manager): extract archives → rename via game codes → convert ISO/WBFS to CHD/RVZ viachdman/dolphin-tool→ cleanup.- Action-routed MCP tools — two consolidated, togglable domains
(
conversion,game-codes) that minimize token overhead in LLM contexts. - An A2A agent server — a Pydantic-AI agent (console script
rom-manager-agent) that calls the MCP tool surface and exposes an AG-UI web interface.
This is a local tool: there is no service URL and no credentials. Conversion
actions require the external chdman (mame-tools), dolphin-tool, and 7z
binaries.
Explore the documentation¶
- Installation — pip, source, extras, external binaries, and Docker.
- Deployment — run the MCP and agent servers, Docker Compose.
- Usage — the MCP tools, the
Apifacade, and the CLI. - Overview — the action-routed tool surface and architecture.
- Concepts — the
CONCEPT:ROM-*registry.
Quick start¶
Convert a directory of ROMs from the CLI: