Metadata-Version: 2.5
Name: kohaku-ui
Version: 0.2.0
Summary: Python reference implementation of kohaku (Kohaku Protocol v0.1) — a generation/serving backend for declarative UI Specs
Project-URL: Homepage, https://github.com/yosuque/kohaku
Project-URL: Documentation, https://github.com/yosuque/kohaku/blob/main/python/README.md
Project-URL: Repository, https://github.com/yosuque/kohaku
Project-URL: Issues, https://github.com/yosuque/kohaku/issues
Author: yosuque
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: generative-ui,kohaku,kohaku-ui,llm,mcp,ui-spec
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: pydantic>=2.10
Provides-Extra: all
Requires-Dist: anthropic>=1.5; extra == 'all'
Requires-Dist: fastapi>=0.115; extra == 'all'
Requires-Dist: google-genai>=1.0; extra == 'all'
Requires-Dist: httpx>=0.28; extra == 'all'
Requires-Dist: mcp>=2.2; extra == 'all'
Requires-Dist: uvicorn>=0.34; extra == 'all'
Provides-Extra: claude
Requires-Dist: anthropic>=1.5; extra == 'claude'
Provides-Extra: gemini
Requires-Dist: google-genai>=1.0; extra == 'gemini'
Provides-Extra: llm
Requires-Dist: httpx>=0.28; extra == 'llm'
Provides-Extra: mcp
Requires-Dist: mcp>=2.2; extra == 'mcp'
Provides-Extra: rest
Requires-Dist: fastapi>=0.115; extra == 'rest'
Requires-Dist: uvicorn>=0.34; extra == 'rest'
Description-Content-Type: text/markdown

<img src="https://raw.githubusercontent.com/yosuque/kohaku/main/docs/assets/kohaku-icon.png" alt="kohaku" width="112">

# kohaku (Python)

Python reference implementation of **Kohaku Protocol v0.1** — a backend for generating and serving
declarative UI Specs (UI as data, not code).

It is wire-compatible with the TypeScript reference implementation: canonical JSON is byte-identical, so
`intent.hash`, `specHash`, cache keys and the catalog fingerprint match across languages. Conformance is
verified in CI on every commit by the TypeScript CLI's black-box suite.

```bash
pip install kohaku-ui            # core
pip install "kohaku-ui[rest]"    # + the REST host (FastAPI)
pip install "kohaku-ui[mcp]"     # + the MCP host
pip install "kohaku-ui[llm]"     # + the OpenAI-compatible LLM adapter
pip install "kohaku-ui[all]"     # + every optional feature set (rest, mcp, llm, claude, gemini)
```

- Protocol: [spec/SPEC.md](https://github.com/yosuque/kohaku/blob/main/spec/SPEC.md)
- Implementation guide, layout and known differences from the TypeScript port:
  [python/README.md](https://github.com/yosuque/kohaku/blob/main/python/README.md)
- Source and issues: https://github.com/yosuque/kohaku

Licensed under the Apache License, Version 2.0.
