lingtai-ai/lingtai-kernel

---

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, 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), and lingtai, the batteries-included runtime, CLI, and services that build Agent(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, and the packaging (a pure-Python distribution). 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. The code baseline remains open-ended at Python

= 3.11, while the managed macOS runtime and direct dependency follow this wheel compatibility matrix: