Home

LightAgent Wiki

LightAgent is a lightweight Python agent framework for building tool-using agents, memory-enabled agents, MCP-connected agents, Skills-first workflows, deterministic LightFlow workflows, and simple multi-agent collaboration.

This wiki documents the current main branch of wanxingai/LightAgent. The latest published release may differ from main; check GitHub Releases when pinning a production version.

Why LightAgent

• Small Python-native core for agent applications.
• OpenAI-compatible chat completion API support.
• Direct Python function tools with OpenAI-style function schemas.
• Runtime tools, built-in tools, and dynamic tool loading.
• External memory through a small store() and retrieve() protocol.
• MCP integration over stdio and SSE.
• Skills based on SKILL.md files for reusable task instructions.
• LightFlow for deterministic DAG-style multi-step workflows.
• LightSwarm for simple multi-agent routing.
• Optional structured run results, stream events, and trace events.

Start Here

Goal	Page
Install and run the first agent	Quick Start
Understand the core runtime	Core Concepts
Add Python tools	Tools
Add memory safely	Memory
Connect MCP tools	MCP
Use reusable Skills	Skills
Build deterministic multi-step workflows	LightFlow
Build multi-agent workflows	Multi-Agent
Use Tree of Thought planning	Tree of Thought
Enable self-learning behavior	Self-Learning
Generate tool code	Tool Generator
Use browser automation	browser-use Integration
Debug runs and traces	Tracing and Debugging
Connect Langfuse	Langfuse Observability
Configure providers and local models	Model Providers
Check API parameters and return types	API Reference
Find runnable examples	Examples Cookbook
Upgrade between versions	Migration Guide
Understand current constraints	Known Limitations
Run tests and CI checks	Testing and CI
Deploy an app	Deployment Guide
Review production safety guidance	Security
Check common answers	FAQ
Track planned work	Roadmap

Repository Links

• Repository: https://github.com/wanxingai/LightAgent
• Releases: https://github.com/wanxingai/LightAgent/releases
• Issues: https://github.com/wanxingai/LightAgent/issues
• Pull requests: https://github.com/wanxingai/LightAgent/pulls
• PyPI: https://pypi.org/project/lightagent/
• English README: https://github.com/wanxingai/LightAgent/blob/main/README.md
• Chinese README: https://github.com/wanxingai/LightAgent/blob/main/README.zh-CN.md

Documentation Map

• Getting started: Quick Start, Examples Cookbook, FAQ
• Core APIs: Core Concepts, API Reference, Migration Guide
• Capabilities: Tools, Memory, MCP, Skills, LightFlow, Tree of Thought, Multi-Agent
• Operations: Tracing and Debugging, Langfuse Observability, Testing and CI, Deployment Guide, Security
• Project process: Roadmap, Release Process, Contributing