Graphviz

Какую задачу решает

Рисует схему из текстового описания: шаги процесса, связи между людьми или системами, структуру отдела или сайта. Агент пишет описание на языке DOT, а Graphviz сам расставляет блоки и стрелки и сохраняет картинку в SVG, PNG или PDF.

• Раскладывает блоки и стрелки сама, координаты руками задавать не нужно. В нашем прогоне схема из шести шагов собралась в SVG за 118 мс.
• Сохраняет одну и ту же схему в SVG для сайта, PNG для документа или презентации и PDF. В нашем прогоне русские подписи нашлись и в SVG, и в тексте PDF.
• Меняет вид схемы ключом в команде, файл трогать не надо: -Grankdir=TB ставит шаги сверху вниз, -Gdpi задаёт плотность точек картинки.
• Отдаёт схему в JSON с координатами блоков и связей, если её нужно дорисовать или проверить программой.
• В нашем прогоне файл с синтаксической ошибкой дал код 1 и сообщение с номером строки, SVG не появился.

Пример результата

Установить агентом

Установи программу «Graphviz». Работай по шагам и после каждого коротко говори, что сделал.

Что это за программа (каталог smyslokod.ru, официальные источники сверены 08.10.2026):
- официальный сайт: https://graphviz.org/
- исходный код: https://gitlab.com/graphviz/graphviz
- инструкция по установке: https://graphviz.org/documentation/
- актуальная версия на 08.10.2026: 16.1.0
- лицензия: EPL-2.0
- для работы нужно (в отдельных случаях): Homebrew - на Mac Graphviz ставится через него
- для работы нужно (обязательно): Библиотеки рисования (cairo, pango, gd и другие) - apt и brew ставят их сами вместе с Graphviz. Без них модули рисования не загружаются, так было в нашем первом прогоне

Правила:
1. Ничего не устанавливай и не меняй, пока я не скажу «да» на твой план.
2. Ставь только способами из этого промпта. Сторонние сборки, скрипты с форумов и из чужих репозиториев не бери.
3. Мои проекты не трогай: не меняй их файлы, виртуальные окружения и списки зависимостей (package.json, requirements.txt, pyproject.toml).
4. Команды с sudo, правку профиля оболочки (~/.zshrc, ~/.bashrc) и переменной PATH делай только после моего отдельного «да» на каждую.
5. Не проси у меня пароли и ключи и не выводи их. Если нужен пароль администратора, дай команду, я выполню её сам.
6. Перед сборкой покажи мне описание схемы. Готовую схему проверь: на ней все шаги и подписи, число стрелок совпадает с описанием.
7. Картинки внутрь блоков (атрибут image) подключай только из папки проекта и назови мне каждый файл.
8. Готовую схему сохраняй под новым именем, существующие файлы не перезаписывай.
9. Пакеты выпуска с GitLab ставь только с моего «да», назови версию и сколько пакетов apt добавит.

Шаги:
0. Определи, где ты работаешь: мой компьютер, сервер или контейнер. Какая система и процессор, какие менеджеры пакетов есть (Homebrew, apt, winget, uv, pipx). Ставить нужно туда, где ты сам запускаешь команды.
   - на компьютере: на Mac проще через Homebrew, на Windows через winget, на Linux пакетами выпуска.
   - на сервере: окно программе не нужно. В нашем прогоне сборка схем не открыла ни одного сетевого соединения.
   - в контейнере: мы проверяли в контейнере Ubuntu 24.04. Для русских подписей нужен шрифт с кириллицей. В нашем контейнере был DejaVu Sans, он встроен в готовый PDF.
1. Проверь, не стоит ли программа уже: dot -V ; which -a dot. Если стоит и запускается, ничего не ставь и переходи к шагу 5.
2. Проверь, что есть всё нужное для работы: Библиотеки рисования (cairo, pango, gd и другие). Чего нет, внеси в план отдельным пунктом. Проверь свободное место на диске: нужно Пакеты graphviz и libgraphviz4 16.1.0 по данным dpkg занимают 5007 КБ и 2894 КБ. В чистом контейнере Ubuntu 24.04 apt поставил с ними 201 пакет, по его подсчёту это 561 МБ. Если библиотеки рисования уже стоят, выйдет меньше. Архив выпуска весит 18 684 112 байт. Сколько займёт установка через Homebrew или winget, мы не мерили..
3. Составь план: каким одним способом из списка ниже будешь ставить, что появится на диске и сколько места займёт, что поменяется в системе и как потом удалить. Покажи план и жди моего «да».
   Способы из официальных источников:
   - macOS, Homebrew: brew install graphviz (команда со страницы загрузки, формулу ведёт Homebrew. Ставит текущую версию из формулы, на 08.10.2026 это 16.1.0, вместе с библиотеками cairo, pango, gd и другими. На Mac мы не проверяли)
   - Windows, winget: winget install --id Graphviz.Graphviz (страница загрузки называет winget. По манифесту winget ставит установщик 16.1.0 с GitLab для всех пользователей компьютера. На Windows мы не проверяли)
   - Linux, пакеты выпуска с GitLab (Ubuntu 24.04): curl -LO https://gitlab.com/api/v4/projects/4207231/packages/generic/graphviz-releases/16.1.0/ubuntu_24.04_graphviz-16.1.0-debs.tar.xz && mkdir -p graphviz-debs && tar -xJf ubuntu_24.04_graphviz-16.1.0-debs.tar.xz -C graphviz-debs && sudo apt-get install ./graphviz-debs/graphviz_16.1.0-1_amd64.deb ./graphviz-debs/libgraphviz4_16.1.0-1_amd64.deb (так мы ставили в прогоне. Архив для x86_64 с выпуска на GitLab, у сервера в ответе есть контрольная сумма sha256. Остальные библиотеки apt ставит сам: в чистом контейнере это был 201 пакет и 561 МБ. Для Ubuntu 22.04 и 26.04 у выпуска свои архивы)
