Metadata-Version: 2.5
Name: katsoft-llm-kit
Version: 1.1.0
Summary: LLM access, durable agent jobs and batch content pipelines in one library (import package llm_kit)
Project-URL: Source, https://github.com/kitaekatt/plugins-kit/tree/katsoft-llm-kit-v1.1.0
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.12
Requires-Dist: katsoft-contracts<2,>=1.0
Provides-Extra: config
Requires-Dist: pyyaml>=6.0; extra == 'config'
Provides-Extra: frontdoor
Requires-Dist: fastapi>=0.110; extra == 'frontdoor'
Requires-Dist: httpx>=0.27; extra == 'frontdoor'
Requires-Dist: uvicorn>=0.29; extra == 'frontdoor'
Provides-Extra: jobs
Requires-Dist: pyyaml>=6.0; extra == 'jobs'
Provides-Extra: local
Requires-Dist: psutil>=6.0; extra == 'local'
Provides-Extra: pipeline
Requires-Dist: pyyaml>=6.0; extra == 'pipeline'
Provides-Extra: sdk
Requires-Dist: openai>=1.0.0; extra == 'sdk'
Description-Content-Type: text/markdown

# katsoft-llm-kit

LLM access, durable agent jobs and batch content pipelines in one library.
The import package is `llm_kit`; the console script is `llm-kit`.

```
pip install katsoft-llm-kit
pip install "katsoft-llm-kit[sdk,jobs,config]"
llm-kit --help
```

The base install depends on `katsoft-contracts` (execution-event envelope,
interrupt contract, model declaration parser) and nothing else. Extras:
`config`, `jobs` and `pipeline` bring PyYAML; `sdk` brings the OpenAI client
(the OpenRouter HTTP path); `local` brings psutil; `frontdoor` brings
FastAPI, uvicorn and httpx.

## Runtime mode

`llm_kit._runtime.mode()` reports how the library is deployed. This
distribution is `"package"`: the contracts come from `katsoft-contracts`.
`llm_kit._runtime.fleet()` reports whether `bootstrap_lib`, the plugin
marketplace's shared library, imports in the same environment. With it, the
features that need it (the Codex adapter, claudx propagation, skill context,
the code-review lane) work and the model registry reads the layered config.
Without it, those features raise `UnsupportedInPackageMode`, Codex
reachability uses a PATH check, and the model registry reads the shipped
defaults; point `MODEL_ENDPOINTS_REGISTRY` at a registry file to change them.

Do not install this distribution into an environment that also holds the
plugin's linked `llm_kit` copy.

## Source

The source lives in the plugins-kit repository (`plugins/llm-kit/lib/llm_kit`).
Releases are tagged `katsoft-llm-kit-v<version>` in the repository named by the
`Source` project URL.
