git:20260429.518d7a6 to git:20260526.39ff241

---

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

| Path | Name | Version | Build Backend | Key Deps |

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

| `./pyproject.toml` | `kimix` | 0.1.9 | `hatchling` | `numpy`, `playwright`, `fastapi`, `kimi-cli-x`, `kimi-agent-sdk-x` |

| `kimi-cli/pyproject.toml` | `kimi-cli-x` | 1.40.0 | `uv_build` | `typer`, `aiohttp`, `kosong-x`, `pykaos`, `rich` |

| `kimi-agent-sdk/python/pyproject.toml` | `kimi-agent-sdk-x` | 0.0.10 | `uv_build` | `kimi-cli-x`, `kosong-x` |

| `kimi-cli/packages/kaos/pyproject.toml` | `pykaos` | 0.9.0 | `uv_build` | `aiofiles`, `asyncssh` |

| `kimi-cli/packages/kimi-code/pyproject.toml` | `kimi-code` | 1.40.0 | `uv_build` | `kimi-cli==1.40.0` (thin wrapper) |

| `kimi-cli/packages/kosong/pyproject.toml` | `kosong-x` | 0.53.0 | `uv_build` | `anthropic`, `openai`, `google-genai`, `pydantic`, `mcp` |

## 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`.

## 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`

## 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

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/"]

```

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

Root only.

```toml

[tool.pytest.ini_options]

asyncio_mode = "auto"

testpaths = ["tests"]

```