claude-paint CLI

Симулятор масляной живописи на Rust и мольберт с MCP-адаптером: агент рисует кистями, смешивает краски на палитре и смотрит холст

  • 158 ★ репозитория
  • Последний коммит
  • MIT
CLI

Расширенный доступ

Почему такой уровень

  • Мольберт исполняет код на Lua, который пишет агент, и записывает файлы холста и журналов
  • Удаленный HTTP-адаптер открывает сервис наружу и требует аутентификации
Все причины и проверки

aliceisjustplaying/claude-paint

Установка

Ручная установка

Текст для агента

Установи Rust, компилятор C, Python 3.10 или новее, uv и Perl и выполни `cargo build --release -p easel`. Подготовь студию командой `scripts/prepare_capy_studio <профиль> <путь> --brief <BRIEF.md> --studio-notes <заметки>`, она выведет JSON с командой запуска MCP по stdio. Подключи этот сервер к агенту и используй инструменты `paint`, `look`, `note`, `status`, `log`.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Мольберт исполняет код на Lua, который пишет агент, и записывает файлы холста и журналов
  • Удаленный HTTP-адаптер открывает сервис наружу и требует аутентификации

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

claude-paint — проект художника-программиста, где агент учится писать маслом на симуляторе. Движок на Rust моделирует щетинную кисть, которая переносит влажную краску по загрунтованному льняному холсту. Краска выравнивается и сохнет по часам, а слои смешиваются по оптике Кубелки и Мунка. Цвет берется только из куч, смешанных мастихином из именованных тюбиков. Мольберт `easel` — это живая сессия на Lua поверх движка. Адаптер MCP в `harness/easel_mcp` открывает агенту пять инструментов: `paint` (выполнить код на Lua), `look` (получить PNG холста с подписью), `note` (запись в журнал), `status` и `log`. Паузы `wait(minutes)` остаются кодом на Lua внутри `paint`. Скрипт `scripts/prepare_capy_studio` экспортирует студию с утвержденным брифом и печатает JSON с командой запуска MCP по stdio. Для художника, мольберт и поток которого остаются на Mac, есть удаленный HTTP-адаптер с аутентификацией. В `notes/` лежат руководство по мольберту, приемы (планирование, лессировка, скамблинг) и исследовательские заметки о материалах. Готовые картины хранятся в отдельных репозиториях автора.

Для кого. Исследователям и художникам, которые изучают, как агенты работают с физическим творческим инструментом, и разработчикам, которым нужен пример MCP-адаптера для сессии на Lua.

Подходит, если

  • Хочется посмотреть, как модель пишет картину по брифу, с журналом, таймлапсом и итоговым изображением
  • Нужен пример MCP-сервера, который отдает агенту изображения холста вместе с подписью
  • Требуется движок с честной моделью мазка, высыхания слоев и смешивания пигментов
  • Необходимо удаленно запускать мольберт на Mac и подключать к нему агента по HTTP с аутентификацией

Не подходит, если

  • Нужен обычный генератор изображений по описанию: здесь пошаговая живопись через код
  • Нужен быстрый результат в один запрос: картина создается долгими сеансами мазков
  • Нужна сборка без Rust: потребуется компилятор Rust, C, Python, uv и Perl

Пример запроса к агенту

Подключи easel как MCP-сервер и нарисуй небольшой этюд по брифу: сначала смешай краски из тюбиков, потом посмотри холст

Ограничения

Сборка требует Rust, компилятор C, Python 3.10 или новее, uv и Perl. Проект ориентирован на конкретный исследовательский процесс (раунды, студии, раннеры), многие скрипты завязаны на авторские пути и инфраструктуру, так что запускать их без адаптации не получится. Картины, журналы и записи сессий лежат в отдельных репозиториях, один из которых закрытый.

Мольберт выполняет код на Lua и записывает холст на диск. Для просмотра студии используется сервис `studio/studio.py`, который автор запускает как фоновые службы launchd. В README стоит метка о запрете использовать данные бенчмарка при обучении моделей.

Как отключить. Остановите MCP-сервер в конфигурации агента и удалите клон репозитория вместе с каталогом `target/`. Журналы и холсты лежат в папках студии, которую вы создавали.

Частые вопросы

Какие инструменты видит агент?

Пять: `paint` выполняет Lua в сессии, `look` возвращает PNG холста с подписью, `note` пишет в журнал, `status` и `log` показывают состояние и историю.

Как собрать проект?

Выполните `cargo build --release -p easel` и получите бинарник `target/release/easel`. Проверки запускает `scripts/test`.

Как подключить к агенту?

`scripts/prepare_capy_studio` экспортирует студию и печатает JSON с командой, аргументами, рабочей папкой и окружением для запуска MCP по stdio. Эти данные регистрируются в настройках агента.

Как краска моделируется физически?

Щетинная кисть переносит влажную краску по холсту, слой выравнивается и сохнет по часам, а смешение слоев считается по оптике Кубелки и Мунка.

Где посмотреть готовые картины?

В отдельном публичном репозитории автора stillwet-paintings-public и на сайте stillwet.art.

Обсуждение

Вопросов и отзывов пока нет.

Навык превращает Claude в пиксельного художника: каждый пиксель ставится кодом на Pillow, а результат проверяется по чек-листу.

СкиллРасширенный доступ113Звезды репозитория

MCP-сервер дает агенту 123 инструмента Aseprite для пиксель-арта и анимации и снимки, по которым он проверяет рисунок

MCP-серверШирокий доступ987Звезды репозитория
Официальный

Настольный редактор Scumble с MCP-сервером на 119 инструментов: агент открывает, выделяет, генерирует и экспортирует картинки.

MCP-серверРасширенный доступ176Звезды репозитория

Плагин и MCP-сервер дают агенту рисовать и анимировать в уже открытом окне Aseprite, каждое действие откатывается одним Ctrl+Z

ПлагинРасширенный доступ680Звезды репозитория

Pixelbolt дает агенту рисовать и править пиксель-арт по JSON-рецепту: спрайты, тайлы, эффекты и анимации в PNG, GIF и атласы.

ПлагинМинимальный доступ86Звезды репозитория

Маркетплейс Codex с тремя творческими плагинами: рисунок черной ручкой, пиксельные частицы и акварельные дудлы

ПлагинРасширенный доступ292Звезды репозитория

Коротко о README

Репозиторий содержит движок, мольберт, раннер, скрипты, тесты и заметки. Записи картин вынесены в отдельные репозитории. Автор описывает порядок работы через раунды (теги и папки), экспорт студии и просмотр сеансов живописи вживую или в записи.

Бейдж для README

Сообщить о проблеме