4. Установи по согласованному плану. Если что-то идёт не так, как в плане, остановись и спроси.
5. Проверь результат:
   - dot -V: программа запускается без ошибки;
   - Сделай файл process.dot: шесть шагов обработки заявки с подписями по-русски и шесть стрелок. Нарисуй схему в SVG, PNG и PDF, вариант сверху вниз через -Grankdir=TB и JSON. Проверь, что в SVG и JSON шесть блоков и шесть связей, все подписи на месте, текст есть в PDF. Убедись, что файл с ошибкой даёт код 1 и картинки нет. Сверь контрольную сумму process.dot до и после. Делай это во временной папке и не трогай мои файлы.
     dot -V
     dot -Tsvg docs/process.dot -o docs/process.svg
     dot -Tpng -Gdpi=150 docs/process.dot -o docs/process.png
     dot -Tpdf docs/process.dot -o docs/process.pdf
     dot -Tjson docs/process.dot -o docs/process.json
     dot -Grankdir=TB -Tpng docs/process.dot -o docs/process-tb.png
     dot -Tsvg docs/broken.dot -o docs/broken.svg
     pdftotext docs/process.pdf -
   - если ты работаешь в папке моего проекта, покажи git status: от установки в проекте не должно появиться изменений.
6. Итог одним сообщением: что установлено, какой версии и куда, сколько места заняло, что поменялось в системе и как всё удалить (macOS, Homebrew: brew uninstall graphviz; Windows, winget: winget uninstall --id Graphviz.Graphviz; Linux, пакеты выпуска с GitLab (Ubuntu 24.04): sudo apt-get remove graphviz libgraphviz4).

Если на любом шаге ошибка, не чини наугад: покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://smyslokod.ru/cli/graphviz#problemy

Промпт собран из официальных инструкций, сверенных 08.10.2026. Агент сначала проверит, что уже стоит, покажет план с местом на диске и способом удаления и без твоего «да» ничего не поставит.

Как ставят вручную

Способы из официальных источников, у каждого ссылка на первоисточник.

• macOS · Homebrew · источник

  brew install graphviz

  команда со страницы загрузки, формулу ведёт Homebrew. Ставит текущую версию из формулы, на 08.10.2026 это 16.1.0, вместе с библиотеками cairo, pango, gd и другими. На Mac мы не проверяли

• Windows · winget · источник

  winget install --id Graphviz.Graphviz

  страница загрузки называет winget. По манифесту winget ставит установщик 16.1.0 с GitLab для всех пользователей компьютера. На Windows мы не проверяли

• Linux · пакеты выпуска с GitLab (Ubuntu 24.04) · источник

  curl -LO https://gitlab.com/api/v4/projects/4207231/packages/generic/graphviz-releases/16.1.0/ubuntu_24.04_graphviz-16.1.0-debs.tar.xz && mkdir -p graphviz-debs && tar -xJf ubuntu_24.04_graphviz-16.1.0-debs.tar.xz -C graphviz-debs && sudo apt-get install ./graphviz-debs/graphviz_16.1.0-1_amd64.deb ./graphviz-debs/libgraphviz4_16.1.0-1_amd64.deb

  так мы ставили в прогоне. Архив для x86_64 с выпуска на GitLab, у сервера в ответе есть контрольная сумма sha256. Остальные библиотеки apt ставит сам: в чистом контейнере это был 201 пакет и 561 МБ. Для Ubuntu 22.04 и 26.04 у выпуска свои архивы

Как удалить

• macOS, Homebrew: brew uninstall graphviz
• Windows, winget: winget uninstall --id Graphviz.Graphviz
• Linux, пакеты выпуска с GitLab (Ubuntu 24.04): sudo apt-get remove graphviz libgraphviz4

Что нужно для работы

• Homebrew (в отдельных случаях) - на Mac Graphviz ставится через него
• Библиотеки рисования (cairo, pango, gd и другие) (обязательно) - apt и brew ставят их сами вместе с Graphviz. Без них модули рисования не загружаются, так было в нашем первом прогоне

Системы

