AgentKthx/pyproject.toml at main · VTSTech/AgentKthx · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
[build-system]
requires = ["setuptools>=61.0", "wheel"]
build-backend = "setuptools.build_meta"

[project]
name = "agentkthx"
version = "0.7.23"
description = "⚛️ AgentKthx - A minimal, hackable agentic framework for local LLM inference"
readme = "README.md"
authors = [
    {name = "VTSTech", email = "veritas@vts-tech.org"}
]
maintainers = [
    {name = "VTSTech", email = "veritas@vts-tech.org"}
]
keywords = [
    "llm",
    "agent",
    "ollama",
    "bitnet",
    "local-inference",
    "tool-calling",
    "react",
    "autonomous",
    "agentic",
    "ai-agent",
    "kthx",
    "agentkthx",
]
classifiers = [
    "Development Status :: 3 - Alpha",
    "Environment :: Console",
    "Intended Audience :: Developers",
    "Intended Audience :: Science/Research",
    "Operating System :: OS Independent",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.12",
    "Topic :: Scientific/Engineering :: Artificial Intelligence",
    "Topic :: Software Development :: Libraries :: Python Modules",
]
requires-python = ">=3.12"
# Zero dependencies! Uses Python stdlib only.
dependencies = []

[project.optional-dependencies]
dev = [
    "pytest>=7.0",
    "pytest-cov>=4.0",
    "black>=23.0",
    "ruff>=0.1.0",
    "pyyaml>=6.0",
]

[project.urls]
Homepage = "https://www.vts-tech.org"
Documentation = "https://github.com/VTSTech/AgentKthx#readme"
Repository = "https://github.com/VTSTech/AgentKthx"
Issues = "https://github.com/VTSTech/AgentKthx/issues"

[project.scripts]
# Primary CLI binary
agentkthx = "agentkthx.cli:main"
# Backward-compat redirects (still installed by this package)
agentnova = "agentnova:main"
localclaw = "localclaw:main"

[project.entry-points."agentkthx.backends"]
ollama = "agentkthx.backends.ollama:OllamaBackend"

# Backward-compat entry point name (so existing agentnova-based installs
# still register the ollama backend entry point).
[project.entry-points."agentnova.backends"]
ollama = "agentkthx.backends.ollama:OllamaBackend"

[tool.setuptools.packages.find]
include = ["agentkthx", "agentkthx.*", "agentnova", "localclaw"]

[tool.setuptools.package-data]
agentkthx = ["py.typed", "skills/*/SKILL.md", "souls/*/soul.json", "souls/*/*.md", "plugins/*/plugin.json", "schemas/v0.2/plugin.schema.json", "data/*.json"]

[tool.black]
line-length = 100
target-version = ["py39", "py310", "py311", "py312"]

[tool.ruff]
line-length = 100
lint.select = ["E", "F", "W", "I"]
# E501 is delegated to black (same line-length). black reformats code to the
# limit but never splits long string literals/comments — SSE fixtures, URLs,
# prompt templates and box-drawing section headers legitimately exceed 100
# chars, so a hard E501 gate would flag ~300 lines black itself accepts.
lint.ignore = ["E501"]

[tool.ruff.lint.per-file-ignores]
# E402 — module-level imports that intentionally follow setup code:
# the package __init__ resolves the version (git hash) before importing
# submodules; the ACP plugin imports agentkthx.config after defining its
# module constants; skill helper scripts mutate sys.path/sys.modules before
# importing their targets; tests insert REPO_ROOT into sys.path (or set env)
# before importing backend plugins under test.
"agentkthx/__init__.py" = ["E402"]
"agentkthx/plugins/acp/acp_plugin.py" = ["E402"]
"agentkthx/skills/*" = ["E402"]
"tests/test_mistral_backend.py" = ["E402"]
"tests/test_no_bom_in_skills.py" = ["E402"]
"tests/test_pollinations_backend.py" = ["E402"]

[tool.pytest.ini_options]
testpaths = ["tests"]
python_files = ["test_*.py"]
python_functions = ["test_*"]
addopts = "-v --tb=short"

# Coverage configuration (audit ARCH-02, R07.01).
# No threshold is enforced yet — the baseline is recorded as a starting point.
# `--cov=agentkthx --cov-report=term-missing` is added by CI; running it locally
# is opt-in to keep the default dev-loop run at ~2.5s instead of ~5s.
[tool.coverage]
source = ["agentkthx"]

[tool.coverage.run]
branch = false
# Examples are demo scripts, not package code — exclude from the denominator
# so the reported number reflects the testable surface.
omit = [
    "agentkthx/examples/*",
    "agentkthx/plugins/test-plugin/*",
    "agentkthx/_git_meta.py",
    "*/__pycache__/*",
]

[tool.coverage.report]
# Modules below this threshold are still listed, just sorted last.
# Setting `skip_covered = true` would hide well-covered modules from the report;
# we keep them visible so the test investment map is complete.
skip_covered = false
show_missing = true
exclude_lines = [
    "pragma: no cover",
    "raise NotImplementedError",
    "if __name__ == .__main__.:",
    "if TYPE_CHECKING:",
]