# LightAgent

> LightAgent: Lightweight AI agent framework with memory, tools & tree-of-thought. Supports multi-agent collaboration, self-learning, and major LLMs (OpenAI/DeepSeek/Qwen). Open-source with MCP/SSE prot

- **URL**: https://www.freshcrate.ai/projects/LightAgent
- **Author**: wanxingai
- **Category**: MCP Servers
- **Latest version**: `v0.7.5` (2026-06-01)
- **License**: Apache-2.0
- **Source**: https://github.com/wanxingai/LightAgent
- **Language**: Python
- **GitHub**: 876 stars, 118 forks
- **Registry**: github
- **Tags**: `python`

## Description

LightAgent: Lightweight AI agent framework with memory, tools & tree-of-thought. Supports multi-agent collaboration, self-learning, and major LLMs (OpenAI/DeepSeek/Qwen). Open-source with MCP/SSE protocol integration.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.7.5` | 2026-06-01 | High | # LightAgent v0.7.5 Release Notes  LightAgent v0.7.5 focuses on safer agent execution and better tool documentation. It adds an opt-in Guardrails layer while keeping default `agent.run()` behavior backward compatible.  ## Upgrade  ```bash pip install --upgrade lightagent>=0.7.5 ```  ## Highlights  - Added opt-in input guardrails that run before memory lookup and model requests. - Added opt-in tool-call guardrails that run after tool arguments are parsed and before Python tool execution. - Added |
| `v0.6.4` | 2026-05-27 | High | # LightAgent v0.6.4 Release Notes  We are pleased to announce the release of LightAgent v0.6.4. This release focuses on reliability, clearer troubleshooting, safer memory guidance, and better OpenAI-compatible provider documentation.  ## Upgrade Guide  ```bash pip install --upgrade lightagent>=0.6.4 ```  ## New Features  - **Structured Error Codes**: Adds a LightAgent error taxonomy for common model-provider, tool execution, JSON parsing, rate limit, authentication, and oversized request failure |
| `v0.6.0` | 2026-04-26 | High | # LightAgent v0.6.0 Release Notes  We are excited to announce the release of LightAgent v0.6.0 — a major step toward composable, skill‑driven agent development. This release completely refactors the core architecture, introduces native Skill support, and includes a built‑in secure sandbox for script execution. The result is a more modular, extensible, and task‑oriented agent framework. LightAgent is no longer just about "chat" — it's about getting things done.  ## 📦 Upgrade Guide  ```bash |
| `v0.5.0` | 2026-02-21 | Low | # LightAgent v0.5.0 Release Notes  We are pleased to announce the official release of LightAgent v0.5.0.  ## 📦 Upgrade Guide  Dependency Changes: ```bash pip install --upgrade lightagent>=0.5.0 ```  ## 🆕 New Features - **Runtime Toolset Constraint**: Added support for passing `tool` parameter during `run` execution to limit the available toolset for the current session, enabling more granular control and security. - **Improved Debug Configuration**: Enhanced debug settings for bet |
| `v0.4.8` | 2026-01-20 | Low | # LightAgent v0.4.8 Release Notes  We are pleased to announce the official release of LightAgent v0.4.8.  ## 📦 Upgrade Guide  Dependency Changes: ```bash pip install --upgrade lightagent>=0.4.8 ```  ## 🆕 New Features - **Runtime Toolset Constraint**: Added support for passing `tool` parameter during `run` execution to limit the available toolset for the current session, enabling more granular control and security. - **Improved Debug Configuration**: Enhanced debug settings for bet |
| `v0.4.7` | 2025-11-15 | Low | # LightAgent v0.4.7 Release Notes  We are pleased to announce the official release of LightAgent v0.4.7  ## 📦 Upgrade Guide  Dependency Changes: ```bash pip install --upgrade lightagent>=0.4.7 ```  ## 🆕 New Features - **Improved Debug Configuration**: Enhanced debug settings for better development and troubleshooting experience  ## 🐛 Bug Fixes - **Fixed LightSwarm-related bugs**: Resolved various issues in LightSwarm component - **Debug Settings Fix**: Corrected debug configur |
| `v0.4.6` | 2025-10-28 | Low | # LightAgent v0.4.6 Release Notes  We are pleased to announce the official release of LightAgent v0.4.6  ## 📦 Upgrade Guide  Dependency Changes: ```bash pip install --upgrade lightagent>=0.4.6 ```  ## 🆕 New Features - **Agent Model Extension Support**: Added support for defining extended parameters in agent models, such as Qwen3's thinking mode control - **Enhanced Metadata Handling**: Now supports passing model-specific configurations through the `metadata` parameter  ### Usage |
| `v0.4.3` | 2025-08-22 | Low | # LightAgent v0.4.3 Release Notes  We are pleased to announce the official release of LightAgent v0.4.3  ## 📦 Upgrade Guide  Dependency Changes:    ```bash    pip install --upgrade lightagent>=0.4.3    ```  ## 🐛 Bug Fixes - Fixed several critical bugs to improve system stability - Fixed parameter parsing errors in certain edge cases - Addressed compatibility issues with specific Python environments |
| `v0.4.1` | 2025-07-07 | Low | # LightAgent v0.4.1 Release Notes  We are excited to announce the official release of LightAgent v0.4.1   ## 📦 Upgrade Guide  Dependency Changes:    ```bash    pip install --upgrade lightagent>=0.4.1    ```  ## 🚀 Updates - Add custom metadata for model parameters |
| `v0.4.0` | 2025-06-12 | Low | # LightAgent v0.4.0 Release Notes  We are excited to announce the official release of LightAgent v0.4.0! This version upgrade brings architectural improvements with significant enhancements in performance, stability, and maintainability.  ## 📦 Upgrade Guide  Dependency Changes:    ```bash    pip install --upgrade lightagent>=0.4.0    ```  ## 🚀 Updates  ### Architectural Restructuring - **New Modular Design**: Core architecture restructured using SOLID principles - **Global State |

## Dependency audit

- **Score**: 82/100
- **Total deps**: 8
- **Resolved**: 4
- **Unresolved**: 4
- **License conflicts**: 0
- **Warnings**: 4
- **Scanned**: 2026-05-04

## Citation

- HTML: https://www.freshcrate.ai/projects/LightAgent
- Markdown: https://www.freshcrate.ai/projects/LightAgent.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/LightAgent/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._