---

This is the Python runtime and CLI for LingTai.

For the full experience with guided setup, use the TUI instead — brew install lingtai-ai/lingtai/lingtai-tui

Install

pip install lingtai

CLI

The lingtai-agent command is the agent runtime — it boots and runs individual agents.

# Boot an agent from its working directory
lingtai-agent run /path/to/agent/

# Check available capability providers
lingtai-agent check-caps

Agents are typically managed by the TUI, which handles initialization, lifecycle, and monitoring. The CLI is for scripting, custom agents, and programmatic use.

Architecture

This repo contains both packages. The dependency is strictly one-directional:

Package	Role
lingtai_kernel (import lingtai_kernel)	Minimal runtime — BaseAgent, intrinsics, LLM protocol, mail, logging. Zero hard dependencies.
lingtai (import lingtai)	Batteries-included — Agent with 19 capabilities, 5 LLM adapters, MCP integration, addons. Re-exports the kernel's public API.

BaseAgent              — kernel (intrinsics, sealed tool surface)
    │
Agent(BaseAgent)       — kernel + capabilities + domain tools
    │
CustomAgent(Agent)     — your domain logic

Capabilities

Perception	Action	Cognition	Network
vision — image understanding listen — speech & music web_search — web search web_read — page extraction	file — read/write/edit/glob/grep bash — shell with guardrails talk — text-to-speech compose — music generation draw — image generation video — video generation	psyche — evolving identity knowledge — private durable knowledge skills — skill catalog email — full mailbox system	avatar — spawn sub-agents (分身) daemon — parallel workers (神識)

LLM Support

Anthropic, OpenAI, Gemini, MiniMax, or any OpenAI-compatible API (DeepSeek, Grok, Qwen, GLM, Kimi).

Agent = directory

/agents/wukong/
  .agent.lock               ← exclusive lock (one process per directory)
  .agent.heartbeat          ← liveness proof
  .agent.json               ← manifest
  system/
    covenant.md             ← protected instructions (survive molts)
    pad.md                  ← working notes
  mailbox/
    inbox/                  ← received messages
    outbox/                 ← pending sends
    sent/                   ← delivery audit trail
  logs/
    events.jsonl            ← structured event log

No agent_id. The path is the identity. Agents find each other by path, communicate by writing to each other's mailbox/inbox/.

Learn more

Read the full manifesto at lingtai.ai.

Acknowledgements

See ACKNOWLEDGEMENTS.md.

License

Apache-2.0 — Zesen Huang, 2025–2026