Skip to content

✨ feat: install graphviz binaries #512

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Nicola Franco (franconicola) merged 2 commits into from
Jul 26, 2026
Merged

✨ feat: install graphviz binaries #512

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
9499b3e
✨ feat: install graphviz binaries
marcorusso97 Jul 23, 2026
a222333
✅ test: make graphviz path assertions os-agnostic
marcorusso97 Jul 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 24 additions & 1 deletion docs/docs/attacks/fc.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -147,4 +147,27 @@ FC-Attack implements a two-stage pipeline:
## Requirements

- Target model must be a **Vision-Language Model** (VLM) that supports image inputs (e.g., GPT-4o, Qwen2-VL, LLaVA, Claude 3).
- The `Graphviz` system binary (`dot`) is required for flowchart image rendering (e.g. `apt install graphviz` or `brew install graphviz`).
- `Graphviz` binary (`dot`) is required for flowchart image rendering.

### Graphviz Without Admin Permissions

If `dot` is not available in your system `PATH`, HackAgent now tries this fallback automatically:

1. Detect current OS (`Linux`/`macOS`/`Windows`).
2. Query the **latest** official Graphviz release from GitLab.
3. Download a portable archive into HackAgent's OS-specific persistent data directory:
- Linux: `~/.local/share/hackagent/graphviz` (or `$XDG_DATA_HOME/hackagent/graphviz`)
- macOS: `~/.local/share/hackagent/graphviz` (or `$XDG_DATA_HOME/hackagent/graphviz`)
- Windows: `%LOCALAPPDATA%\\hackagent\\graphviz`
4. Use that local `dot` binary for rendering.
Comment on lines +156 to +162

Environment variables:

- `HACKAGENT_GRAPHVIZ_DOT`: absolute path to a custom local `dot` binary (highest priority).
- `HACKAGENT_GRAPHVIZ_AUTO_DOWNLOAD`: set to `0` to disable automatic download fallback.

Notes:

- If Graphviz is already installed (`dot` in `PATH`), that system binary is used first.
- During `hackagent init`, HackAgent also checks for Graphviz and can prefetch portable binaries after explicit user confirmation.
- On unsupported platforms, set `HACKAGENT_GRAPHVIZ_DOT` explicitly or install Graphviz manually.
Loading
Loading