Skip to main content

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)

Source distribution for s-modelkit 0.0.3
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)

Table of built distributions (wheels) for s-modelkit 0.0.3
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page