English | 简体中文
PDF reports:
- New: Hermes Agent Source Code Deep Dive
- Claude Code: ai-agent-deep-dive-v2.1.pdf, including the new Chapter 8: Memory System.
- Claude Code: ai-agent-deep-dive-v2.pdf.
This repository also includes a minimal Python agent built for learning, demonstrating how to structure the core components of an AI agent.
- Agent core:
src/agt/agent.py - CLI entry point:
src/agt/cli.py - Learning materials:
docs/
This minimal agent is designed for educational use, with an emphasis on:
- Keeping the structure clear.
- Avoiding unnecessary engineering complexity.
- Keeping the core code small and easy to explore.
- Focusing on the agent loop, a Fake LLM interface, skill discovery, and the CLI skeleton.
The project uses Poetry to manage dependencies.
poetry installpoetry run agt "Hello"poetry run agt --skills-dir ./skills --list-skillsThe current version is a minimal educational implementation. It does not yet connect to a real remote model API.
It includes a replaceable Fake LLM that returns a test response in streamed text chunks for each user input.
This keeps the model integration separate from the agent itself: connecting a real model later only requires replacing the LLM call layer, rather than rewriting the agent.
