pictlang

Generate SVG images from a theme and style via an LLM-written Python DSL.

_{strict geometry, flat colors}	_{neon lines, glitch}	_{minimalism, 3 colors}
_{soft gradients, opacity}	_{white outline on deep blue}

🇷🇺 Русский

pictlang

Генерирует SVG-изображения по теме и стилю через Python-DSL, который пишет LLM.

Что это

pictlang отправляет модели запрос с темой и стилем, получает Python-функцию render() и исполняет её в песочнице. Функция использует небольшой DSL для рисования, а не пишет SVG напрямую. Результат — валидный SVG-файл.

Подход с DSL даёт три вещи:

Экономия токенов. Сцена на DSL в 15–30 раз короче, чем та же сцена в чистом SVG. Циклы и функции сворачивают сотни повторяющихся элементов в несколько строк.
Валидация до исполнения. Мы проверяем AST на «ровно один render(), без импортов, без side effects» до запуска.
Безопасность. DSL — закрытый набор функций. Модель не может выдать <script> или внешние ссылки.

Подробности — в docs/architecture.md.

Установка

pip install pictlang

Опциональные зависимости:

pip install "pictlang[optimize]"   # scour для оптимизации SVG
pip install "pictlang[socks]"      # поддержка SOCKS5-прокси
pip install "pictlang[all]"        # всё сразу

Быстрый старт

Создайте конфиг и впишите свой API-ключ:

pictlang init --global
# отредактируйте ~/.config/pictlang/config.json

Сгенерируйте картинку:

pictlang "lighthouse in the fog" --style "minimalism, three colors"

Пример вывода

UUID: 550e8400-e29b-41d4-a716-446655440000
SVG:  generated/valid/svg/550e8400-....svg
PY:   generated/valid/py/550e8400-....py
META: generated/valid/meta/550e8400-....json

UUID печатается в конце — по нему можно найти файлы позже.

CLI

Флаг	Что делает
`THEME`	Что рисовать (позиционный аргумент)
`--style STYLE`	Как рисовать (обязателен)
`--save valid\|all\|py\|svg`	Что сохранять (по умолчанию `valid`)
`--optimize` / `--no-optimize`	Включить/выключить оптимизацию SVG
`--optimizer auto\|scour\|svgo`	Какой оптимизатор использовать
`--keep-original`	Сохранить SVG до оптимизации
`--model NAME`	Переопределить модель
`--base-url URL`	Переопределить endpoint
`--proxy URL`	Прокси (http/https/socks5)
`--config PATH`	Путь к конфигу
`--check`	Проверить конфиг и соединение с API

Отдельные команды:

Команда	Что делает
`pictlang init [--global] [--path]`	Создать шаблон конфига
`pictlang render [uuid] [--force]`	Перегенерировать SVG из `.py` без обращения к API

Конфигурация

pictlang читает конфиг из:

--config PATH, если задан.
./pictlang.json в текущей директории.
Пользовательской директории:
- Linux: ~/.config/pictlang/config.json
- macOS: ~/Library/Application Support/pictlang/config.json
- Windows: %APPDATA%\limloop\pictlang\config.json
Встроенных значений по умолчанию.

Пример — в pictlang.json.example.

Документация

docs/dsl.md — полный справочник по DSL.
docs/architecture.md — как устроен pipeline.
docs/prompt.md — как писать свои промпты.

Разработка

git clone https://github.com/limloop/pictlang.git
cd pictlang
pip install -e ".[dev]"
pytest

Лицензия

Apache 2.0. См. LICENSE.

🇬🇧 English

pictlang

Generate SVG images from a theme and style via an LLM-written Python DSL.

What it is

pictlang sends a theme and a style to a model, receives a Python function render(), and runs it in a sandbox. The function uses a small drawing DSL instead of writing SVG directly. The result is a valid SVG file.

The DSL approach gives three things:

Token efficiency. A scene in the DSL is 15–30× shorter than the same scene in raw SVG. Loops and functions collapse hundreds of repeated elements into a few lines.
Validation before execution. We check the AST for "exactly one render(), no imports, no side effects" before running anything.
Safety. The DSL is a closed set of functions. The model cannot emit <script> or external references.

See docs/architecture.md for details.

Install

pip install pictlang

Optional extras:

pip install "pictlang[optimize]"   # scour for SVG optimization
pip install "pictlang[socks]"      # SOCKS5 proxy support
pip install "pictlang[all]"        # everything

Quick start

Create a config and set your API key:

pictlang init --global
# edit ~/.config/pictlang/config.json

Generate an image:

pictlang "lighthouse in the fog" --style "minimalism, three colors"

Example output

UUID: 550e8400-e29b-41d4-a716-446655440000
SVG:  generated/valid/svg/550e8400-....svg
PY:   generated/valid/py/550e8400-....py
META: generated/valid/meta/550e8400-....json

