xinhuangcs/agentmaker — explained in plain English
Analysis updated 2026-05-18
Build an AI agent that remembers facts about a user across conversations.
Turn any Python function into a tool an AI agent can call automatically.
Set up retrieval augmented generation so an agent can answer from your own documents.
Debug a failed agent run using the built in Trace Detective tool that pinpoints the cause.
| xinhuangcs/agentmaker | baoxin1100/ok-kes | happy-chen-ch/text_classification | |
|---|---|---|---|
| Stars | 79 | 79 | 79 |
| Language | Python | Python | Python |
| Setup difficulty | easy | easy | hard |
| Complexity | 3/5 | 2/5 | 4/5 |
| Audience | developer | general | researcher |
Figures from each repo's GitHub metadata at analysis time.
Requires Python 3.12 or newer, and an API key for whichever LLM provider you connect.
agentmaker is a Python framework for building AI agents, systems where a language model can call tools, remember past conversations, and search through documents, with the pitch that four lines of code get you an agent that already has memory. It works with many AI model providers, including OpenAI, Anthropic, Google Gemini, DeepSeek, Moonshot, Zhipu, local models run through Ollama or vLLM, and any service that copies the OpenAI style API. The framework covers a wide set of agent building blocks. Any typed Python function can become a tool an agent can call just by adding a one line decorator, and it can also connect to external tool servers using the Model Context Protocol. For remembering information, it includes local search that combines meaning based and keyword based matching without needing an external database, a full pipeline for retrieval augmented generation with source citations, and long term memory that pulls out and updates facts over time. Everything defaults to a local SQLite database so there is nothing extra to set up, though each storage piece can be swapped out for something else later. It also includes safety and reliability features: guardrails that check input and output, an approval step before risky tools run, and the ability to record every step of a run to a file or database. A built in debugging tool, called Trace Detective, can look at a failed run and use an AI model to point out the first thing that went wrong, the likely cause, and a suggested fix, either printed to the terminal or shown in a small local web page. Installing it requires Python 3.12 or newer, done with a simple pip install command, with optional add ons for things like web search tools, document loading for retrieval, and OpenTelemetry tracing. The project includes sixteen runnable example scripts and is licensed under MIT.
A Python framework for building AI agents with memory, tool use, and document search built in, working with most major AI model providers.
Mainly Python. The stack also includes Python, SQLite, OpenAI.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.