git:20260526.39ff241 to git:20260816.ff0cd32

16 added, 158 removed. Audit A to A.

---

name: pyproject

description: Reference for pyproject.toml files in the kimix monorepo. Use when modifying, adding, or analyzing Python package configs, workspace dependencies, build systems, or linting rules.

---

# Repo Pyproject Overview

Monorepo with 6 Python packages managed by `uv` workspace.

## Packages

- |------|------|---------|---------------|----------|

+ |------|------|---------------|----------|

## Workspace

- Root `tool.uv.workspace` includes:

- - `kimi-cli`

- - `kimi-cli/packages/kosong`

- - `kimi-cli/packages/kaos`

- - `kimi-agent-sdk/python`

- Workspace sources in root: `kimi-cli-x`, `kimi-agent-sdk-x`, `kosong-x`, `pykaos`.

+ `tool.uv.workspace` members: `kimi-cli`, `kimi-cli/packages/kosong`, `kimi-cli/packages/kaos`, `kimi-agent-sdk/python`. Workspace sources: `kimi-cli-x`, `kimi-agent-sdk-x`, `kosong-x`, `pykaos`.

## Common Tool Configs

- ### Ruff (all packages)

- ```toml

- line-length = 100

- select = ["E", "F", "UP", "B", "SIM", "I"]

- ```

- Root `kimix` also includes `N`, `W`, ignores `E501`.

- ### Type Checkers

- - **pyright** / **ty**: `typeCheckingMode = "strict"`, `pythonVersion = "3.14"`, includes `src/**/*.py`, `tests/**/*.py`.

- - **mypy** (root only): strict mode, `disallow_untyped_defs = true`, excludes `tests/`, `scripts/`.

- ### Build Backends

- - `hatchling` (root only). Wheel targets: `src/kimix`, `src/my_tools`.

- - `uv_build` (all other packages). Set `module-name` in `tool.uv.build-backend`.

- ### Scripts

- - `kimix` -> `kimix.cli:cli`

- - `kimi` / `kimi-cli-x` -> `kimi_cli.__main__:main`

- - `kimi-code` -> `kimi_cli.__main__:main`

+ - **Ruff** (all): `line-length = 100`, `select = ["E", "F", "UP", "B", "SIM", "I"]`; root adds `N`, `W`, ignores `E501`.

+ - **pyright/ty**: strict, `pythonVersion = "3.14"`, `src/**/*.py` + `tests/**/*.py`.

+ - **mypy** (root only): strict, excludes `tests/`, `scripts/`.

+ - **Build backends**: `hatchling` (root, wheel targets `src/kimix`, `src/my_tools`); `uv_build` (all others, `module-name` in `tool.uv.build-backend`).

+ - **Scripts**: `kimix` → `kimix.cli:cli`; `kimi`/`kimi-cli-x`/`kimi-code` → `kimi_cli.__main__:main`.

## Optional Deps

- - `kimix[office]`: `pymupdf`, `pdfplumber`, `python-docx`

- - `kimix[image_process]`: `pillow`, `pytesseract`

- - `kosong-x[contrib]`: `anthropic`, `google-genai`

- ## Block Reference

- ### `[build-system]`

- Root uses `hatchling`; subpackages use `uv_build`.

- ```toml

- [build-system]

- requires = ["hatchling"]

- build-backend = "hatchling.build"

- # or

- requires = ["uv_build>=0.10.0,<0.12.0"]

- build-backend = "uv_build"

- [tool.uv.build-backend]

- module-name = ["kimi_cli"] # package import name

- source-exclude = ["tests/**/*"] # omit from sdist/wheel

- ```

- ### `[project]`

- Core metadata. Always present.

- ```toml

- [project]

- name = "kimix"

- version = "0.1.9"

- description = "..."

- readme = "README.md"

- license = { text = "MIT" } # or "Apache-2.0"

- requires-python = ">=3.14"

- authors = [{ name = "...", email = "..." }]

- dependencies = ["numpy", "kimi-cli-x>=1.39.1"]

- ```

- ### `[project.optional-dependencies]`

- Feature flags installable as `pkg[extra]`.

- ```toml

- [project.optional-dependencies]

- office = ["pymupdf>=1.23.0", "pdfplumber>=0.10.0", "python-docx>=1.1.0"]

- image_process = ["pillow>=10.0.0", "pytesseract>=0.3.10"]

- ```

- ### `[dependency-groups]`

- `uv`-native dev dependencies (not packaged into wheel).

- ```toml

- [dependency-groups]

- dev = ["pytest>=9.0.2", "ruff>=0.14.10", "pyright>=1.1.407"]

- ```

- ### `[tool.uv.workspace]` / `[tool.uv.sources]`

- Root workspace declaration. Subpackages become editable installs.

- ```toml

- [tool.uv.workspace]

- members = ["kimi-cli", "kimi-cli/packages/kosong", "kimi-cli/packages/kaos", "kimi-agent-sdk/python"]

- [tool.uv.sources]

- kimi-cli-x = { workspace = true }

- kimi-agent-sdk-x = { workspace = true }

- ```

- ### `[tool.uv.index]`

- Mirror config (root only).

- ```toml

- [[tool.uv.index]]

- url = "https://mirrors.aliyun.com/pypi/simple/"

- default = true

- ```

- ### `[project.scripts]`

- CLI entrypoints.

- ```toml

- [project.scripts]

- kimix = "kimix.cli:cli"

- kimi = "kimi_cli.__main__:main"

- ```

- ### `[tool.ruff]`

- ```toml

- [tool.ruff]

- target-version = "py314" # or omitted

- line-length = 100

- [tool.ruff.lint]

- select = ["E", "F", "UP", "B", "SIM", "I"]

- ignore = ["E501"]

- [tool.ruff.lint.per-file-ignores]

- "src/kimi_cli/web/api/**/*.py" = ["B008"]

- ```

- ### `[tool.pyright]` / `[tool.ty]`

- ```toml

- [tool.pyright]

- typeCheckingMode = "strict"

- pythonVersion = "3.14"

- include = ["src/**/*.py", "tests/**/*.py"]

- [tool.ty.environment]

- python-version = "3.14"

- [tool.ty.src]

- include = ["src/**/*.py", "tests/**/*.py"]

- ```

- ### `[tool.mypy]`

- Root only. Strict.

- ```toml

- [tool.mypy]

- strict = true

- disallow_untyped_defs = true

- disallow_any_generics = true

- show_error_codes = true

- ignore_missing_imports = true

- exclude = ["tests/", "scripts/"]

- ```

+ `kimix[office]`: pymupdf, pdfplumber, python-docx · `kimix[image_process]`: pillow, pytesseract · `kosong-x[contrib]`: anthropic, google-genai.

- ### `[tool.pytest.ini_options]`

- Root only.

- ```toml

- [tool.pytest.ini_options]

- asyncio_mode = "auto"

- testpaths = ["tests"]

- ```

+ Full TOML block templates (`[build-system]`, `[project]`, `[tool.ruff]`, `[tool.pyright]`, etc.): read `references/pyproject-reference.md`.