Repository navigation
🚀 v0.1.1 - The Explainable Agent Lab is now on PyPI!
We are thrilled to announce the first official PyPI release of the Explainable Agent Lab! 🎉
This release transforms the project from a local repository into a fully installable Python library (pip install explainable-agent) and introduces powerful new features designed to make AI agents transparent, robust, and easy to build.
✨ Key Features in This Release
- Self-Healing Capabilities: Agents can now automatically catch their own errors (like schema violations or tool failures), analyze the root cause (
error_analysis), propose solutions (proposed_fix), and recover by calling alternative tools. - Visual Terminal Tracking: Added
--verbosemode powered byrich, providing beautiful, colorful, step-by-step interactive logs right in your terminal. You can watch the agent's "Rationale", "Confidence", and "Tool Output" in real-time. - Actionable Diagnostic Reports: At the end of every run, the framework generates a detailed
report.mdthat highlights hallucination risks, potential infinite loops, and gives concrete suggestions to improve your system prompts. - Python API & Extensibility: You can now import the agent directly into your own Python codebases. Added the
@define_tooldecorator, making it incredibly simple to attach custom Python functions as agent tools. - Global CLI Access: Run agents directly from your terminal using the global
explainable-agentcommand, supporting both LM Studio and Ollama right out of the box.
📦 Installation
It is now easier than ever to get started:
pip install explainable-agent
Run with Ollama
explainable-agent --base-url http://localhost:11434/v1 --model ministral-3:14b --task "calculate_math: (215*4)-12" --verbose
Run with LM Studio
explainable-agent --model qwen/qwen3-vl-4b --task "duckduckgo_search: What are the latest updates in Python 3.13?" --verbose
For more details on programmatic usage and custom dataset evaluations, check out the updated README and the examples/ directory!