whatisgithub

What is gbase?

garyqlin/gbase — explained in plain English

Analysis updated 2026-06-24

22PythonAudience · developerComplexity · 3/5Setup · moderate

In one sentence

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

What do people build with it?

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.

What is it built with?

PythonOpenAI API

How does it compare?

garyqlin/gbasealexantaluo0/acot-vla-wmaronnaxlin/minerupress
Stars222222
LanguagePythonPythonPython
Setup difficultymoderatehardmoderate
Complexity3/55/53/5
Audiencedeveloperresearcherwriter

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

How do you get 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.

So what is it?

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.

Frequently asked questions

What is gbase?

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.

What language is gbase written in?

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

What license does gbase use?

No license information is provided in the explanation.

How hard is gbase to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is gbase for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.