git404hub

what is agentmaker fr?

xinhuangcs/agentmaker — explained in plain English

Analysis updated 2026-05-18

79PythonAudience · developerComplexity · 3/5LicenseSetup · easy

tl;dr

A Python framework for building AI agents with memory, tool use, and document search built in, working with most major AI model providers.

vibe map

mindmap
  root((agentmaker))
    What it does
      Agent loop with tools
      Long term memory
      RAG and retrieval
      Trace Detective debugger
    Tech stack
      Python 3.12
      SQLite default
      Any LLM provider
      MCP tool support
    Use cases
      Chat agent with tools
      Memory across sessions
      Document backed answers
      Debugging failed runs
    Audience
      Python developers
      AI agent builders
      LLM app teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Build an AI agent that remembers facts about a user across conversations.

VIBE 2

Turn any Python function into a tool an AI agent can call automatically.

VIBE 3

Set up retrieval augmented generation so an agent can answer from your own documents.

VIBE 4

Debug a failed agent run using the built in Trace Detective tool that pinpoints the cause.

what's the stack?

PythonSQLiteOpenAIAnthropicGeminiOllama

how it stacks up fr

xinhuangcs/agentmakerbaoxin1100/ok-keshappy-chen-ch/text_classification
Stars797979
LanguagePythonPythonPython
Setup difficultyeasyeasyhard
Complexity3/52/54/5
Audiencedevelopergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Requires Python 3.12 or newer, and an API key for whichever LLM provider you connect.

in plain english

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.

prompts (copy fr)

prompt 1
Help me install agentmaker and build a simple agent with one custom tool using DeepSeek.
prompt 2
Show me how to add long term memory to an agentmaker agent so it remembers my preferences.
prompt 3
Explain how to connect an MCP server as a tool source in agentmaker.
prompt 4
Walk me through setting up Trace Detective to debug why my agentmaker run failed.

Frequently asked questions

what is agentmaker fr?

A Python framework for building AI agents with memory, tool use, and document search built in, working with most major AI model providers.

What language is agentmaker written in?

Mainly Python. The stack also includes Python, SQLite, OpenAI.

How hard is agentmaker to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is agentmaker for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.