-
tmux — Inter-agent communication layer
-
Python 3.10+ — Framework runtime
- matplotlib, numpy — visualization (context/SOTA/budget graphs)
-
Node.js 18+ — Required by npm-based CLIs (Codex, Cline, Gemini, OpenCode, Qwen)
-
gh (optional) — GitHub CLI, recommended if using CD agent
-
CLI — At least one (used as PM)
Claude Code · Codex CLI · Cline CLI · Gemini CLI · OpenCode · vibe-local · Qwen Code · Kimi Code CLI
Install from each repo's README. Run once to complete authentication. See CLI Support Matrix.
requirement_definition.md— edit from template, or ask PM to create it interactively_remote_info/— site-specific connection info (details)BaseCode/— your code to optimize
# Optional: configure SSH agent (only if remote execution needed)
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/your_private_key
# Setup creates tmux sessions and launches PM inside them
python3 -m vibecodehpc setup --name MyProject -w 4PM starts automatically in a tmux session. It reads the requirement definition and handles worker (SE, PG, CD) startup, CLI/model selection, and directory design.
- PM reads requirements and surveys the environment
- PM designs directory hierarchy and assigns agents
- PG agents iterate: code → compile → run → benchmark
- SE agents track statistics and generate reports
- Results accumulate in
User-shared/with a final report