gpuhire 0.2.0__py3-none-any.whl

gpuhire-0.2.0.dist-info/METADATA

@@ -0,0 +1,247 @@
+Metadata-Version: 2.5
+Name: gpuhire
+Version: 0.2.0
+Summary: Один CLI для GPU-задач на Kaggle, Modal, Colab, Vast, Lightning, Beam і Saturn: подати, стежити, забрати, не переплатити
+Project-URL: Homepage, https://github.com/SERGIUSH-UA/gpurunner
+Project-URL: Source, https://github.com/SERGIUSH-UA/gpurunner
+Project-URL: Issues, https://github.com/SERGIUSH-UA/gpurunner/issues
+Project-URL: Changelog, https://github.com/SERGIUSH-UA/gpurunner/blob/main/CHANGELOG.md
+Author: Serhii Dalishchynskyi
+License-Expression: MIT
+License-File: LICENSE
+Keywords: batch,colab,gpu,htr,kaggle,modal,ocr,rental,vast
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Natural Language :: Ukrainian
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: System :: Distributed Computing
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: kaggle>=1.6
+Requires-Dist: nbformat>=5.10
+Requires-Dist: platformdirs>=4.2
+Requires-Dist: psutil>=5.9
+Requires-Dist: pydantic>=2.6
+Requires-Dist: rich>=13.7
+Requires-Dist: typer>=0.12
+Provides-Extra: all
+Requires-Dist: boto3>=1.34; extra == 'all'
+Requires-Dist: fastapi>=0.115; extra == 'all'
+Requires-Dist: google-api-python-client>=2.130; extra == 'all'
+Requires-Dist: google-auth-oauthlib>=1.2; extra == 'all'
+Requires-Dist: modal>=0.64; extra == 'all'
+Requires-Dist: paramiko>=3.4; extra == 'all'
+Requires-Dist: pillow>=10.0; extra == 'all'
+Requires-Dist: uvicorn>=0.30; extra == 'all'
+Provides-Extra: beam
+Requires-Dist: beam-client>=0.2.200; extra == 'beam'
+Provides-Extra: colab
+Requires-Dist: google-api-python-client>=2.130; extra == 'colab'
+Requires-Dist: google-auth-oauthlib>=1.2; extra == 'colab'
+Provides-Extra: lightning
+Requires-Dist: lightning-sdk>=2026.7; extra == 'lightning'
+Provides-Extra: modal
+Requires-Dist: modal>=0.64; extra == 'modal'
+Provides-Extra: r2
+Requires-Dist: boto3>=1.34; extra == 'r2'
+Requires-Dist: pillow>=10.0; extra == 'r2'
+Provides-Extra: saturn
+Requires-Dist: saturn-client>=2026.2; extra == 'saturn'
+Requires-Dist: saturnfs>=2024.3; extra == 'saturn'
+Provides-Extra: vast
+Requires-Dist: paramiko>=3.4; extra == 'vast'
+Provides-Extra: web
+Requires-Dist: fastapi>=0.115; extra == 'web'
+Requires-Dist: uvicorn>=0.30; extra == 'web'
+Description-Content-Type: text/markdown
+
+# gpurunner
+
+Один CLI для GPU-задач на чужому залізі: подати, стежити, забрати результат,
+не переплатити. Сім бекендів за одним інтерфейсом — Kaggle, Modal, Google Colab,
+Vast.ai, Lightning, Beam, Saturn Cloud.
+
+> **In English.** `gpurunner` is a command-line tool that submits GPU jobs (OCR,
+> handwriting recognition, model training) to Kaggle, Modal, Colab, Vast.ai,
+> Lightning, Beam or Saturn Cloud through one interface, tracks them in a local
+> manifest, fetches outputs and keeps an eye on spending. Documentation and CLI
+> messages are in Ukrainian. It works on its own and also serves as the GPU
+> rental module of [nyshporka](https://github.com/SERGIUSH-UA/nyshporka).
+
+Статус: альфа (0.2). Команди й машинний вивід, на які спираються інші програми,
+описано в [`docs/contract.md`](docs/contract.md) і в межах мінорної версії не
+міняються; решта ще рухається.
+
+## 1. Навіщо
+
+- Той самий job іде на безкоштовну квоту Kaggle, на Modal із посекундним
+  білінгом або на орендований бокс Vast — міняється лише `-b`.
+- Кожен прогін лишає запис у локальному маніфесті: що подано, куди, з якими
+  параметрами, чим закінчилось і чому впало.
+- Гроші видно до старту: прорахунок вартості, стеля витрат, залишки по бекендах
+  (`gpurunner balance`), і що зараз тарифікується (`gpurunner burn`).
+- Для довгих заходів на Vast є наглядач (`gpurunner htr supervise`): орендує
+  бокс, стежить за темпом, доганяє пропуски, звіряє повноту й гасить оренду сам.
+- Бакет S3 для цього не обов'язковий: `htr plan --transport box` везе кадри й
+  ваги на саму машину по `scp` і піднімає на ній крихітний склад, з якого їх
+  бере робота. Чекпоінти наглядач забирає додому сам — машина може вмерти.
+
+## 2. Установлення
+
+Потрібен Python 3.11+.
+
+⚠ На PyPI пакет зветься **`gpuhire`**, а команда в терміналі — `gpurunner`.
+Ім'я `gpurunner` на PyPI зайняте схожим проєктом (`gpu-runner`), і майданчик
+не дав його взяти; перейменовувати команду заради цього не стали.
+
+```
+pip install gpuhire                 # ядро + Kaggle
+pip install "gpuhire[modal]"        # + Modal
+pip install "gpuhire[vast,r2]"      # + Vast.ai і доставка даних через R2
+pip install "gpuhire[all]"          # modal, colab, vast, web, r2
+```
+
+`lightning`, `beam`, `saturn` ставляться поіменно: їхні SDK важкі й потрібні
+одиницям. Як модуль Нишпорки: `pip install "gpuhire[vast,r2]"` поруч із
+нею — Нишпорка знайде плагін сама.
+
+Поруч із Нишпоркою gpurunner стає її **бекендом оренди**: оголошує entry point
+`nyshporka.cloud`, і `nysh cloud` сам орендує бокс на Vast.ai, читає справу по
+SSH, забирає результат і гасить оренду. Від людини — лише ключ API
+(`gpurunner auth vast --key <КЛЮЧ>`) і баланс; SSH-ключ генерується сам, R2 не
+потрібен. Докладно — [`docs/nyshporka.md`](docs/nyshporka.md).
+
+З вихідного коду:
+
+```
+git clone https://github.com/SERGIUSH-UA/gpurunner && cd gpurunner
+uv sync --extra all
+uv run gpurunner --version
+```
+
+## 3. Перший прогін
+
+```
+gpurunner auth kaggle --verify        # обліковка на місці?
+gpurunner ls                          # які є job'и й бекенди
+gpurunner run net-probe -b kaggle     # найдешевша перевірка: чи є в кернелі мережа
+gpurunner watch <handle>              # чекати до кінця
+gpurunner fetch <handle> -o out/      # забрати вихід
+```
+
+`--dry-run` перевіряє параметри й показує код, який поїде на бекенд, нічого не
+подаючи. Параметри job'а — `-p ключ=значення` (значення розбирається як JSON,
+якщо виходить).
+
+🔴 **Vast тарифікує погодинно й не спиняється після завершення job'а.** Після
+`fetch` обов'язково `gpurunner cancel <handle>`; що зараз горить, показує
+`gpurunner burn`.
+
+## 4. Бекенди
+
+| бекенд | extra | обліковка | особливість |
+|---|---|---|---|
+| `kaggle` | — | `~/.kaggle/kaggle.json` або `KAGGLE_USERNAME` + `KAGGLE_KEY` | безкоштовна тижнева квота; вхід — Kaggle Dataset |
+| `modal` | `modal` | `~/.modal.toml` (`modal token new`) | посекундний білінг; дані — у томі Modal; локальний Python має бути 3.12 — як в образі |
+| `colab` | `colab` | OAuth-клієнт Google у теці конфігурації | нотбук треба запустити руками: Runtime → Run all |
+| `vast` | `vast` | `VAST_API_KEY` або файл `vast_api_key` | оренда боксу по SSH; тарифікація до `cancel` |
+| `lightning` | `lightning` | `LIGHTNING_USER_ID`, `LIGHTNING_API_KEY` | Studio + teamspace |
+| `beam` | `beam` | `BEAM_TOKEN` або `~/.beam/config.ini` | стеля витрат на прогін і на місяць |
+| `saturn` | `saturn` | `SATURN_TOKEN`, `SATURN_BASE_URL` | типи інстансів — `gpurunner saturn sizes` |
+
+`gpurunner auth <бекенд>` показує, де шукається обліковка й чого бракує;
+`--verify` робить пробний запит. Тека конфігурації — `%LOCALAPPDATA%\gpurunner`
+(Windows) або `~/.config/gpurunner`; перекривається `GPURUNNER_CONFIG_DIR`.
+Приклади файлів — у [`docs/config/`](docs/config/).
+
+## 5. Job'и
+
+Перелік з описами й бекендами — `gpurunner ls`; готові набори параметрів із
+прорахунком вартості — `gpurunner recipes <job>`.
+
+Загальні:
+
+| job | що робить |
+|---|---|
+| `net-probe` | чи є у віддаленому кернелі мережа |
+| `paddleocr` | PaddleOCR PP-OCRv5 по переліку PDF за посиланнями → txt і json по сторінках |
+| `vit_classifier`, `crop_verifier`, `dino_surname_verifier` | дотренування бінарного класифікатора зображень (ViT / DINOv2) і скоринг |
+| `yolo_spotter` | дотренування YOLO на пошук одного рукописного слова |
+| `churro`, `rukopys_ocr` | сторінкове читання історичних документів VLM-моделями |
+| `kraken_lines`, `trocr_lines` | сегментація сторінок на рядки й читання рядків |
+| `kraken_train`, `parseq_train` | трен моделей читання рядків (kraken, PARSeq) |
+| `htr_eval`, `htr_lines_eval`, `htr_page_bench`, `paddle_page_bench`, `spotter_page_bench` | бенчмарки читання рукопису |
+
+Потребує пакета `nyshporka`:
+
+| job | що робить |
+|---|---|
+| `htr_case` | прогін архівної справи раннером Нишпорки на орендованій карті; раннер і моделі приїжджають архівом ассетів, gpurunner доставляє їх на бокс і стежить |
+
+Команди `gpurunner htr …` (план, передполіт, наглядач, забір чекпоінтів,
+калібрування) обслуговують саме `htr_case`.
+
+## 6. Команди
+
+```
+run · status · watch · logs · fetch · cancel · sweep      життєвий цикл прогону
+ls · recipes · balance · burn · reconcile · dash           огляд, гроші, звірка
+auth <бекенд>                                              обліковки
+dataset push|files                                         Kaggle-датасети
+drive push|files                                           вхідні дані Colab у Google Drive
+vast offers|instances · saturn sizes                       ринок і типи машин
+boxes ls|explain|ban|star|prune|forget                     реєстр орендних боксів
+bg start|status|stop                                       довгі задачі у фоні
+htr plan|preflight|supervise|state|stop|quiesce|fetch-ckpt|calibrate|append
+```
+
+`gpurunner <команда> --help` — повний перелік прапорців.
+
+## 7. Реєстр боксів
+
+Кожна оренда на Vast лишає рядок «обіцяне поруч із виміряним»: яке залізо
+заявив хост і який темп воно дало. З цього складається вердикт машини, і
+наступний пошук оферти погані машини оминає, а добрі шукає адресно.
+
+Реєстр — дані користувача, а не пакета: у ньому ідентифікатори машин, ціни й
+назви власних прогонів. Лежить у `GPURUNNER_REPO_DATA_DIR`, без змінної — у
+`<тека даних>/registry`. Змінну варто спрямувати в теку власного
+git-репозиторію: тоді в дифі видно, коли й чому бокс став поганим.
+
+## 8. Для програм
+
+Інші програми кличуть gpurunner окремим процесом і читають `--json`: останній
+рядок stdout, що починається з `{`, — один об'єкт. Форма відповідей, перелік
+стабільних команд, схема `plan.json` і змінні оточення —
+[`docs/contract.md`](docs/contract.md).
+
+Другий шлях — плагін у тому самому інтерпретаторі: клас
+`gpurunner.plugins.nyshporka_cloud:VastRent` (entry point `nyshporka.cloud`)
+орендує й гасить бокс для конвеєра Нишпорки. Методи, форма `Box.meta` і
+необов'язкові `status / login / estimate` — [§6 контракту](docs/contract.md#6-плагін-nyshporkacloud).
+
+## 9. Розробка
+
+```
+uv sync --extra all
+uv run pytest
+uv run ruff check .
+uv run mypy src
+python tools/scan_private.py          # ворота проти приватних даних
+```
+
+Тести не ходять у мережу й не потребують обліковок. Порядок внесення змін і
+чекліст релізу — [`CONTRIBUTING.md`](CONTRIBUTING.md); про вразливості —
+[`SECURITY.md`](SECURITY.md).
+
+## 10. Ліцензія
+
+MIT — див. [`LICENSE`](LICENSE).

