wombo 0.7.0

Image generation module. I use the dream neural network from wombo for my work.

Hello, Hello! My name is

Библиотека и CLI для работы с Wombo Dream API

Установка

# Только библиотека
pip install wombo

# Установка с CLI интерфейсом
pip install wombo[cli]

# С помощью uv
uv pip install wombo[cli]

# Для разработки из исходников
git clone https://github.com/pokedim13/wombo.git
cd wombo
uv sync --all-groups  # установка всех зависимостей
uv pip install -e .   # установка библиотеки в режиме разработки

Использование библиотеки

from wombo.api import Dream

# Создаем экземпляр Dream
dream = Dream()

# Получаем доступные стили
styles = dream.Style.get_styles()

# Генерируем изображение
task = dream.generate(
    text="Русская зима в деревне",
    style=115,  # Dreamland v3
    timeout=60
)

# Получаем URL изображения
print(task.result.final)

CLI-интерфейс

Библиотека также предоставляет CLI-интерфейс для удобного использования в командной строке.

Управление аккаунтом

# Вход в аккаунт с токеном
wombo login --token <ТОКЕН>

# Выход из аккаунта
wombo logout

# Проверка статуса авторизации
wombo status

Примечание: Если вы не авторизуетесь с собственным токеном через wombo login --token, библиотека автоматически использует анонимный токен. С анонимным токеном доступны базовые функции, но премиум-возможности ограничены. Для полного доступа рекомендуется использовать собственный токен.

Вывод доступных стилей

wombo styles

Параметры:

• --premium, -p: Показать только премиум стили
• --regular, -r: Показать только обычные стили
• --sort, -s: Сортировка (id, name) (по умолчанию id)

Примеры:

# Показать все стили
wombo styles

# Показать только премиум стили
wombo styles --premium

# Показать стили с сортировкой по имени
wombo styles --sort name

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

wombo create <ЗАПРОС> [ПАРАМЕТРЫ]

Параметры:

• --style, -s: ID стиля генерации (по умолчанию 115)
• --ratio, -r: Соотношение сторон изображения (по умолчанию old_vertical_ratio)
• --premium, -p: Использовать премиум опции
• --freq, -f: Частота обновления изображения (по умолчанию 10)
• --wait, -w: Ожидать завершения задачи
• --timeout, -t: Время ожидания в секундах при --wait (по умолчанию 60)
• --interval, -i: Интервал проверки в секундах при --wait (по умолчанию 3)
• --save: Сохранить изображение локально после генерации

Примеры:

# Создание задачи на генерацию с запросом
wombo create "Русская зима в деревне"

# Создание задачи с указанным стилем и ожиданием результата
wombo create "Осенний лес на закате" -s 46 --wait

# Создание задачи с ожиданием результата и сохранением изображения
wombo create "Космическая станция" --wait --save

Проверка статуса задачи

wombo check <TASK_ID> [ПАРАМЕТРЫ]

Параметры:

• --save: Сохранить изображение локально, если задача завершена

Примеры:

# Проверка статуса задачи
wombo check abc123xyz

# Проверка статуса и сохранение изображения, если задача завершена
wombo check abc123xyz --save

Хранение данных

Linux и macOS

• Конфигурационный файл: ~/.config/akellare/wombo/config.json
• Изображения: ~/akellare/wombo/images/

Windows

• Конфигурационный файл: %APPDATA%\akellare\wombo\config.json
• Изображения: %USERPROFILE%\Documents\akellare\wombo\images\

Использование с uv

Если вы используете uv, можно запускать команды через него:

uv run wombo styles
uv run wombo create "Ваш запрос" -s 115

См. примеры использования