Zator: туториал для новичков

Zator — это специализированный язык (DSL), предназначенный для создания AI-генеративных пайплайнов: текста, изображений и постобработки.

Он работает поверх API сервера KoboldCpp, который запускает:

LLM (генерация текста)
Stable Diffusion (генерация изображений)

Zator превращает сложные сценарии вроде:

HTTP-запросов
JSON
base64
файловых операций

в короткий декларативный код.

Например:

var img = generate_img("elf warrior", context, 512, 512) save_img(img, "elf.png")

В Python это потребовало бы десятки строк.

Система состоит из трёх компонентов.

Zator script ↓ Zator interpreter ↓ KoboldCpp API ↓ LLM / Stable Diffusion

парсит .zator
вызывает API
обрабатывает изображения
сохраняет результаты

Интерпретатор не содержит моделей — только клиент. Скачать можно с официального сайта (zapor.2bd.net).

Контекст определяет роль модели.

context = "You are a fantasy writer"

Это автоматически добавляется к каждому prompt.

Всего 3 типа:

string - текст (строка)
int - число
image - изображение

Основная функция:

generate_text(prompt, context, tokens)

Пример:

context = "You are a sci-fi writer" var story = generate_text( "Write a story about AI city", context, 300)

Под капотом вызывается API:

/api/v1/generate

KoboldCpp управляет параметрами:

temperature
top_p
repetition penalty

Функция:

generate_img(prompt, context, width, height)

Пример:

var img = generate_img( "portrait of cyberpunk hacker", context, 512, 512 )

Под капотом вызывается:

/sdapi/v1/txt2img

Zator умеет изменять базовую графику прямо в пайплайне.

image = chroma_key_crop(image, 0, 0, 5.0)

Удаляет зелёный фон.

scale_to(image, width, height)

Позволяют формировать динамические промпты.

var character = "elf" var prompt = "portrait of {character} warrior"

В новых версиях поддерживается def.

def create_portrait(name) { var prompt = "portrait of {name}" var img = generate_img(prompt, context, 512, 512) } call create_portrait("💀")

Функция:

request()

Позволяет интегрироваться с:

Telegram
Discord
Webhooks
REST API

exec_cmd()

Позволяет:

запускать скрипты
копировать файлы
запускать ffmpeg
выполнять shell команды

Задача:

Сгенерировать:

персонажа
иконку
спрайт

context = "You are a pixel art game artist" var enemy = "goblin alchemist" var sprite = generate_img( "pixel art {enemy} with green background", context, 512, 512 ) var icon = scale_to(sprite, 64, 64) save_img(sprite, "enemy.png") save_img(icon, "enemy_icon.png")

Генерирует арт
Масштабирует
Сохраняет ассеты

Это полностью автоматическая генерация контента для игры.

Язык подходит для:

генерации игровых ассетов
AI-контента
генерации иллюстраций
автоматизации соцсетей
прототипирования AI-pipeline

Не подходит для:

backend разработки
сложной логики
системного программирования
data processing

1. Что такое Zator

2. Архитектура Zator

Что делает интерпретатор

3. Основные концепции языка

Контекст

Типы данных

4. Генерация текста

5. Генерация изображений

6. Постобработка изображений

Хромакей

Масштабирование

7. F-строки

8. Пользовательские функции

9. HTTP интеграция

10. Системные команды

Пример интеграции

Генерация ассетов для игры

Скрипт

Что делает данный pipeline

Когда использовать Zator

Когда НЕ использовать