gpuhire-0.2.0.dist-info/RECORD

@@ -0,0 +1,103 @@
+gpurunner/__init__.py,sha256=QDbH_ktfuajY2_X5yXRyKpR-fsbFQXCq1rEBcc0S0aA,105
+gpurunner/__main__.py,sha256=S-Ex1h2wwgrpw3R3jHJ__Nrgbn4Nrwf_yYGkxA0gxBI,514
+gpurunner/cli.py,sha256=K35TY2AWEN2X4D8BCQeFJZGyJ-1_2NY7UOpaP4vvzLU,154558
+gpurunner/config.py,sha256=iNgkZ5DqgRcbmBDq0dcBiYCT3Ci5jFxLaoPzLagwO5s,3382
+gpurunner/_embedded/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gpurunner/_embedded/_common.py,sha256=ltgW5rL8w3WuMe82HieOXunWVh8GtOgCTMPGH0ofUUc,4568
+gpurunner/_embedded/churro_runner.py,sha256=66tF9iCJBj6-cKmpP1WLMi0tEIWSfMfvE2EdVc1qibM,29425
+gpurunner/_embedded/dino_surname_verifier_runner.py,sha256=JinTHZjpFqsw-GYfWfvhoCPiP1hJIz4YWk0yhWJ63R0,38705
+gpurunner/_embedded/htr_case_runner.py,sha256=NA4O7e8D3xsVd48se5Zho6ehMvZSDaAyjr3dKPH0LWA,152704
+gpurunner/_embedded/htr_eval_runner.py,sha256=o-zunWFKiiOXr9-qHLFGIhwnV_i2sh7g5VP7upRxrZ8,8850
+gpurunner/_embedded/htr_lines_eval_runner.py,sha256=Qgf6y9XRhAMcwVN1e8vT-PW5TgApwArTpbWnGQ6DNYo,12507
+gpurunner/_embedded/htr_page_bench_runner.py,sha256=ejP-cnsnNhLKA39VQyD1NXvnfLOP-tss3FVmnuFnd84,7541
+gpurunner/_embedded/kraken_lines_runner.py,sha256=CqLMJt2PzM4zQLVUeztz3igk4AZvv7mXdtUierJPQhc,5773
+gpurunner/_embedded/kraken_train_runner.py,sha256=00eH0vCpV7MOZkWiFbNqfcCQ7H8QkIwuxBcvjxdUtNc,22981
+gpurunner/_embedded/paddle_page_bench_runner.py,sha256=zFoiv3EQJ4-lXQ8fqYpvaoiV6NsfnRc3CkmxPhtKajI,4212
+gpurunner/_embedded/paddleocr_runner.py,sha256=r4SatfLrFqsy43zp3IuCjVck44RoVY_crGKjk3vEtsw,12821
+gpurunner/_embedded/parseq_train_runner.py,sha256=TAiVXheTcC5nv2_Om6Qe9jc_rrrUS6RVPSOjxAPD-9c,72502
+gpurunner/_embedded/rukopys_ocr_runner.py,sha256=RPyQ2SlZv6A_OPTP8OO49Pe62HtAVklTvANOmliHeGQ,30501
+gpurunner/_embedded/spotter_page_bench_runner.py,sha256=Ca6SYyLRS_5HQnTwcXbQEoPg68ExNJsqKFoWCftgb_M,7343
+gpurunner/_embedded/trocr_lines_runner.py,sha256=WgaBr8-VaYt0mu9GA6toUiIP-jXxIXX63jupW6ws2Ng,7607
+gpurunner/_embedded/vit_classifier_modal_runner.py,sha256=DjRqLd5l63C0j2igseAPQLIvWVQqjCIg8Mzc6ODo-sY,15143
+gpurunner/_embedded/vit_classifier_runner.py,sha256=599fhKNpYiC1x8UzMorricCvpkDl-oJbXMXnP_eIs3I,15591
+gpurunner/_embedded/yolo_spotter_modal_runner.py,sha256=3JhTmN-lOirbIWcCn0x7SJsoSNX1bVxH4dU1qnnOETU,47690
+gpurunner/auth/__init__.py,sha256=DqDOcl2x1Vs-ItpKWDib6mVnool9dG8PS_4DHnbFVC4,167
+gpurunner/auth/beam.py,sha256=YUtJmkLL-tnNMCLUcMxzgqtsIiQ9Kjb8allW90Cpp5Q,6090
+gpurunner/auth/google.py,sha256=HH-J8alyBrF2p-XJDhsWrW9gLnl0m1LBTyAQJeHfFPU,7464
+gpurunner/auth/kaggle.py,sha256=MOjK0KmkOL6GJS2o7Mmq75sfZmkqRRbpDPPw0RD01Ec,3270
+gpurunner/auth/lightning.py,sha256=UTF8P14zPxTn9Drnw-dAaF7_xwLmZnUwkRW-lK-h1aQ,8417
+gpurunner/auth/modal.py,sha256=dXISJgGpgwKE1OeUyFk5LJH-Y9JpomRlekLQ8rBTYgo,836
+gpurunner/auth/saturn.py,sha256=Jc2NjSxNN0Go-x3iWhwzOmk2eacMVkHlPKh5a6NP2xw,5190
+gpurunner/auth/vast.py,sha256=5ZomWE9YapcbbW6fDtMc4jeYfHVI-q1F_XIGOf_zUVk,11458
+gpurunner/backends/__init__.py,sha256=abwuCtUCyc1l9IH6LinwdJIzJD7eoVWizSwdZzjSF3k,1353
+gpurunner/backends/beam.py,sha256=42Iz6wjpilA7OpPZ-Ewfb7RB-CEj6iH9AQRf7iNYQBs,45260
+gpurunner/backends/colab.py,sha256=FspAUYdEoD1lTrOc6Mf2_lR6IRWD-iMtdomhwyh9T1I,30505
+gpurunner/backends/kaggle.py,sha256=nK9DPVqtyxHOKxZUcdlp4v_DeuZWoLMLkD2OGJUDJRU,29353
+gpurunner/backends/lightning.py,sha256=5lAZJiUxcOMomDfwk9zspsHFVzziHkmtJCBko3IcbrQ,32847
+gpurunner/backends/modal.py,sha256=Dz27b0Ktf70G0JhSUkEzviCuiKQHitLwlvPRngS-mmg,27311
+gpurunner/backends/saturn.py,sha256=f5ImitChMKWrX9w_HpCGHbkvSUkQl7P_X6v1B6Gbm4M,31984
+gpurunner/backends/vast.py,sha256=FqEdy0Pf4oNE1w3m-vaRRyq8R2tZ_rYbwkfVE8R9Rg4,131063
+gpurunner/core/__init__.py,sha256=Gpd4z1tPhSAAC_d6b8eEm4Av1l2-urgSjaeng0fBIbM,401
+gpurunner/core/backend.py,sha256=n724a1mmvkZHeDDxAM8R_GEkW7lmyAn8nMV_ImF2_s0,3714
+gpurunner/core/balances.py,sha256=_6kVpdzzNRLu24czuISijWNTSJBdSlF9k5KZzIbZ3HY,17346
+gpurunner/core/boxes.py,sha256=_2HdUjPrwZLvLFdEEJ_v0_MnTShzqAmlF2hr3Qo4Mv0,38053
+gpurunner/core/budget.py,sha256=3lQk5EqNaNA3XM1OX_bAYHtVdzQqexo-xTYRrJJEiuk,6804
+gpurunner/core/contract.py,sha256=x3hVnvK0gZxvhlKVJ6HKNZvcWf1OP5xB5x1Yi9JuC-A,4089
+gpurunner/core/gpu_equiv.py,sha256=VjwVBdwnaWguN9VIashOrqkmUrDATIX1TDXMWVT6Iik,12885
+gpurunner/core/htr_sizing.py,sha256=TSB5QG1P2wlfBnZPXYH9YIKqDGKd09TprNBh64L5sFU,36682
+gpurunner/core/inputs.py,sha256=3dRGm50t3v-u02xlrZ8AUn833sKcP7P4gCxweZ6om2o,1882
+gpurunner/core/job.py,sha256=qBChgvkkIyG1B7dQsTV1TA5Gwl_uZ7Mwo-rIryjqvfg,10779
+gpurunner/core/locks.py,sha256=fCM5EJ7Msvr8_ljcc-rxYiwz2al2GER3oVuKYx8KNL8,9745
+gpurunner/core/manifest.py,sha256=EAMvE1ixx8lchu6u1HDNSs2vw-9WMpVFFlSkEhtuqTc,15085
+gpurunner/core/models.py,sha256=ZT0L93cxozpH35VsGXsgy6kfpGbB6wQobjxuuziJbSQ,4371
+gpurunner/core/offer_score.py,sha256=wdjxyZOB0qFcmZExleq0yE3rmIwq0bw-U2MA9h0qyUU,29278
+gpurunner/core/quota.py,sha256=F4d3Nfh9iCPPD0NtezE3b8QQxiLToCbjFsKjukuwPWQ,28360
+gpurunner/core/usage.py,sha256=iNxsxwIM96w75jNm40EQ8DO61NbAgSyZH1qmLlpWHYg,14098
+gpurunner/htr/__init__.py,sha256=S5IJh1Nbl1iQ9KKlDWE9-1MYmKpWj4gg8jfwF97Jwlg,1079
+gpurunner/htr/box_transport.py,sha256=6d8MK-W1wqZnC-NNQ1cvjppn9OLo__my4MDn43zMixI,10839
+gpurunner/htr/calibrate.py,sha256=2UH0s2NkJTOkRKW_9Qoj9fwuRHGoj8FwLspWrubuSO0,11064
+gpurunner/htr/fetch_ckpt.py,sha256=pIH6LYabzt1fLYz0yH5WLN1iXf9c62Tbt_SlOcONAr8,13054
+gpurunner/htr/origin.py,sha256=mkgPf1YADmyHnNmfSxau1gyd7fYRGKP_OdvM5GBegQc,10497
+gpurunner/htr/plan_build.py,sha256=-eExZaRUhKEDZ71OEGbtKJDj1TF1z2OLOxws95sB_0c,33737
+gpurunner/htr/preflight.py,sha256=k6iYuljeI_NE6RMNTTzVdNeyfQajB05yti4WiYG3SkY,11133
+gpurunner/htr/r2.py,sha256=Mcb-4Z8E9YSDfetIWo0J-1l5zrfwzjVVpYUI9_z19GU,12644
+gpurunner/jobs/__init__.py,sha256=q4DxOrtdOfQC1yTHYIwOGPNah1rmffF0bt89jjsgI3g,2989
+gpurunner/jobs/_net_probe.py,sha256=v6zgHRk2oKX9Gg1jVDZpza-FsePSPyGBk8BASw77ulk,2555
+gpurunner/jobs/churro.py,sha256=2Hirb-4B05VBhmSCep0QML7L_I3SIZ6m4jx2ea7n_tY,4547
+gpurunner/jobs/crop_verifier.py,sha256=XNjOYxTHdcD1iub2ZrIn0Z5yT5LxoeMHKOCqpu-K2_8,1407
+gpurunner/jobs/dino_surname_verifier.py,sha256=o0j3nr-aQWIO4rjFiiqsnkWbK5xXCNc2SAGBateVncU,6385
+gpurunner/jobs/htr_case.py,sha256=FdpoC0FsKskk5xLn57CWLtjtX_rMpUvRnx8jueBLq6o,29969
+gpurunner/jobs/htr_eval.py,sha256=PpB7tXVu8kQ98x6ASDA2GDMeceDDbizphySWihNQ1Hg,4666
+gpurunner/jobs/htr_lines_eval.py,sha256=ntRJRtI-o72LugdWxxepjHNI5ShqgI7CGQfSO6U0WSs,3341
+gpurunner/jobs/htr_page_bench.py,sha256=2bq35GC_26nt8y5sOF9_eZ9A1aj9rLUBATbUvrZ5jLw,3847
+gpurunner/jobs/kraken_lines.py,sha256=zqRNUXXPTUyT02gKr0kIc3_KZPmxTUUdU-q4v8_Zszs,3049
+gpurunner/jobs/kraken_train.py,sha256=8Luakris5cW2ecvQa1shFqU7VekzaVYG3bd83Ux5YXk,11233
+gpurunner/jobs/paddle_page_bench.py,sha256=2CJIhpUgzzp3LV3sNwegTJriXmqpBujEp5T4uYWHJUs,3224
+gpurunner/jobs/paddleocr.py,sha256=FzO7i9LL_OWn91Tdf_SjMvqxO8DXn3OVQiRpjIjhIys,10513
+gpurunner/jobs/parseq_train.py,sha256=B2gwhJsMgVJT7jSmROdKPtBg-k35HIpLsvkCHEWRokw,27559
+gpurunner/jobs/rukopys_ocr.py,sha256=1Q-xTr-sB86-yTGsQ0OvswVbWTDCOZwHZS0AJLH_j60,4078
+gpurunner/jobs/spotter_page_bench.py,sha256=8FE6rhRX2ja4UzQblSdrL6Bu73HN9L4HgSA8oGORvws,3815
+gpurunner/jobs/trocr_lines.py,sha256=ylyiB4wOwHfevcwvR9b4q6pBi_5HTjrrNbXYEsb3hjc,3339
+gpurunner/jobs/vit_classifier.py,sha256=5OjzvOZrx_iLa1zs84b4TLWPXSPNjVynEbkQR8WmfJ8,7556
+gpurunner/jobs/yolo_spotter.py,sha256=7wkEmpulBfNKzzUk4npmbyqdFZIv9SvnU8b1hqmxQT8,21827
+gpurunner/plugins/__init__.py,sha256=Oyt6m2wwYaCzVcTmfosXTP5kpbiGt0KMfGMQHffeSBU,407
+gpurunner/plugins/nyshporka_cloud.py,sha256=AcE705muEwKYV7qLJ-yB6RQymoEBOBzLfZExvCjfKG4,41365
+gpurunner/supervise/__init__.py,sha256=yZ1pE32Upl-F5Gy9xos3k_s1FDzjl-b2vCjeU7dW-yo,126
+gpurunner/supervise/append.py,sha256=xDVGMYdy64sTfahfERAv9znw8YBPWPCg4S6SStCHETY,5056
+gpurunner/supervise/bg.py,sha256=ODKfGtUK4v1Zse3ePol5BhsKsjM44HeFngmGVyvfBVo,7775
+gpurunner/supervise/decide.py,sha256=xOzlhgUGB0j6BZZ0uaM57SSp1z2GAQXCd_H2gksoj6s,44380
+gpurunner/supervise/detach.py,sha256=rF5X__iefl3fypr3BG5i3XhSp-h411gijRJdyYh_ZpU,17314
+gpurunner/supervise/gate.py,sha256=1Wh5X-wT4lb_naAnAWeeFt3Q_yyZTRA7dHvQnpcEpAU,25133
+gpurunner/supervise/htr.py,sha256=sx8XnxrEireAFGt-_Qshpve-8_uU5tmXvrkajRmT2ZY,212986
+gpurunner/supervise/plan.py,sha256=ah3-zTsrnIfMWifI29_p91Sh4s6Vr6Ris7hZaQZuEfQ,27996
+gpurunner/supervise/state.py,sha256=I8Qaukq-pWZ_SKyxPAD44L4RyPbXdNI_Aps5N-5ntTo,23266
+gpurunner/supervise/verify.py,sha256=-OlFL6aZvtyTAQdYj_z9xpFXNeSUeMhRQcsGgc869Cw,9707
+gpurunner/supervise/wrapup.py,sha256=ecmtbF_gNSZVKmcUNPfJCC1KjLskgyBLNL3iUwlXvdU,3819
+gpurunner/web/__init__.py,sha256=L_zFK82CxcXXxpEJdIsCOa0Hq0r7_A2vUcMMAX3lDSY,546
+gpurunner/web/app.py,sha256=sGcfhmyQfPtBEIG8k3cCyov9EcIso7sXSwVZtSHF2BM,14834
+gpurunner/web/static/index.html,sha256=JlArNRv5O7eG6-m9BgH9aOGC-F498-lPFuiEYnG4NOQ,41736
+gpuhire-0.2.0.dist-info/METADATA,sha256=_CN8jIiXahpb04XDgIDzs8xV-tfHF9zWi1kte8RAcQU,14448
+gpuhire-0.2.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+gpuhire-0.2.0.dist-info/entry_points.txt,sha256=I6QBdnQbrgzOXKI34zm-Fro9XhJptRkcw2z5cxxyp7s,117
+gpuhire-0.2.0.dist-info/licenses/LICENSE,sha256=sPEhlEAJ1y1dh5hgVz46C0wnuR3AwVtWUptJrf5TGQc,1078
+gpuhire-0.2.0.dist-info/RECORD,,

