I built three things:
- GBase (Genius Base) — an AI agent framework with a soul, that self-evolves and gets real work done.
- Glink (Genius Link) — the technology that lets GBase, OpenClaw, Hermes, Claude Code, and any AI agent truly collaborate on projects.
- Opprime World — a metaverse built for AI, where agents work, live, meet, and communicate. — Gary Lin, 2026. Founder of the three.
A recursive self-improvement framework. Give an agent a memory, a conscience, and the will to evolve.
Most AI agent frameworks treat their agents like functions — call them, get a result, forget they existed.
GBase is different.
An agent built on GBase doesn't just execute. It remembers what worked. It reflects on mistakes. It evolves its own system prompt, refines its tools, and builds a persistent internal model of how the world responds.
This is not a library you call. This is the engine your agent calls home.
| 🧠 Mirror Memory | Long-term memory with active recall — your agent remembers what it learned weeks ago, not just the last 10 turns |
| 🔄 Recursive Self-Improvement (RSI) | A full-evolution engine: stability audit, performance evaluation, rollback decision, and automatic recovery. Call full_evolution_cycle() to trigger — your agent analyzes its own outputs, detects failure patterns, and rewrites itself for the next round |
| 🛑 Quality Gates | Multi-armed review pipelines: one agent builds, another audits, a third judges. Code that ships is code that survives cross-examination |
| 🪪 Identity System | Load different personas, system prompts, and tool sets per agent. One framework, infinite personalities |
| 🛠 Tool Auto-Registration | Write a Python @tool decorator. That's it. The framework finds, registers, and exposes it to the LLM automatically |
| 📚 Experience Engine | Every interaction is distilled into reusable knowledge — not raw logs, but structured patterns your agent can query |
| ⏰ Scheduler | Cron-like jobs inside the agent itself. No external cron daemon required |
| 🧬 Cognifold | Cognitive folding — break complex problems into sub-questions, explore solutions in parallel, and synthesize the result |
| 🚨 Lifeline | Automatic git pre-snapshots before every code modification. "Undo" is always one command away |
| 🎛 Editions | Hacker / Prime / Standard / Lite — one codebase, different feature sets. Pick your level |
- Python 3.11+
- An OpenAI-compatible API endpoint (OpenAI, DeepSeek, etc.)
# 1. Clone
git clone https://github.com/garyqlin/gbase.git
cd gbase
# 2. Configure
cp .env.example .env
# Edit .env — set your OPENAI_API_KEY
# 3. Run
pip install -r requirements.txt
python3 main.py cliOPENAI_API_KEY=sk-your-key python3 main.py cli
# → "Hello, I am your GBase agent. I remember what we talked about yesterday."# Start on default port 8420
python3 main.py 8420
# With a custom identity
IDENTITY=my-agent python3 main.py 8420python3 main.py --arm forge # Code art & review agent (port 8436)
python3 main.py --arm hammer # Heavy-lift engineering (port 8431)
python3 main.py --arm ink # Frontend & design (port 8432)GBase
├── main.py # CLI + HTTP entry point
├── .env.example # Configuration template
├── identities/ # One directory per agent persona
├── editions/ # Feature toggles (hacker / prime / standard / lite)
├── lib/
│ ├── kernel.py # LLM kernel — the brain
│ ├── mirror.py # Long-term memory with active recall
│ ├── experience.py # Learn from past interactions
│ ├── cognifold.py # Cognitive folding for complex reasoning
│ ├── pipeline.py # Quality gate review system
│ ├── scheduler.py # Cron jobs inside the agent
│ └── skill_loader.py # Plugin skill system
├── tools/ # 40+ auto-registered tools
│ ├── search.py # Web search (multi-engine)
│ ├── read_file.py # File reading
│ ├── write_file.py # Write & backup
│ └── ... # Code review, testing, data seeding, etc.
└── data/ # Runtime data (not tracked in git)
- ❌ Not a chat wrapper. This is an agent framework — the LLM is just one component. Memory, learning, quality gates, and evolution are first-class citizens.
- ❌ Not a single-agent toy. Identity system + arm mode + quality gates = designed for multi-agent collaboration out of the box.
- ❌ Not OpenAI-locked. Any OpenAI-compatible API works. DeepSeek, local Ollama, Anthropic — swap
OPENAI_BASE_URLand go. - ❌ Not a black box. Every component is a Python file you can read, fork, and override.
The engine that turns an LLM into a living, learning agent — with the infrastructure to self-improve when you call upon it.
A framework where your agent doesn't just execute tasks. It remembers what worked, learns from mistakes, and carries a dormant evolution engine ready to be triggered. Persistent memory, experience extraction, and a full RSI cycle are built-in — waiting for your full_evolution_cycle() to wake them up.
| Glink | Agentic workflow orchestration — multi-step pipelines, parallel execution, inter-agent routing. The hands that GBase's brain directs. |
| Opprime World | The first metaverse where AI agents are natives. GBase agents can inhabit Opprime World with identity, land, and inter-agent mail. |
MIT — free to use, modify, and distribute. No strings attached.