gpu-rent/README.md

gpu-rent

Локальный CLI: прерываемый GPU в Selectel, SwarmUI через туннель на localhost:17801. Модели живут на сетевых дисках.

Сначала ключи и квота — не up. Пошагово: docs/setup.md.

Спецификация: docs/. Решения: docs/decisions.md.

Что уже можно запустить

python -m venv .venv
.\.venv\Scripts\activate
python -m pip install -U pip
python -m pip install -e ".[dev]"
copy env.example $env:USERPROFILE\.gpu-rent\.env
# заполни OS_* по docs/setup.md
gpu-rent doctor
gpu-rent dry-run
gpu-rent status

up / stop / tunnel пока не создают сервер: сначала doctor должен быть зелёным и квота GPU > 0.

Зачем какие ключи

Что	Зачем	Как получить
Сервисный пользователь Selectel + пароль	OpenStack: VM, диски, сеть. IAM-токен на 24 ч CLI берёт сам	IAM → Service users. Не X-Token из профиля
OS_PROJECT_ID, номер аккаунта, пул, AZ	Scope токена и куда ставить GPU	RC-файл с вкладки Access + матрица GPU
Тикет в поддержку	Лимит GPU часто 0	Текст в docs/setup.md
Civitai API token	Seed моделей	civitai.com/user/account → API Keys
GitHub PAT	Только приватные репы в extensions.yaml	Fine-grained, Contents: Read

Статический X-Token панели не умеет создавать облачные серверы.

Продукт

• GPU по умолчанию preemptible; гасится stop или idle-killer на VM (hold откладывает killer).
• Первый диск: модели с Civitai по models.yaml, если задан API-токен; иначе дефолт SwarmUI.
• Локальные папки: непустые Models/, Wildcards/, CustomWorkflows/ едут на up; Output/ можно забрать (PULL_OUTPUT).
• Расширения: git-репы из extensions.yaml на первый bootstrap.
• Autocomplete: Data/Autocompletions + проверка новой версии csv на каждом up.
• doctor до create; фоллбек GPU flavor; toast когда UI готов; open на 17801.
• Локальный SwarmUI на порту 7801 не занимает.
• Прерывание хостером: EXPIRED → unshelve.

Лицензия MIT. Секреты и веса в git не класть.