A teaching framework that demonstrates Reflexion, Multi-Agent Orchestration, Memory, and Tool Use β the cutting edge of agentic AI.
| Concept | Where to Look |
|---|---|
| ReAct Reasoning Loop | core/agent.py β run() method |
| Reflexion (Self-Improvement) | core/reflexion.py |
| Short + Long-Term Memory | core/memory.py |
| Tool Registration & Calling | core/tools.py |
| Multi-Agent Orchestration | agents/orchestrator.py |
| Adversarial Critic Agent | agents/critic.py |
| Agent-as-a-Judge | agents/judge.py |
| Visual Trace Logging | core/trace.py |
βββββββββββββββββββββββββββββββββββββββ
β TASK INPUT β
ββββββββββββββββ¬βββββββββββββββββββββββ
βΌ
βββββββββββββββββββββββββββββββββββββββ
β PLANNER AGENT β
β Breaks task into subtasks β
ββββββββββββββββ¬βββββββββββββββββββββββ
βΌ
βββββββββββββββββββββββββββββββββββββββ
β WORKER AGENTS (parallel) β
β Each tackles a subtask β
ββββββββββββββββ¬βββββββββββββββββββββββ
βΌ
βββββββββββββββββββββββββββββββββββββββ
β CRITIC AGENT (adversarial) β
β Finds flaws, challenges outputs β
ββββββββββββββββ¬βββββββββββββββββββββββ
βΌ
βββββββββββββββββββββββββββββββββββββββ
β REFLEXION LAYER β
β Reflects on failures, β
β generates verbal critique, β
β updates strategy, retries β
ββββββββββββββββ¬βββββββββββββββββββββββ
βΌ
βββββββββββββββββββββββββββββββββββββββ
β JUDGE AGENT β
β Synthesizes final answer + scores β
βββββββββββββββββββββββββββββββββββββββ
# Install dependencies
pip install -r requirements.txt
# Set your API key
export OPENAI_API_KEY="sk-..."
# Run the demo
python examples/demo.py
# Run with a custom task
python examples/demo.py --task "Design a scalable architecture for a real-time chat application"- Readable β Every file is small enough to read in one sitting
- Honest β No magic. Every decision is commented.
- Extensible β Add a new agent? Subclass
BaseAgent. Add a tool? Register it. - Observable β Full trace of every thought, action, and reflection.
MIT β Use it, teach it, break it, learn from it.
Built by Nagarjuna Reddy Kamireddy (Nagarjuna Kamireddy / Nagarjuna K) β Lead AI Architect, GenAI & Agentic AI Lead, and Corporate AI Trainer (20+ years across Enterprise Data, SAP HANA & Production AI; AWS Certified Solutions Architect β Professional & NVIDIA-Certified Professional: Agentic AI).
- Official Portfolio & Architecture Hub: https://nagarjunak-pixel.github.io/
- Enterprise Case Studies & Technical Articles: Case Studies Β· Architecture Articles Β· 10-Mandate Role Fit
- Master CV & AI Search Index: Master CV Β·
llms-full.txtΒ· LinkedIn