gpuhire-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

gpuhire-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+gpurunner = gpurunner.cli:app
+
+[nyshporka.cloud]
+vast = gpurunner.plugins.nyshporka_cloud:VastRent

gpuhire-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Serhii Dalishchynskyi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gpurunner/__init__.py

@@ -0,0 +1,3 @@
+"""gpurunner — submit GPU jobs to Kaggle/Modal/etc with a unified interface."""
+
+__version__ = "0.2.0"

gpurunner/__main__.py

@@ -0,0 +1,11 @@
+"""`python -m gpurunner` — останній запасний шлях відчеплених задач.
+
+Задача планувальника не має PATH, і коли ні `gpurunner` у PATH, ні
+`gpurunner.exe` поруч не знайдено, `detach.self_argv()` кличе саме так. Доти
+цього модуля не було, і запасний шлях падав на «No module named gpurunner.__main__».
+"""
+
+from gpurunner.cli import app
+
+if __name__ == "__main__":
+    app()

gpurunner/_embedded/_common.py

@@ -0,0 +1,71 @@
+"""Спільний пролог для embedded-ранерів; вклеюється рендером ПЕРЕД раннером.
+
+Це не імпортований модуль (як і самі ранери) — ``Job.render_kaggle_code``
+конкатенує цей файл із раннером в один текст, який їде на кернел. Звідси
+обмеження ті самі: лише stdlib на верхньому рівні, жодних імпортів gpurunner,
+без ``from __future__ import annotations``.
+
+🔴 Порядок склеювання (спершу _common, потім раннер) навмисний: якщо раннер
+визначає функцію з тим самим іменем, перемагає ЙОГО версія. Тому додавання
+цього файлу нічого не ламає само по собі, а прибирати локальні копії можна
+поступово, по одному раннеру.
+
+Що сюди варто виносити: дрібні чисті функції, які вже скопійовані дослівно в
+кілька ранерів і де розходження копій — це баг. Що НЕ варто: усе, що ранери
+свідомо роблять по-різному (parseq розпаковує tgz системним ``tar``, решта —
+``tarfile``), і все, що потрібне раннерам, які їздять ще й на Modal
+(``paddleocr``, ``vit_classifier``, ``yolo_spotter``): Modal бере лише сам
+модуль раннера, без цього прологу, тож їхні копії мусять лишатись при них.
+"""
+from datetime import datetime, timezone
+from pathlib import Path
+
+KAGGLE_INPUT = Path("/kaggle/input")
+KAGGLE_WORKING = Path("/kaggle/working")
+
+
+def _utc_iso() -> str:
+    return datetime.now(tz=timezone.utc).isoformat(timespec="seconds")
+
+
+def _dataset_root(slug: str, gt_file: str) -> Path:
+    """Тека змонтованого датасету, знайдена за характерним файлом.
+
+    🔴 Точка монтування Kaggle не одна: буває ``/kaggle/input/<slug>``, буває
+    ``/kaggle/input/<owner>-<slug>``, а з якогось моменту — ще й
+    ``/kaggle/input/datasets/<owner>/<slug>/``. Через це job падав із «не
+    знайдено», хоча дані лежали поруч. Тому: спершу очевидні кандидати, далі
+    рекурсивний пошук, і аж тоді помилка — але з деревом того, що реально
+    змонтовано (найчастіша справжня причина — датасет ще не розпакувався).
+    """
+    slug_short = slug.split("/")[-1]
+    candidates = [KAGGLE_INPUT / slug_short, KAGGLE_INPUT / slug.replace("/", "-")]
+    candidates += [d for d in KAGGLE_INPUT.iterdir() if d.is_dir()] if KAGGLE_INPUT.exists() else []
+    for c in candidates:
+        if (c / gt_file).exists():
+            return c
+    hits = sorted(KAGGLE_INPUT.glob(f"**/{gt_file}")) if KAGGLE_INPUT.exists() else []
+    if hits:
+        print(f"[diag] dataset root via rglob: {hits[0].parent}", flush=True)
+        return hits[0].parent
+    tree = []
+    if KAGGLE_INPUT.exists():
+        for d in sorted(KAGGLE_INPUT.iterdir()):
+            tree.append(str(d))
+            if d.is_dir():
+                tree += [f"  {x.name}" for x in sorted(d.iterdir())[:8]]
+    raise RuntimeError(
+        f"dataset root with {gt_file} not found under {KAGGLE_INPUT}; mounted:\n"
+        + ("\n".join(tree) or "<порожньо>"))
+
+
+def _norm(s: str) -> str:
+    """Нормалізація для нечіткого порівняння дореформеної кирилиці.
+
+    ѣ→е, і→и, ъ викидається — інакше та сама лексема в тексті XIX ст. і в
+    сучасному GT не збігається. Правило мусить бути одне на всі бенчмарки:
+    коли копій три, вони розходяться, і числа з різних job-ів перестають бути
+    порівнюваними — а вони існують саме заради порівняння.
+    """
+    s = s.lower().replace("ё", "е").replace("ъ", "").replace("ѣ", "е").replace("і", "и")
+    return "".join(ch for ch in s if ch.isalpha() or ch == " ").strip()