Metadata-Version: 2.4
Name: chenki
Version: 0.1.0
Summary: Self-hostable LLM client for restaurant tech.
Author-email: Brian Chen <brianchen.crisp@gmail.com>
License: MIT
Project-URL: Homepage, https://chenki.com
Project-URL: Repository, https://github.com/brianchenhao/chenki
Keywords: llm,openai,chat,restaurant,self-hosted,huggingface
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
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 :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.27
Provides-Extra: cache
Provides-Extra: test
Requires-Dist: pytest>=8.0; extra == "test"
Requires-Dist: pytest-asyncio>=0.23; extra == "test"
Requires-Dist: respx>=0.20; extra == "test"
Requires-Dist: pytest-cov>=5.0; extra == "test"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.6; extra == "docs"
Requires-Dist: mkdocs-material>=9.5; extra == "docs"
Dynamic: license-file

# chenki

[![Tests](https://github.com/brianchenhao/chenki/actions/workflows/test.yml/badge.svg)](https://github.com/brianchenhao/chenki/actions/workflows/test.yml)
[![Coverage](https://codecov.io/gh/brianchenhao/chenki/graph/badge.svg)](https://codecov.io/gh/brianchenhao/chenki)
[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://pypi.org/project/chenki)
[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)

Self-hostable LLM client for restaurant tech. A thin Python library that talks to any OpenAI-compatible `/v1/chat/completions` endpoint, with restaurant-domain helpers (menu Q&A, dish classification, order parsing) built on top.

By default it points at **brianchenhao-chenki-llm.hf.space** — a free Hugging Face Space running Qwen 2.5 1.5B Instruct (Q4_K_M) behind `llama.cpp`. Self-hosters can deploy their own Space using the included `server/Dockerfile`.

## Status

`chenki` is under active development. `v0.0.1` reserves the PyPI name; `v0.1.0` is the first functional release.

## Install

```bash
pip install chenki
```

## Quickstart

```python
from chenki import ChenkiClient, Message

client = ChenkiClient()  # defaults to https://brianchenhao-chenki-llm.hf.space/v1
reply = client.chat([Message(role="user", content="Hello!")])
print(reply.text)
```

## Website

[chenki.com](https://chenki.com) (coming soon)

## License

MIT
