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.0
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.0.tar.gz | 2.6 MB | Details |
Built distributions (wheels)
Total release size: 48.8 MB
Release files / lingtai-0.18.0.tar.gz
| Download URL | lingtai-0.18.0.tar.gz |
|---|---|
| Size | 2.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b289ef2cd62d2ad861512167ed62bc9cc5be2ac470af5b814d941f2c43080c42
|
|
BLAKE2b-256 checksum How to use checksums |
039f37cf0f100c411add25e53f150f11f99cfc8340e35d7af71956e359223dc5
|
| 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.0-cp313-cp313-win_amd64.whl
| Download URL | lingtai-0.18.0-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 3.0 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
079a1b25c7ffc1b99cb54a17fc71214ff8ba325c77d088f3872d1961d792ddb0
|
|
BLAKE2b-256 checksum How to use checksums |
3fd6a258ca6180f02c0987f786d21081bb865760775cff1b7723b0399b58e9d8
|
| 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.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | lingtai-0.18.0-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 |
84382ecc031b27e90b2971f0dcc1236a3ac939424ff3fa38df2b34028ea33f7f
|
|
BLAKE2b-256 checksum How to use checksums |
9a1d9db3eb5e2772fc31a2e522c663a2e2ea5cbd9cbccad31c34fabc8e7a2265
|
| 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.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | lingtai-0.18.0-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 |
45514eb2107dae66aa60095732da16701516832bcfa9abce0a80c516f4d24075
|
|
BLAKE2b-256 checksum How to use checksums |
a5c7fdf4bebb00482888e57c98c3fdd7524838838cf897e97704a1224ef16464
|
| 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.0-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | lingtai-0.18.0-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 |
de33920bb62b7a517e360065df27884bc8c43578169c56971f268cf02f640dd0
|
|
BLAKE2b-256 checksum How to use checksums |
60ee6e0bb88a70aa9ccbed91844154089a19cf897f815200988888d46bf00e78
|
| 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.0-cp313-cp313-macosx_10_13_x86_64.whl
| Download URL | lingtai-0.18.0-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 |
4a71c05f2e42ff63b6157e7f0bf9364109e3a4e6b8074d24cd19d225c170f6a3
|
|
BLAKE2b-256 checksum How to use checksums |
835596fab002e402391c9d82ce44d8fdd0152ad0bffafa1b3034858e3b50bd22
|
| 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.0-cp312-cp312-win_amd64.whl
| Download URL | lingtai-0.18.0-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 3.0 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
163336966dba19d7b72b4311ea8748215e610759432cd01e41969fa95f7e4041
|
|
BLAKE2b-256 checksum How to use checksums |
a13088c1c1201e08d834a4bd6b0b5c98b37fa897ca4505c32979cb7c0fc67153
|
| 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.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | lingtai-0.18.0-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 |
0f3aa00fdc39134f56a799d5afef2996f9b827ffef427253da1cf969aa38d1fd
|
|
BLAKE2b-256 checksum How to use checksums |
53f337513c55ab667316188080883c86d8987cd791cbaa285eda2420abbd8a8f
|
| 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.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | lingtai-0.18.0-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 |
deec0a9e91aaf5b9494c74bc3e506884cc5236217c7d4cb85da302a415d99842
|
|
BLAKE2b-256 checksum How to use checksums |
46578797629587b23341345fbc9937b793a36058d72988c33f95b95428a330f5
|
| 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.0-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | lingtai-0.18.0-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 |
1dc9403765ae443aed466f726a45b5729246712d27c0c5754ac35d865e00d13b
|
|
BLAKE2b-256 checksum How to use checksums |
cb56657e2582762a4522becf30ba8b0a64d7b8b4b9f6708915d2e94bafe1585a
|
| 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.0-cp312-cp312-macosx_10_13_x86_64.whl
| Download URL | lingtai-0.18.0-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 |
55ecade5b0b212b4568cf0c4dc64d01ca4dd65254043be91f1b0b1c9ff91814a
|
|
BLAKE2b-256 checksum How to use checksums |
4e6f454b22034662b93b3672cf081bda76a571bcd917004f0f4430419d00bfb1
|
| 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.0-cp311-cp311-win_amd64.whl
| Download URL | lingtai-0.18.0-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 3.0 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
0e2beff85093d48d0a1de458527661240129bcc47b2bf6066a4575fb17ab6f64
|
|
BLAKE2b-256 checksum How to use checksums |
4f0d653833855074f7bd88afb23f807d9fd5d10bc6c05f0cf974493ca5854c6b
|
| 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.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | lingtai-0.18.0-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 |
00881048e42ff66d056ac0cbb312d1c98568ca9c5712a95c643b328ff082e35b
|
|
BLAKE2b-256 checksum How to use checksums |
d4e598785cfb3417489240d3ea8ef7acb433695bbd36e6478256a056f169f8fc
|
| 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.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | lingtai-0.18.0-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 |
50f1a9ccc2999e0c3b5d6fd2eb78424e499f2d7e9dbd97fac29e20f07d61d575
|
|
BLAKE2b-256 checksum How to use checksums |
c3c88832e6c7bd1531ae97f9b6fb6f6099a9feac6f55e2185f5c618ef7bada00
|
| 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.0-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | lingtai-0.18.0-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 |
9c4b7698bf179663e26dcb468a0a70b6026e4592c89c7537429168fbb0d3513e
|
|
BLAKE2b-256 checksum How to use checksums |
775b17abecf1ed691bd6efa0d38e98b84a5d5e0f08d30978c3cc763947c97e0b
|
| 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.0-cp311-cp311-macosx_10_12_x86_64.whl
| Download URL | lingtai-0.18.0-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 |
88e9cd34ace74b8c398b2beeee15c966cb49c712f2a13a04e82ed4f0e593a712
|
|
BLAKE2b-256 checksum How to use checksums |
5589eb89d0892e36267a498aa687d6992e71f24aa2e60f6b681ff8a03be2ff32
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