• macOS - ставится через Homebrew, по формуле готовые сборки есть для Mac на Apple silicon. На Mac мы Graphviz не ставили и не запускали.
• Windows - у выпуска есть установщики EXE и архивы ZIP для 32 и 64 бит, по манифесту winget ставит этот установщик для всех пользователей компьютера. На Windows мы не проверяли.
• Linux - у выпуска на GitLab есть пакеты для Ubuntu 22.04, 24.04 и 26.04, Fedora и Rocky Linux. В пакетных источниках дистрибутивов Graphviz тоже есть, версия там бывает намного старше.

Где запускать

Ставить нужно туда, где работает агент: на твой компьютер, сервер или в контейнер.

• На компьютере - на Mac проще через Homebrew, на Windows через winget, на Linux пакетами выпуска.
• На сервере - окно программе не нужно. В нашем прогоне сборка схем не открыла ни одного сетевого соединения.
• В контейнере - мы проверяли в контейнере Ubuntu 24.04. Для русских подписей нужен шрифт с кириллицей. В нашем контейнере был DejaVu Sans, он встроен в готовый PDF.

Сколько ресурсов нужно

Место на диске

Пакеты graphviz и libgraphviz4 16.1.0 по данным dpkg занимают 5007 КБ и 2894 КБ. В чистом контейнере Ubuntu 24.04 apt поставил с ними 201 пакет, по его подсчёту это 561 МБ. Если библиотеки рисования уже стоят, выйдет меньше. Архив выпуска весит 18 684 112 байт. Сколько займёт установка через Homebrew или winget, мы не мерили.

Видеокарта

В нашем прогоне видеокарта не понадобилась.

Сеть

Для установки нужна сеть: архив скачивался с gitlab.com, остальные пакеты apt брал с archive.ubuntu.com и security.ubuntu.com. В прогоне apt ещё обращался к deb.nodesource.com, этот источник Node.js прописан в образе песочницы, Graphviz он не нужен. Во время сборки схем Graphviz не открыла ни одного соединения.

Схема из шести шагов собралась в SVG за 118 мс.

Лицензия и платные замены

Лицензия EPL-2.0. Eclipse Public License 2.0, так написано в файле LICENSE проекта и на странице лицензии сайта. Платной версии у Graphviz нет. В каталоге Homebrew у формулы стоит EPL-1.0, мы называем лицензию по файлу проекта. Текст лицензии

Цена: Бесплатно. Бесплатная, платных тарифов и платной версии у проекта нет.

Платные замены

Платной версии у Graphviz нет: на сайте проекта только свободная лицензия и бесплатные пакеты для всех систем.

Бесплатные замены

• Mermaid CLI - Рисует схемы из текста на языке Mermaid в SVG, PNG и PDF. Работает через браузер Chrome, который скачивает при установке, у нас есть её карточка.
• PlantUML - Рисует схемы из текста на своём языке. По документации PlantUML для схем классов, состояний и ещё нескольких видов ему нужен установленный Graphviz.

О чём помнить

• Безопасность. Агент запускает dot в терминале сам (exec). Программа читает файл схемы и картинки, которые он подключает атрибутом image: если атрибут imagepath не задан, по документации относительный путь считается от текущей рабочей папки, а с imagepath картинку ищут в названных в нём папках (read). Готовую схему пишет с правами пользователя туда, куда велит ключ -o, без -o выводит в терминал (write). Сеть при сборке не нужна, входа в аккаунты и ключей Graphviz не просит.
• Схему из чужого файла лучше собирать через dot_sandbox из того же пакета: по его описанию он закрывает программе сеть и запись на диск, поэтому готовую схему выводит в терминал. На Linux ему нужна программа bwrap, в нашем контейнере её не было, и dot_sandbox ответил «no usable sandbox found».
• В обычном репозитории Ubuntu 24.04 лежит 2.42.2, поэтому apt install graphviz ставит её. Для прогона 16.1.0 мы ставили пакеты выпуска с GitLab. Если стоят обе копии, which -a dot покажет, какая вызывается.
• Для русских подписей в системе должен быть шрифт с кириллицей, имя шрифта задают в описании (fontname).

Частые проблемы

Проверка

✓ Проверено 08.10.2026: Ubuntu 24.04.5 (x86_64) в одноразовом контейнере Docker на сервере: Graphviz 16.1.0 из пакетов выпуска на GitLab, для проверки PDF poppler-utils из apt.

«Проверено» ставим, только когда сами поставили программу и прогнали её на задаче. Сверка ссылок и вывод версии так не называются.

Похожие программы

• Mermaid CLIРисует схему процесса из короткого текста и сохраняет её в SVG, PNG или PDF. В Markdown меняет блоки mermaid на готовые картинки.
• ImageMagickСжимает картинки и переводит их в WebP, меняет размер, делает обложки с надписью и водяные знаки. Агенту нужна, чтобы обработать всю папку картинок сайта за один раз.
• TypstСобирает PDF из текстовой разметки: счёт, КП, отчёт. Данные берёт из JSON или CSV и сама считает итоги по формулам шаблона.