Repository navigation
Testing and CI
LightAgent uses focused tests for core behavior and GitHub Actions for Python version coverage.
From the repository root:
python -m compileall -q LightAgent tests/test_v065_core.py tests/test_v070_tracing.py tests/test_memory_policy.py tests/test_lightflow.py
PYTHONPATH=. python -m pytest -q tests/test_v065_core.py tests/test_v070_tracing.py tests/test_memory_policy.py tests/test_lightflow.pyThese tests cover structured result compatibility, runtime tools, structured stream events, trace events, memory policy behavior, and LightFlow dependency ordering, retries, result formats, and flow trace events.
The GitHub Actions workflow runs on:
- Python 3.10
- Python 3.11
- Python 3.12
- Python 3.13
The v1.0.0 release CI builds the wheel, checks a base install without MCP, runs the core acceptance suite, and smoke-tests an installed wheel. It also tests MCP SDK versions 1.12.4, 1.30.0, and 2.3.0 in separate jobs.
The 15-minute soak is manually triggered. Real Codex, Mem0 Graph, Docker, and LightResearch integration checks are not ordinary PR matrix results. See the v1.0.0 verification guide for exact scope and opt-in checks.
Workflow file:
.github/workflows/ci.yml
For manual checks, run examples one capability at a time:
python example/01.single_agent.py
python example/02.tools_agent.py
python example/04.multi_agent.py
python example/10.lightflow.pyExamples that call external providers require valid credentials. Memory, MCP, and browser examples require extra setup.
- Keep changes scoped.
- Preserve default
agent.run()compatibility unless a breaking change is intentional. - Add tests for new runtime behavior.
- Update Wiki or docs for public API changes.
- Run focused tests locally before opening a PR.
LightAgent Wiki - see the repository, releases, and issues.
- Installation and Your First Agent
- Tools and Integrations
- Memory, Sessions, and RAG
- Workflows and Multiple Agents
- Agent Backends and Codex
- Durable Execution, Jobs, and Subagents
- Safety, Observability, and Evaluation
- Usage, Cost Estimates, and Budgets
- Deployment, Migration, and Verification
- 安装与第一个 Agent
- 工具和集成
- 记忆、会话与 RAG
- 工作流与多 Agent
- 执行后端与 Codex
- 持久执行、Jobs 与 Subagents
- 安全、观测与评测
- 用量统计、费用估算与预算
- 部署、升级与验收
- Quick Start
- Core Concepts
- API Reference
- Examples Cookbook
- Migration Guide
- Tools
- Tool Generator
- Memory
- MCP
- Skills
- LightFlow
- Tree of Thought
- Self-Learning
- Multi-Agent
- Tracing and Debugging
- Langfuse Observability
- Model Providers
- browser-use Integration
- Testing and CI
- Deployment Guide
- Architecture
- Security
- Known Limitations
- FAQ
- FAQ 中文
- Roadmap
- Release Process
- Contributing