explaingit

garyqlin/gbase

22PythonAudience · developerComplexity · 3/5Setup · moderate

TLDR

A Python framework for building AI agents that remember past sessions, can rewrite their own instructions to improve over time, and come loaded with 40+ tools, compatible with any OpenAI-format API including local models.

Mindmap

mindmap
  root((GBase))
    What it does
      AI agent framework
      Persistent memory
      Self-improvement
    Tech stack
      Python
      OpenAI API compatible
      Vector database
    Use cases
      Long-term agents
      Recurring tasks
      Custom tool agents
    Features
      40 plus tools
      Quality gates
      Sub-agent roles
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Build an AI agent that remembers earlier conversations and recalls past experiences when handling new requests in later sessions.

USE CASE 2

Add a custom tool to your agent by writing a Python function with a decorator so the language model can call it automatically without extra wiring.

USE CASE 3

Trigger the self-improvement method to have your agent analyze its past outputs, spot weak patterns, and rewrite its own instructions for better future runs.

USE CASE 4

Schedule a recurring automated task directly inside GBase without needing an external scheduling tool like cron or Celery.

Tech stack

PythonOpenAI API

Getting it running

Difficulty · moderate Time to first run · 30min

Requires an OpenAI-compatible API key set in an environment file, works with local model servers too.

No license information is provided in the explanation.

In plain English

GBase is a Python framework for building AI agents: software programs that use a large language model to think through tasks and take actions automatically. Unlike simpler agent setups where the AI handles a request and immediately forgets the context, GBase gives agents a persistent memory system so they can recall things from earlier sessions, not just the current conversation. The framework's headline feature is what the README calls recursive self-improvement. When triggered by calling a specific method in code, the agent analyzes its own past outputs, identifies patterns where it performed poorly, and rewrites its own instructions before the next run. This is not a process that runs automatically on its own, it is something a developer or the agent itself deliberately kicks off. Other built-in components include a quality gate system where separate agent roles review each other's work before output is accepted, a scheduler for setting up recurring tasks without an external scheduling tool, and an experience engine that distills past interactions into structured knowledge the agent can query later. Over 40 tools come pre-loaded, and new ones can be added by writing a Python function with a decorator, which makes the function automatically available to the language model without extra wiring. The framework works with any API following the OpenAI format, including hosted services and local setups. Configuration is done through an environment file where you set your API key and preferences. Multiple agent personas can be defined and swapped, and the framework includes a sub-agent mode for running specialized roles like code review or frontend work on separate local ports. The author describes this as one part of a broader set of projects, with separate tools for multi-agent coordination and a virtual environment where agents can operate with persistent identities.

Copy-paste prompts

Prompt 1
I'm building a GBase agent that needs to remember customer support interactions across sessions. Set up the persistent memory system and show me how to query past experiences during a new conversation.
Prompt 2
Help me add a custom tool to my GBase agent that calls a weather API and returns the current forecast whenever the agent needs weather information.
Prompt 3
I want to trigger GBase's recursive self-improvement on my agent. Show me which method to call and how to read the updated instructions afterward.
Prompt 4
Configure GBase to use a local Ollama model instead of a hosted OpenAI API and show me the environment file settings I need to change.
Prompt 5
Set up two GBase agent personas, one for customer support and one for code review, and show me how to switch between them at runtime.
Open on GitHub → Explain another repo

← garyqlin on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.