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.19.3
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.19.3.tar.gz | 3.0 MB | Details |
Built distributions (wheels)
Total release size: 53.3 MB
Release files / lingtai-0.19.3.tar.gz
| Download URL | lingtai-0.19.3.tar.gz |
|---|---|
| Size | 3.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
62389f26456f72d1d74d448d3f41b5b78fe17df91ea71e95deb8b88718ccd4aa
|
|
BLAKE2b-256 checksum How to use checksums |
bdaf5f7cea0047f9cbcf8f2be02b0f7614b3583d2ef1e05b70d87f025002a106
|
| 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.19.3-cp313-cp313-win_amd64.whl
| Download URL | lingtai-0.19.3-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
4c409289cba3d9ea24dea27ecc73ade26aa083768d95b9be7287e13db60cbcf6
|
|
BLAKE2b-256 checksum How to use checksums |
ebff7ea82b7ac688ebb6e387f4c5e5e07a672c832089fc8f8034c6b4058362eb
|
| 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.19.3-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | lingtai-0.19.3-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 3.4 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
aee42a4860e9455c8e83b666009879fc639350f0ad4a86ee20a45b86aef03dae
|
|
BLAKE2b-256 checksum How to use checksums |
d293c5c0989023aae72704329158e1be0e883852879bcfba108a6a2a51249321
|
| 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.19.3-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | lingtai-0.19.3-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 3.4 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
74abc194a011a8fba8d02538ece8f4617e07528c801417abadbc1d443ed0dfbc
|
|
BLAKE2b-256 checksum How to use checksums |
fc13ded3b0546621b606c61f5d1eb0f8af5e11406d1f839b29073768471bccc4
|
| 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.19.3-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | lingtai-0.19.3-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
42cd517f17b4dedf44be9a688dd2a9491972df9a38ddf02e1375c6762bfad102
|
|
BLAKE2b-256 checksum How to use checksums |
cb6c6ce3a6418b8000530b437e1b20237fad1ac5892009ca3fb2651ef783f735
|
| 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.19.3-cp313-cp313-macosx_10_13_x86_64.whl
| Download URL | lingtai-0.19.3-cp313-cp313-macosx_10_13_x86_64.whl |
|---|---|
| Size | 3.4 MB |
| Tags | CPython 3.13 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
b84ea59c3b1fd124f065f7976f673f86a26d6a61e605081b903d99d8c78aafb9
|
|
BLAKE2b-256 checksum How to use checksums |
f08b82c7677f5f754fd905813f2e3aaff255ab21576a8e24933efa9a1059728d
|
| 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.19.3-cp312-cp312-win_amd64.whl
| Download URL | lingtai-0.19.3-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
3325420e21c0f325d332bde9c9b9a23662a96515e04b12cdddcf1076250efff9
|
|
BLAKE2b-256 checksum How to use checksums |
48257872a320d60a2428e86d898f2662a70f60a83f8308a14a97948003a836a7
|
| 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.19.3-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | lingtai-0.19.3-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 3.4 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
23fd9c253222d8b851ea86da8a8885fbc99bd1a70679acd5ea067409e2d79b0c
|
|
BLAKE2b-256 checksum How to use checksums |
0aecde4d3a80f3e91a84529c1cacc3bdd8ddedee8e91af9398ead74cfc0467a4
|
| 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.19.3-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | lingtai-0.19.3-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 3.4 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
e6060330b401d5b7cdd29df7369f8ef5642803b0daca678994c965217b5e6330
|
|
BLAKE2b-256 checksum How to use checksums |
d712d4c73505c8733f6fd5918c90d6d3bb9e3c7c271d2cb457a2ef7ae8e31caf
|
| 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.19.3-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | lingtai-0.19.3-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
84a86b3a66be12822103195b341328f38fe816e60d89885f4e820d757ae49935
|
|
BLAKE2b-256 checksum How to use checksums |
52d4efabd17b103a2803073cf0f9f12be9380dd1dff0d52f643ae48d23d98a33
|
| 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.19.3-cp312-cp312-macosx_10_13_x86_64.whl
| Download URL | lingtai-0.19.3-cp312-cp312-macosx_10_13_x86_64.whl |
|---|---|
| Size | 3.4 MB |
| Tags | CPython 3.12 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
f16a99869cc2de15953ea10e88300538755495ff4107cdab54bf08bf7d90b38c
|
|
BLAKE2b-256 checksum How to use checksums |
9dd4f135bc50018e32c5663d1b28a5ae32bf07dd3e840cb2f7346fb2212b0d5b
|
| 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.19.3-cp311-cp311-win_amd64.whl
| Download URL | lingtai-0.19.3-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
ff4a11fc4cdcbc988f66363e4da88509868b0d178f09df06045200a83be4de5a
|
|
BLAKE2b-256 checksum How to use checksums |
0f18d811bb845ec0a438b9a2519d7735f7f2a7e4f9f40393562539ff2c5c3275
|
| 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.19.3-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | lingtai-0.19.3-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 3.4 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
eb7437f3fd68f9072eceefa8ac9c68339bb55b39f3bcc680b643367f150d0358
|
|
BLAKE2b-256 checksum How to use checksums |
639b106686f71b6b224f0ae8f6ab7eecaa435da56a39f69e50404f626e0f9c16
|
| 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.19.3-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | lingtai-0.19.3-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 3.4 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
5a6228bb814dbf13130192a5f84b91c54b2badbd7de01ceb765fbae8a1800d65
|
|
BLAKE2b-256 checksum How to use checksums |
5f2cd00788a7c98ab7f694efef6b9522bd8cde0497bc0b527daa502b83d24311
|
| 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.19.3-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | lingtai-0.19.3-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
6d362c5dc491cdb792bccdc1520b67b492d5e52e27d889ccca26347d08c24e55
|
|
BLAKE2b-256 checksum How to use checksums |
76717f0be6c5079a778c5f24366f60874988b7a67aa73f9db839e31406942491
|
| 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.19.3-cp311-cp311-macosx_10_12_x86_64.whl
| Download URL | lingtai-0.19.3-cp311-cp311-macosx_10_12_x86_64.whl |
|---|---|
| Size | 3.4 MB |
| Tags | CPython 3.11 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
7533dc4cf9aa02ecbf76196302a1045d2da59130b7177b21e0f66fbacf03f0c6
|
|
BLAKE2b-256 checksum How to use checksums |
0042e89ec86f1e5a486f8cf863d8e0f9f7ded773f35bb6a260151d97192216a1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
