MiniAgent

About

MiniAgent is built as an agent textbook: the entire engine — LLM interaction, tool dispatch, context compression — sits in one readable agent.py of about a thousand lines, positioned as an alternative to opaque frameworks like LangChain or pydantic-ai. Its design argument is that a small tool surface composes further than a large one: six code tools plus bash cover coding, while OS tools (browser, apps, clipboard, document creation) extend it toward Manus-style desktop control, and new tools register with a three-line decorator. Tool calling runs in two modes — transparent text parsing for learners and native function calling for reliability — with dangerous commands intercepted for confirmation. Skill objects bundle a prompt with a tool whitelist into reusable roles (coder, researcher, reviewer, tester), and an optional MCP client loads external servers' tools into the same namespace. Learners and tinkerers use it to read and modify a complete agent in one sitting rather than navigate a framework.