s-modelkit — каталог моделей провайдера как ДАННЫЕ
Ни один клиент не хранит список моделей константой в коде: каталог резолвится живьём, кешируется на диске, знает про тир подписки и лимиты, а отказ «модель не по твоему тарифу» приходит до сети и словами сервиса.
потребители (навыки чатов, gateway, accountpoolkit)
|
modelkit ← знание о моделях: состав, доступность, лимиты
|
corekit ← основание (LimitSpec / QuotaScope / AccessVerdict)
Зачем
Реальный замер (Grok, 2026-08-07). В коде навыка жила таблица:
MODEL_MODES = {"grok-3": …, "grok-4": …} # имён grok-3/grok-4 у сервиса НЕТ
А сервис на своём каталоге отвечает так:
{"modes":[{"id":"fast","availability":{"available":{}}},
{"id":"expert","availability":{"requiresUpgrade":{"minimumSubscriptionTier":"TIER_SUPERGROK_LITE"}}}],
"defaultModeId":"fast"}
Зашитая таблица врала в обе стороны: придумывала несуществующие имена и «знала»
доступность, которую сервис сообщает открытым текстом. Запрос expert уходил в
сеть и возвращался кадром stream_error: entitlement, который снаружи выглядит
как «пустой ответ».
Как пользоваться
from modelkit import ModelSpec, catalog_of, choose, load_catalog, save_catalog, is_fresh, touch
DECLARATION = catalog_of("grok", [ModelSpec(code="fast", aliases=("grok-3",))])
catalog = load_catalog(DECLARATION, path) # декларация + снимок + научённое
if not is_fresh(catalog): # ленивая сеть: только когда надо
catalog = touch(catalog, models=fetch_live()) # fetch_live() — забота вызывающего
save_catalog(catalog, path)
pick = choose(catalog, "expert", tier_id="free")
if not pick.ok:
raise SystemExit(pick.message)
# grok: модель `expert` требует тариф `TIER_SUPERGROK_LITE` (тир аккаунта: `free`).
# Доступны: fast.
send(model=pick.request_key) # на провод — ключ, не отображаемое имя
Три решения, ради которых кит существует
1. Доступность — три состояния, не флаг. AVAILABLE / REQUIRES_TIER /
UNKNOWN. Схлопнуть «не проверяли» в «недоступна» значит однажды спрятать от
человека рабочую модель. Та же логика, что у alive в реестре адресов.
2. request_key отдельно от code. Отображаемое имя и то, что уходит на
провод, — разные вещи; их смешение у google-flow давало 400/404.
3. Декларация, живой ответ и научённое не сливаются. Состав берётся из живого ответа либо из декларации; с диска накладывается только доступность и отметки времени. Иначе вчерашний кеш начнёт затенять каталог, и модель, добавленная сервисом сегодня, не появится у пользователя никогда.
Что кит НЕ делает
Не ходит в сеть и не знает про конкретного провайдера: каталог добывает
вызывающий (только он умеет говорить со своим сервисом), кит принимает уже
разобранный результат. Не зависит от accountpoolkit — каталог нужен ему самому,
и обратная зависимость дала бы цикл; поэтому тир приезжает строкой tier_id.
Лицензия
MIT.
Metadata
Release files for s-modelkit 0.0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| s_modelkit-0.0.3.tar.gz | 21.3 kB | Without provenance | Details for s_modelkit-0.0.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| s_modelkit-0.0.3-py3-none-any.whl | Python 3 | none | any | Details for s_modelkit-0.0.3-py3-none-any.whl |
Total release size: 40.6 kB
Release files / s_modelkit-0.0.3.tar.gz
| Download URL | s_modelkit-0.0.3.tar.gz |
|---|---|
| Size | 21.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
09145b4f8f1f35f6ce3f3bab4983731c46717c7ebc81e171658212efc9d56677
|
|
BLAKE2b-256 checksum How to use checksums |
fdecc59b8f5b3929f83bffbe2f6ccf11c4a42e978e156aa20ba37840d8c82bf9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / s_modelkit-0.0.3-py3-none-any.whl
| Download URL | s_modelkit-0.0.3-py3-none-any.whl |
|---|---|
| Size | 19.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0631ee313725ceec580102958530e1938ace801b1110cf4e827a4b1c2aec9d78
|
|
BLAKE2b-256 checksum How to use checksums |
2f41be19e5487d688d56944e1aedef6667ddfabd43717103ee658a5f33fd46d6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for s-modelkit 0.0.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.