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.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.19.0.tar.gz | 3.0 MB | Details |
Built distributions (wheels)
Total release size: 53.1 MB
Release files / lingtai-0.19.0.tar.gz
| Download URL | lingtai-0.19.0.tar.gz |
|---|---|
| Size | 3.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
513bf4d2da10066cc05709f856145b1f6a0009156c46877b8d34e816c30e91e1
|
|
BLAKE2b-256 checksum How to use checksums |
2eca04a7b68641403e6177955a71c08737af08f004b93108e416434ebe940c4d
|
| 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.0-cp313-cp313-win_amd64.whl
| Download URL | lingtai-0.19.0-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
5f34264aa2c38bf61d4d95752e25f767247b5a6212baab94037ced0fae2e1c72
|
|
BLAKE2b-256 checksum How to use checksums |
ed26f30ad350f94745634bc1705ba45eaca2d0d9c91744e224b521eaa9b25b46
|
| 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.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | lingtai-0.19.0-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 |
f4ddc7dbdf50c3ed9554b86a2b0bb69949d6db3010f138dd7cbce086422e56c4
|
|
BLAKE2b-256 checksum How to use checksums |
d951aa23740c3ac64831eb7e0c559abba464e7e1a9363115a5a444dc700eb732
|
| 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.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | lingtai-0.19.0-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 |
b5eb1ba6fb847eec67e99ad6997f5d819b31e8e721384244b72ba8d056938aaa
|
|
BLAKE2b-256 checksum How to use checksums |
2736618ec4e8803fd795840a729522b07f775e2a26ad02903a9cfdca666449e8
|
| 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.0-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | lingtai-0.19.0-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 |
49e962a6b260658b97b5ecd94621bc9b73d52f0e8df1c976420d6c064ca01fc3
|
|
BLAKE2b-256 checksum How to use checksums |
3d216ffda9702efa3cee94e7b3a40eda8d6fd9b6c5d81303a309cfea55668d0e
|
| 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.0-cp313-cp313-macosx_10_13_x86_64.whl
| Download URL | lingtai-0.19.0-cp313-cp313-macosx_10_13_x86_64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.13 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
5c8fc252ed6b95395b13700f23ea9896ad678de09edb341567c30195043b56c0
|
|
BLAKE2b-256 checksum How to use checksums |
f8011574a657e5a3821a5fa3505401085c4bece8e286f6182a72bb30cfc8bf9f
|
| 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.0-cp312-cp312-win_amd64.whl
| Download URL | lingtai-0.19.0-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
73f12376445e0f127d028b9ab46c7934b0eb1a614cae6b47588e9d9e8e92a5e2
|
|
BLAKE2b-256 checksum How to use checksums |
dff659b219fd4080c541d03259d9d97cb903480aec068c7242e72992698e0e55
|
| 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.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | lingtai-0.19.0-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 |
59b78c72dc18ab8de2e9ce17ea01584261c540fce5134a78392b2e8c67fca0ad
|
|
BLAKE2b-256 checksum How to use checksums |
258572a9fd7f926e46b526346e975c09410b15a6b290c6cf34f11a60c6f4c17d
|
| 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.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | lingtai-0.19.0-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 |
422dbc67faf3da13ada08f0a58968e42a9fccfd839cc4604a9ba17770a6d530c
|
|
BLAKE2b-256 checksum How to use checksums |
e52ddb6667aab20875167aaf680c1ff4bc45175dfb2294c7f86e6208d79a377c
|
| 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.0-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | lingtai-0.19.0-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 |
c6ee2b5ab4c79c48331c5b99f4282d92ba83d1805b06005b6d76348ffd829778
|
|
BLAKE2b-256 checksum How to use checksums |
42b2d4a21c7d03ee86446b0320d198f140cbeafcc13e4c204c0e9e8dfabbac7d
|
| 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.0-cp312-cp312-macosx_10_13_x86_64.whl
| Download URL | lingtai-0.19.0-cp312-cp312-macosx_10_13_x86_64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.12 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
faa945facd88b937a60bcf0befab99c1545c535ca0d922d8e7eac5053f506956
|
|
BLAKE2b-256 checksum How to use checksums |
910f8bc09f3b43e9018e2c18e1903700b4185b47de4b7a4ce321b1bf9f6b2d66
|
| 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.0-cp311-cp311-win_amd64.whl
| Download URL | lingtai-0.19.0-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
e848f56064a69f58b5b627f134d9a5650f31d585912cb3707a7c74e8d984fb3e
|
|
BLAKE2b-256 checksum How to use checksums |
29582708624718f070100f1fc805975cdc00d24ec42c14a62de5bad678653ff0
|
| 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.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | lingtai-0.19.0-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 |
3879f92e6ddb1b36b8713f4ae63d6b0a33e6dbd7fa3716fb87e3ad97f68accdb
|
|
BLAKE2b-256 checksum How to use checksums |
639c544f67fbe12790b94cb78cfd1758221b57d15e6d4d6380628ad18e7d6fe3
|
| 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.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | lingtai-0.19.0-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 |
f073709465d8acfaf7f2ae0e0fb68a006c754e679a9e59d4c5c9c6e7f7792d41
|
|
BLAKE2b-256 checksum How to use checksums |
d1ed307f4dc4a5863e4f2dfad30bd1637ad0d4f4c3173964cd345c50725c59ff
|
| 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.0-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | lingtai-0.19.0-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 |
d8c14f90d92f39052476e9ef50fffef989c479bbb41f785034edb042247bee96
|
|
BLAKE2b-256 checksum How to use checksums |
7bddc4997a3a76ed9085d886dd7649b7947021df21ca549e1a20a27bfcbb5bcb
|
| 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.0-cp311-cp311-macosx_10_12_x86_64.whl
| Download URL | lingtai-0.19.0-cp311-cp311-macosx_10_12_x86_64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.11 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
fc5f40e677998cf3f673863a85268acbc99a2cfd1616c3baaea5cd0de293b40f
|
|
BLAKE2b-256 checksum How to use checksums |
adbe1db0152f418d59296011f443cbacfae8e8261f4b7fe0cda309f72e0d8cb1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