The UUID is printed at the end — use it to find the files later.

CLI

Flag	What it does
`THEME`	What to draw (positional)
`--style STYLE`	How to draw it (required)
`--save valid\|all\|py\|svg`	What to persist (default `valid`)
`--optimize` / `--no-optimize`	Enable/disable SVG optimization
`--optimizer auto\|scour\|svgo`	Which optimizer to use
`--keep-original`	Save the SVG before optimization
`--model NAME`	Override the model
`--base-url URL`	Override the endpoint
`--proxy URL`	Proxy (http/https/socks5)
`--config PATH`	Path to a config file
`--check`	Validate config and test API connectivity

Subcommands:

Command	What it does
`pictlang init [--global] [--path]`	Write a template config
`pictlang render [uuid] [--force]`	Re-render `.svg` from `.py` without calling the API

Configuration

pictlang reads configuration from:

--config PATH, if given.
./pictlang.json in the current directory.
The platform user-config directory:
- Linux: ~/.config/pictlang/config.json
- macOS: ~/Library/Application Support/pictlang/config.json
- Windows: %APPDATA%\limloop\pictlang\config.json
Built-in defaults.

See pictlang.json.example for a template.

Documentation

docs/dsl.md — full DSL reference.
docs/architecture.md — how the pipeline works.
docs/prompt.md — how to write custom prompts.

Development

git clone https://github.com/limloop/pictlang.git
cd pictlang
pip install -e ".[dev]"
pytest

License

Apache 2.0. See LICENSE.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pictlang-0.2.0.tar.gz (56.1 kB view details)

Uploaded Sep 10, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pictlang-0.2.0-py3-none-any.whl (45.7 kB view details)

Uploaded Sep 10, 2026 Python 3

File details

Details for the file pictlang-0.2.0.tar.gz.

File metadata

Download URL: pictlang-0.2.0.tar.gz
Upload date: Sep 10, 2026
Size: 56.1 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pictlang-0.2.0.tar.gz
Algorithm	Hash digest
SHA256	`1063ae4bd1ff6043e0a31226f6e5e503a6325c0efe53d0af233f5f8e57b57b8c`
MD5	`b28a0de19548fa845466c5e529322244`
BLAKE2b-256	`0da6d0eb3968e48af81b9f8bd75b842aa16265902c19f8e04783f9b172888275`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pictlang-0.2.0.tar.gz:

Publisher: publish.yml on limloop/pictlang

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pictlang-0.2.0.tar.gz
- Subject digest: 1063ae4bd1ff6043e0a31226f6e5e503a6325c0efe53d0af233f5f8e57b57b8c
- Sigstore transparency entry: 2788530622
- Sigstore integration time: Sep 10, 2026
Source repository:
- Permalink: limloop/pictlang@d4f7e7cb273670f1c3463cce841e259d5f071fa0
- Branch / Tag: refs/tags/v0.2.0
- Owner: https://github.com/limloop
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@d4f7e7cb273670f1c3463cce841e259d5f071fa0
- Trigger Event: release

File details

Details for the file pictlang-0.2.0-py3-none-any.whl.

File metadata

Download URL: pictlang-0.2.0-py3-none-any.whl
Upload date: Sep 10, 2026
Size: 45.7 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pictlang-0.2.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`6da1148bd9a2e233ce7e892e7ec79a362d9eb2b2e833cfbd91cd480152b82dc8`
MD5	`b28b05fae714df123ef73a3a226a0518`
BLAKE2b-256	`f9308d1e92c2fbedc512e2f702749d5c379e464b472f1e40667a877ff53c2140`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pictlang-0.2.0-py3-none-any.whl:

Publisher: publish.yml on limloop/pictlang

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pictlang-0.2.0-py3-none-any.whl
- Subject digest: 6da1148bd9a2e233ce7e892e7ec79a362d9eb2b2e833cfbd91cd480152b82dc8
- Sigstore transparency entry: 2788530691
- Sigstore integration time: Sep 10, 2026
Source repository:
- Permalink: limloop/pictlang@d4f7e7cb273670f1c3463cce841e259d5f071fa0
- Branch / Tag: refs/tags/v0.2.0
- Owner: https://github.com/limloop
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@d4f7e7cb273670f1c3463cce841e259d5f071fa0
- Trigger Event: release

Release history Release notifications | RSS feed

0.2.1

Sep 11, 2026 2 files

This release

0.2.0 This release

Sep 10, 2026 2 files

pictlang 0.2.0

pictlang

pictlang

Что это

Установка

Быстрый старт

Пример вывода

CLI

Конфигурация

Документация

Разработка

Лицензия

pictlang

What it is

Install

Quick start

Example output

CLI

Configuration

Documentation

Development

License

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License expression

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed