first commit

2026-08-21 02:42:48 +03:00
commit 167d07a733
46 changed files with 3334 additions and 0 deletions
@@ -0,0 +1,37 @@
+# Документация gpu-rent
+
+CLI-оркестратор: поднимает прерываемый GPU-сервер в Selectel, монтирует постоянные сетевые диски и открывает SwarmUI на `localhost` через SSH-туннель. Платим за GPU только пока идёт сессия; модели и ComfyUI живут на диске.
+
+Код в разработке: каркас CLI и `doctor` есть. GPU всё ещё не создаём, пока нет квоты и зелёного `doctor`. Что сделать руками до этого — [setup.md](setup.md).
+
+## Как читать
+
+| Документ | Зачем |
+| --- | --- |
+| [setup.md](setup.md) | **С чего начать:** квота GPU, сервисный пользователь, Civitai, установка CLI |
+| [concept.md](concept.md) | Задача, границы, модель стоимости |
+| [decisions.md](decisions.md) | Зафиксированные решения |
+| [architecture.md](architecture.md) | Компоненты, диски, стейт-машина, idle-killer |
+| [selectel.md](selectel.md) | Контракт с облаком: auth, API, GPU, preemptible, сеть |
+| [models.md](models.md) | Первый seed с Civitai, манифест, пропуск дефолта SwarmUI |
+| [extensions.md](extensions.md) | Git-репы SwarmUI-расширений и ComfyUI nodes |
+| [autocomplete.md](autocomplete.md) | Word-list промптов, Settings.fds, проверка версии |
+| [local-folders.md](local-folders.md) | `Models/` / `Wildcards/` / `CustomWorkflows/` push, optional `Output/` pull |
+| [swarmui.md](swarmui.md) | Нативный install, порт 7801, API, MCP |
+| [cli.md](cli.md) | Команды, конфиг, локальный state |
+| [roadmap.md](roadmap.md) | Порядок реализации |
+| [open-questions.md](open-questions.md) | Ещё не закрыто |
+
+## Источники
+
+Проверено 21 августа 2026:
+
+- [Selectel: preemptible servers](https://docs.selectel.ru/en/cloud-servers/about/preemptible-servers/)
+- [Selectel: GPU](https://docs.selectel.ru/en/cloud-servers/create/gpus/)
+- [Selectel: GPU images / drivers](https://docs.selectel.ru/en/cloud-servers/manage/install-gpu-drivers/)
+- [Selectel: IAM / API auth](https://docs.selectel.ru/en/api/authorization/)
+- [Selectel: restore preemptible](https://docs.selectel.ru/en/cloud-servers/manage/restore-preemptible-server/)
+- [SwarmUI](https://github.com/mcmonkeyprojects/SwarmUI) (нативный Linux, порт 7801)
+- [Civitai Site API](https://developer.civitai.com/) (download + metadata; API есть и на `.red`)
+- [Civitai: два входа .com / .red](https://civitai.com/articles/28369/two-front-doors-civitaicom-civitaired-and-whats-next)
+- [SwarmUI Autocompletions](https://github.com/mcmonkeyprojects/SwarmUI/blob/master/docs/Features/Autocompletions.md)