# Документация gpu-rent

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

## С чего начать

1. **[setup.md](setup.md)** — квота, ключи, `.env`, первый `doctor` → `up` → `stop`
2. Корневой **[README](../README.md)** — быстрый старт и обычный день
3. При первом живом GPU заполни **[spike-notes.md](spike-notes.md)** (времена, цены из панели)

Дальше — по задаче.

## По задачам

| Хочу… | Документ |
| --- | --- |
| Понять зачем и сколько стоит | [concept.md](concept.md) |
| Все команды и `.env` | [cli.md](cli.md) |
| Debug API / Assistent curl | [cli.md](cli.md) (раздел Debug API) |
| Модели с Civitai / `Models/` | [models.md](models.md) |
| Civitai scrape → FTS Assistent | [../datasets/README.md](../datasets/README.md) |
| Git-расширения / personas | [extensions.md](extensions.md) (`seed-personas`) |
| Word-list промптов | [autocomplete.md](autocomplete.md) |
| Push/pull папок | [local-folders.md](local-folders.md) |
| Ollama + Assistent | [llm.md](llm.md) |
| Capture ссылок с VM | [cli.md](cli.md) (`capture`) + [models.md](models.md) |
| Баланс ₽ (X-Token панели) | [cli.md](cli.md) / [decisions.md](decisions.md) (`SELECTEL_API_TOKEN`) |
| Как устроены диски и killer | [architecture.md](architecture.md) |
| Контракт Selectel | [selectel.md](selectel.md) |
| Нативный SwarmUI на VM | [swarmui.md](swarmui.md) |
| Зафиксированные решения | [decisions.md](decisions.md) |
| Статус реализации | [roadmap.md](roadmap.md) |
| Что ещё проверить на spike | [open-questions.md](open-questions.md) |

Ревью кода: `docs/reviews/` (для разработки, не для первого запуска). Это **замороженные снимки** от 21.08.2026 — могут противоречить текущему коду (не источник правды).

## Источники (Selectel / SwarmUI / Civitai)

Проверено 23 августа 2026:

- [Selectel: preemptible](https://docs.selectel.ru/en/cloud-servers/about/preemptible-servers/)
- [Selectel: GPU](https://docs.selectel.ru/en/cloud-servers/create/gpus/)
- [Selectel: GPU drivers](https://docs.selectel.ru/en/cloud-servers/manage/install-gpu-drivers/)
- [Selectel: 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)
- [Civitai Site API](https://developer.civitai.com/)
- [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)