related_files:
- docs/readmes/README.zh.md
- docs/readmes/README.wen.md
- CONTRIBUTING.md
- SECURITY.md
- SUPPORT.md
- docs/references/acknowledgements.md
- dev-guide-skill/SKILL.md
- ANATOMY.md
- CONTRACT.md
- src/lingtai/kernel/ANATOMY.md
- src/lingtai/ANATOMY.md
- src/lingtai/tools/ANATOMY.md
- src/lingtai/mcp_servers/ANATOMY.md
- docs/references/claude-code-guide.md maintenance: | Tracks the public repo overview and architecture entry-point table; must stay synced with docs/readmes/ translations and with the linked entry-point files whenever the repository's structure or onboarding steps change.
This repository is the engine underneath the product, not the product itself.
Looking for LingTai the product? The Lingtai-AI/lingtai
repository is the source of truth for the Digital Scientist — the lifelong, self-growing
agent — including the guided installer, the TUI/Portal, and everyday workflows. Normal
users should start there and let the installer manage this runtime for them. This
repository is for developers who build on or contribute to the kernel; do not treat a
bare pip install here as the normal installation path.
What this repository owns
- The agent runtime — the core turn loop, lifecycle, tool dispatch, mailbox, soul (inner voice), molt, and notification machinery that make an agent run.
- Two Python surfaces —
lingtai.kernel, the minimal runtime (BaseAgent, intrinsics, the LLM protocol, mail, and logging), andlingtai, the batteries-included runtime, CLI, and services that buildAgent(BaseAgent)on top of it and re-export the kernel's public API. - The batteries — the bundled built-in tools, the LLM adapters, the curated MCP server implementations, the packaging (Python distribution plus the bundled Rust search sidecar). These are ownership boundaries, not a feature list.
Developer quick start
For kernel development — not the normal LingTai user installation path. Requires
Python >= 3.11; use a local .venv.
git clone https://github.com/Lingtai-AI/lingtai-kernel.git
cd lingtai-kernel
uv venv --python 3.11
uv pip install -e . pytest
.venv/bin/python -m pytest
Architecture / developer entry points
Before changing anything, a coding agent first finds and reads this repository’s local dev guide skill; it owns the workflow and routes each task onward through the linked entry points below without duplicating the Anatomy or Contract systems.
| Entry point | What it covers |
|---|---|
dev-guide-skill/SKILL.md |
The mandatory repository-local dev guide skill: the development workflow a coding agent must follow before editing. |
ANATOMY.md |
Repository structure/composition map — where each subsystem's anatomy begins and how it reaches its behavioral Contract. |
CONTRACT.md |
Normative interface/behavior promises plus the governed-component pairing/ownership rule, linked back to Anatomy structure. |
src/lingtai/kernel/ANATOMY.md |
The core runtime: BaseAgent, turn/lifecycle, tool machinery, mail, LLM protocol. |
src/lingtai/ANATOMY.md |
The lingtai package: Agent(BaseAgent), capabilities, presets, CLI, public re-exports. |
src/lingtai/tools/ANATOMY.md |
The concrete built-in tools and the registry that composes them. |
src/lingtai/mcp_servers/ANATOMY.md |
The bundled MCP server implementations. |
CONTRIBUTING.md |
Contribution workflow and repository navigation. |
docs/references/claude-code-guide.md |
The full repository guide — test commands, architecture notes, and conventions. |
Security · Support · Acknowledgements
For responsible disclosure, read SECURITY.md; for help, read SUPPORT.md; for credits, read docs/references/acknowledgements.md.
License
Apache-2.0 — Zesen Huang, 2025–2026
1 maintainer
Metadata
1 maintainer
Release files for lingtai 0.18.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| lingtai-0.18.2.tar.gz | 2.6 MB | Details |
Built distributions (wheels)
Total release size: 49.0 MB
Release files / lingtai-0.18.2.tar.gz
| Download URL | lingtai-0.18.2.tar.gz |
|---|---|
| Size | 2.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e0a83fcf710357478ad94017d88446d9aec4670660b431aaf7af2e0c50aea1de
|
|
BLAKE2b-256 checksum How to use checksums |
f08f9f852d2a3cf4331847651d75dce7644e46bc886f578f4565b673fa371ce3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Release files / lingtai-0.18.2-cp313-cp313-win_amd64.whl
| Download URL | lingtai-0.18.2-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 3.0 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
65cdb12be7625d62ac0a851cc546d23a76437ebbfbd7aaeb6fcc910fa43fc4c2
|
|
BLAKE2b-256 checksum How to use checksums |
a464cdc4ce30b55def9de61caf79899b2d66fd47e4108a8990ece86904b1b286
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Release files / lingtai-0.18.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | lingtai-0.18.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
654c1caad15ae387c8cc27ffa7782275c94be7f826f2fb4f735735897d65f071
|
|
BLAKE2b-256 checksum How to use checksums |
a08cbf3d2aafcfea5e93cdec55044af42714e10ecbc823262a251151b336ed7e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Release files / lingtai-0.18.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | lingtai-0.18.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 3.1 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
4ff8039369649e29e3a60b1fb6c77a5bd9190556b086ee9489425cee89101a5f
|
|
BLAKE2b-256 checksum How to use checksums |
e768f3c8640969ff322fd9ffa3c1c89b2e812246c2e38cde375ce5190419b3c1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Release files / lingtai-0.18.2-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | lingtai-0.18.2-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.0 MB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
d27c6749f09e9c26e29234736af5ab2dc6bc37b842de2bd15ef10760a55069d6
|
|
BLAKE2b-256 checksum How to use checksums |
6870c2a3151065a1e6d27249c2cb6f1becf078b7863a3a63ad8a5ebf5dbcfd0b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Release files / lingtai-0.18.2-cp313-cp313-macosx_10_13_x86_64.whl
| Download URL | lingtai-0.18.2-cp313-cp313-macosx_10_13_x86_64.whl |
|---|---|
| Size | 3.1 MB |
| Tags | CPython 3.13 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
ac849c03ffb5645beda23bb2ae5af2ac9c464033fda7026861ef96db47581c49
|
|
BLAKE2b-256 checksum How to use checksums |
aae08cfe2831fbc54a3026490c178f474edc68a76a1d99d7b470c3f18b43879a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Release files / lingtai-0.18.2-cp312-cp312-win_amd64.whl
| Download URL | lingtai-0.18.2-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 3.0 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
47bb138baa106acbe040f0fc791267520e73e784bfbd68f3eb27e9a784e44062
|
|
BLAKE2b-256 checksum How to use checksums |
edddeaea668ae18175d9032aafcbb658a45ff602ec232471d66f4a8a6962095f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Release files / lingtai-0.18.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | lingtai-0.18.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
195b0ff9298d519756750436a05266a46293d81f19f252b5ed87e3a714f3cd13
|
|
BLAKE2b-256 checksum How to use checksums |
ac0f088f4a9f388d95e15b6834c2fc81418457117ca2b3212bd233645294b0d9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Release files / lingtai-0.18.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | lingtai-0.18.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 3.1 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
8df2dbb7ea1df911fbe4a7bafe4b010fa68972ff6be6534b6a516eace79217a1
|
|
BLAKE2b-256 checksum How to use checksums |
bb0e283f5efb8bdc69b3b89749b3c53a90d2ad6f01de8abfc4cbba07efd27e98
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Release files / lingtai-0.18.2-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | lingtai-0.18.2-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.0 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
b7c931e21f27c28407a7f3c2e6c9210e8814b5de31aa429604f6d5ea4f77f0ef
|
|
BLAKE2b-256 checksum How to use checksums |
4358d7544fc029922ca167bc0f98f1dabd01cb65c6d4954158e2151204f78de5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Release files / lingtai-0.18.2-cp312-cp312-macosx_10_13_x86_64.whl
| Download URL | lingtai-0.18.2-cp312-cp312-macosx_10_13_x86_64.whl |
|---|---|
| Size | 3.1 MB |
| Tags | CPython 3.12 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
aa05cc2459388ce89e4710af3659b18c8df96310aafc3c92adaf528d515eae5b
|
|
BLAKE2b-256 checksum How to use checksums |
6b201c935f9c0bf5f930b6a0d23ed42d21d796f69e1e859a6112490b1d19f6d5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Release files / lingtai-0.18.2-cp311-cp311-win_amd64.whl
| Download URL | lingtai-0.18.2-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 3.0 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
51f93a1f78cc496c73ebd97f428440fd12e42198f5ad97c06cdb2ff7946efe98
|
|
BLAKE2b-256 checksum How to use checksums |
0b473613854cf12747f8e4e0ca27abde9f5421793d2b67e8a27cd65f62552964
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Release files / lingtai-0.18.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | lingtai-0.18.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
576f405b944ecc9164c54fe35f28db28519406302b391fff169c02bedee02796
|
|
BLAKE2b-256 checksum How to use checksums |
d40c8a7392d2c279085a015ecbc8d203e7f9d0b827fac022c578d174bb272c81
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Release files / lingtai-0.18.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | lingtai-0.18.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 3.1 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
79e144a4706d7c1ae8e1734445ceceff4eeef5c35a5fe53f53aa48e1480804a3
|
|
BLAKE2b-256 checksum How to use checksums |
459e9d9f14b18de6946aec9713532fd5292cd53a1e6fa56b411614ea920153d5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Release files / lingtai-0.18.2-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | lingtai-0.18.2-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.0 MB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
7615c1f8efa4e4aac2c0b843282d1e60b7025d73a8d13950ad03968391c8bff9
|
|
BLAKE2b-256 checksum How to use checksums |
0dd33ed8d9fdd2da0ebab29d6cb3f88b366b3d62c553f824a912a6984dc757be
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Release files / lingtai-0.18.2-cp311-cp311-macosx_10_12_x86_64.whl
| Download URL | lingtai-0.18.2-cp311-cp311-macosx_10_12_x86_64.whl |
|---|---|
| Size | 3.1 MB |
| Tags | CPython 3.11 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
0b6d6689a51325fad1410e912ee752ee54fba2c51b5973d12142f74956c2d996
|
|
BLAKE2b-256 checksum How to use checksums |
b8710ebf140d19e0e58b03475c00021a6b7ba06773a59bc52633cf7cef5ea6a8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
