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.1
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.1.tar.gz | 3.0 MB | Details |
Built distributions (wheels)
Total release size: 53.1 MB
Release files / lingtai-0.19.1.tar.gz
| Download URL | lingtai-0.19.1.tar.gz |
|---|---|
| Size | 3.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
90471f3d1590fab2b27122578482a9e3a8002ba6caa0f1358b203eec253432aa
|
|
BLAKE2b-256 checksum How to use checksums |
ca9cf80aca8cfa1c23290f11249b1cee53855ecf6488dd6e543a9865d519cdc5
|
| 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.1-cp313-cp313-win_amd64.whl
| Download URL | lingtai-0.19.1-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
e1cafbc45c721369a0baf540695b642422550370f7c820445fed0d0ec5950638
|
|
BLAKE2b-256 checksum How to use checksums |
a0e1b5972c9efac9e5cec0f8594ac2b2c2721065153d9242bd7b08f22fdcb34a
|
| 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.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | lingtai-0.19.1-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 |
a1990d62467a546a76bd59a6c56f66baa4d004b95f1e4d5b343e382647dac747
|
|
BLAKE2b-256 checksum How to use checksums |
e4112da0fdd09540e73dc6855568fbc4ab1a2ebb994b0f10bcffb76e3773a834
|
| 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.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | lingtai-0.19.1-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 |
a64a683793a39770db439f365539acf2bc5a3ec5773ff70a9cb8fda5cf02c1bc
|
|
BLAKE2b-256 checksum How to use checksums |
29e884898dee9b1d9c9f38a9671eb75fc78d8a3dbf6d33f3b6ff223d0889e276
|
| 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.1-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | lingtai-0.19.1-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 |
84219fd990391f720e59fea83a1367068b8bd7eecd762317b3831b864ee3d196
|
|
BLAKE2b-256 checksum How to use checksums |
a1b9fe4c0cb236ec5d3ac45030cca61c499c7e5cefdc2142e4e9bf96de1fa003
|
| 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.1-cp313-cp313-macosx_10_13_x86_64.whl
| Download URL | lingtai-0.19.1-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 |
feb12ca4598f64f2bfcc1891cec8d20eb4dd45565ead832077d308681038afc7
|
|
BLAKE2b-256 checksum How to use checksums |
5893e2c2c6daa11533c520902a37c8b3a250c67892253eadb6c8ad60c01e5c91
|
| 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.1-cp312-cp312-win_amd64.whl
| Download URL | lingtai-0.19.1-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
1c2cd1012447f9489095120d9cf7437c080562617239bb517a32f85807287912
|
|
BLAKE2b-256 checksum How to use checksums |
95f8e7163dd95a11b0e143c2512cdb2876ed2e9d1e04d95f0d5e2ea902553f4d
|
| 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.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | lingtai-0.19.1-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 |
7e4fc4e1fdd8abbfc967f3ae44dd998cfead06c8d6b6e235505f6f844937305d
|
|
BLAKE2b-256 checksum How to use checksums |
27203ccbeccd9a7083148e491912dca0bcd50860d84d6d93427900a5df1b3c96
|
| 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.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | lingtai-0.19.1-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 |
de9f40e79e8b7e62a8e99b265d8f38955b6fe00d908c39c30d20d546e6d43890
|
|
BLAKE2b-256 checksum How to use checksums |
1b03ac0e2f849e0a846774f2ac5d7927434b2fdb6d886c8ab0dcbf16e9841e81
|
| 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.1-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | lingtai-0.19.1-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 |
50836e34dc6d6956e19896e72807d56e6814de7f6da2a95f3aeed51f4e2e51f5
|
|
BLAKE2b-256 checksum How to use checksums |
5934af15684b6cb9eb71322c79c9ba6a9bf66d8a0749f9298c6b39a42e12da94
|
| 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.1-cp312-cp312-macosx_10_13_x86_64.whl
| Download URL | lingtai-0.19.1-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 |
0dc115f21cdb3a2aac867a96e1c519e07636c62d5fdeb10c119139fda3d859db
|
|
BLAKE2b-256 checksum How to use checksums |
bf30e3b070673772ea4d5d1eef7264b9afdb0c7fc642af2c09120ba46a8f9e71
|
| 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.1-cp311-cp311-win_amd64.whl
| Download URL | lingtai-0.19.1-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
a254e235b22e950f464e98753d8ac3d336f5c8b920d5fea37141713c759c8fb8
|
|
BLAKE2b-256 checksum How to use checksums |
97f0f401c6d6ace7e6d7bf725d50460a3a030daabe114cfc1b48dda6bf5f7562
|
| 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.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | lingtai-0.19.1-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 |
de9e3208380bcc6a1a13d7e635e6cd7207d5bcd8894392eeb8073e0bc593b361
|
|
BLAKE2b-256 checksum How to use checksums |
8b236e93ab91a03f464144ada4945105ea9536555e3905492dd02c1e0a9aabd3
|
| 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.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | lingtai-0.19.1-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 |
b35d9e5c796ca80fe96fcee93ef941a83bc705749749daa34b218fdc0928a8e7
|
|
BLAKE2b-256 checksum How to use checksums |
e7b91d2d94f3b922a39256097f3ee4b4800740a15d04e24db04d1f00979cf3d2
|
| 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.1-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | lingtai-0.19.1-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 |
e3ca1c3d8b248a3cc9aadd54b0f271a565bdea568252adf85f4165a8c7587ca5
|
|
BLAKE2b-256 checksum How to use checksums |
3de6a68f769a46daca2aa451693bc548639f81840a9af4e50b648231ba1463eb
|
| 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.1-cp311-cp311-macosx_10_12_x86_64.whl
| Download URL | lingtai-0.19.1-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 |
bd1eec9bd0e8965d42adc27063ffd9c3508c445b9e11329ae5f653d9e785d998
|
|
BLAKE2b-256 checksum How to use checksums |
9f589ea490078108f2ef8f5ae52a8927e77d9996b12d347201d3513ca678b2e4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
