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.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.19.2.tar.gz | 3.0 MB | Details |
Built distributions (wheels)
Total release size: 53.2 MB
Release files / lingtai-0.19.2.tar.gz
| Download URL | lingtai-0.19.2.tar.gz |
|---|---|
| Size | 3.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c9e6a726b9b8810981bc64a73f26ecce2c95fbb38e70cf63e4fb1f2321f04c98
|
|
BLAKE2b-256 checksum How to use checksums |
5dbf1465711f5608f1f78b7c32dd067e56804ae20fccdecd676ef5c3bbed9ff0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / lingtai-0.19.2-cp313-cp313-win_amd64.whl
| Download URL | lingtai-0.19.2-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
fb44e082ac1de801946ccc981ba7e5cd0685a926c2556443fc8acbc6674e80df
|
|
BLAKE2b-256 checksum How to use checksums |
5b8cbc4f4d47ea52d96e53e6fd83f31deb7f51d3545c17f5ac508f206aa59a8b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / lingtai-0.19.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | lingtai-0.19.2-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 |
b6bef068e321d67869a3fef188c776dc1725bad291be3126fee743af2c90fe83
|
|
BLAKE2b-256 checksum How to use checksums |
e6c52359e8c44da2a6fd8a0bb7b5314e69f477d21a4048282de9e3409835bed0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / lingtai-0.19.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | lingtai-0.19.2-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 |
d9c11e3f848922636f9f77d70b48612677775df5c3178d48e205a2a28e6a5f05
|
|
BLAKE2b-256 checksum How to use checksums |
af1a89eabe1b4c1e00fd903a89ffcc2f0960b270540374bb8b8cb80e5da47b06
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / lingtai-0.19.2-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | lingtai-0.19.2-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 |
e8ea59b3ad2cb4facf3495fff2eb9f7a294ff62e4b1391a422cdb48bc821600c
|
|
BLAKE2b-256 checksum How to use checksums |
f6b9e24b0e3cf44bd56c53db945519996d1f8644c6ada724dbb4c41ddd25e260
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / lingtai-0.19.2-cp313-cp313-macosx_10_13_x86_64.whl
| Download URL | lingtai-0.19.2-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 |
0ae978b1e49791d41f3bc65c54ec11c66910f5153337ee11ee922d2ff8b8bce8
|
|
BLAKE2b-256 checksum How to use checksums |
a301a0251bba839be91698a0ef3ccbd85b3ae5fc334551c64c05b5d75a4d0f4d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / lingtai-0.19.2-cp312-cp312-win_amd64.whl
| Download URL | lingtai-0.19.2-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
800ab487685f75151ea2bede794403be73afd8b03453738ea37a9c4c670df9d3
|
|
BLAKE2b-256 checksum How to use checksums |
5d42fb988222b1c00c151740fa871d661dbe6353663e6efbcc5df7ef6043ec0d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / lingtai-0.19.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | lingtai-0.19.2-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 |
28e35d60e4dbaa55ddd0e77bc824d97b73a9af3ad09667ddbe2878d1b0f6bae3
|
|
BLAKE2b-256 checksum How to use checksums |
a0d8a9d5893ed81aba394714c8d46f457cb55735d964bbd9d7ab7eb0395e7031
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / lingtai-0.19.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | lingtai-0.19.2-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 |
190ff6f518dac6f8e20bde7b7d28366bb901f0b02487b12c133895531447ea40
|
|
BLAKE2b-256 checksum How to use checksums |
8d3d0c18aa253fa259ee1ef1093bedf5f403f60691b652179d3c298668ea0b36
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / lingtai-0.19.2-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | lingtai-0.19.2-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 |
5272be2fbe01d06a15d4f6122f8f0583a1e908bfd4305245abfb1928572b47e4
|
|
BLAKE2b-256 checksum How to use checksums |
dfd8febd2703abd8c0156f6dbf3261e0ad0da5a9e5c2b875c0d6f1d4e1ea1214
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / lingtai-0.19.2-cp312-cp312-macosx_10_13_x86_64.whl
| Download URL | lingtai-0.19.2-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 |
421afd67ccb47371a0a5d2fc0ce3a5f963c300c3f45c7d4a0cb303f68cda6c32
|
|
BLAKE2b-256 checksum How to use checksums |
bf5145de37873a151043c4f02212bd73c046ee3cb0c404c70652fc02749ea916
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / lingtai-0.19.2-cp311-cp311-win_amd64.whl
| Download URL | lingtai-0.19.2-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
3b34cfcf9d6800c3a74c236ed5b756b38f587cca3914789df9470b8dd4d52dfd
|
|
BLAKE2b-256 checksum How to use checksums |
637e93e3866161111ab130452631f361857b1d56e802a9d90d7bb72d1068f8fc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / lingtai-0.19.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | lingtai-0.19.2-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 |
61b28505b0b4c8f8d17c4d1be239d7329b2eb3277d846d15848feedb622e729a
|
|
BLAKE2b-256 checksum How to use checksums |
aad4e47fb9053ab21c400f64b5e9772ae70490c352facd92ebe14a7526eb4627
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / lingtai-0.19.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | lingtai-0.19.2-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 |
1d8a1222eb833cdc04faf8d7be4f86d5270c760e804f9d7ae821ec466b92887e
|
|
BLAKE2b-256 checksum How to use checksums |
7ee03f98b0c01c588666757bf2c54f6291ca9c1460cbf37b8d553f942bc56262
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / lingtai-0.19.2-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | lingtai-0.19.2-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 |
cfec702c4a4ea0376094e9743a6562ccf463e5779d2fbce68f139ab591430053
|
|
BLAKE2b-256 checksum How to use checksums |
c1308793ee7f24e23b29321d9237af1cda9dd05cb03e595b3f6a0f533a5e74b5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / lingtai-0.19.2-cp311-cp311-macosx_10_12_x86_64.whl
| Download URL | lingtai-0.19.2-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 |
a8432348f3154ab9ebff434dba6de4de7b0d12d8bb13d5950f2ccac7949f82df
|
|
BLAKE2b-256 checksum How to use checksums |
458f522b79f7d232918a2ac649dafde89dfe3f6feadd1e78483bd9cab432baa8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
