pyproject

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)

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.

[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.

[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].

[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).

[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.

[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).

[[tool.uv.index]]
url = "https://mirrors.aliyun.com/pypi/simple/"
default = true

[project.scripts]

CLI entrypoints.

[project.scripts]
kimix = "kimix.cli:cli"
kimi = "kimi_cli.__main__:main"

[tool.ruff]

[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]

[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.

[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.

[tool.pytest.ini_options]
asyncio_mode = "auto"
testpaths = ["tests"]