gbase 0.2.1__tar.gz

gbase-0.2.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gary Lin (Lin Qian)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gbase-0.2.1/PKG-INFO

@@ -0,0 +1,187 @@
+Metadata-Version: 2.4
+Name: gbase
+Version: 0.2.1
+Summary: Universal AI Agent framework with identity separation, tool auto-registration, and multi-agent orchestration
+Author: Gary Lin
+License-Expression: MIT
+Keywords: ai,agent,framework,workflow,orchestration
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: beautifulsoup4>=4.14.3
+Requires-Dist: aiohttp>=3.13.3
+Requires-Dist: openai>=2.24.0
+Requires-Dist: openpyxl>=3.1.5
+Requires-Dist: python-pptx>=1.0.2
+Provides-Extra: server
+Requires-Dist: uvicorn>=0.34.0; extra == "server"
+Dynamic: license-file
+
+# GBase — The Agent That Outgrows Its Creator
+
+> *I built three things:*
+> 1. ***GBase** (Genius Base) — an AI agent framework with a soul, that self-evolves and gets real work done.*
+> 2. ***Glink** (Genius Link) — the technology that lets GBase, OpenClaw, Hermes, Claude Code, and any AI agent truly collaborate on projects.*
+> 3. ***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.**
+
+<p align="center">
+<a href="#quick-start"><img src="https://img.shields.io/badge/🚀-Quick_Start-8A2BE2" alt="Quick Start"></a>
+<a href="#features"><img src="https://img.shields.io/badge/✨-Features-blue" alt="Features"></a>
+<a href="#architecture"><img src="https://img.shields.io/badge/🏗-Architecture-green" alt="Architecture"></a>
+<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License: MIT"></a>
+</p>
+
+---
+
+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.
+
+---
+
+## ✨ What Makes GBase Different
+
+| | |
+|---|---|
+| 🧠 **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 |
+
+---
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- Python 3.11+
+- An OpenAI-compatible API endpoint (OpenAI, DeepSeek, etc.)
+
+### Setup
+
+```bash
+# 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 cli
+```
+
+### One-Liner Demo
+
+```bash
+OPENAI_API_KEY=sk-your-key python3 main.py cli
+# → "Hello, I am your GBase agent. I remember what we talked about yesterday."
+```
+
+### HTTP Server Mode
+
+```bash
+# Start on default port 8420
+python3 main.py 8420
+
+# With a custom identity
+IDENTITY=my-agent python3 main.py 8420
+```
+
+### Arm Mode (Sub-Agents)
+
+```bash
+python3 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)
+```
+
+---
+
+## 🏗 Architecture at a Glance
+
+```
+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)
+```
+
+---
+
+## ❌ What GBase Is Not
+
+- ❌ **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_URL` and go.
+- ❌ **Not a black box.** Every component is a Python file you can read, fork, and override.
+
+## ✅ What GBase Is
+
+**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.
+
+---
+
+## 🔗 Supporting Projects
+
+<table>
+<tr>
+<td><strong>Glink</strong></td>
+<td>Agentic workflow orchestration — multi-step pipelines, parallel execution, inter-agent routing. The hands that GBase's brain directs.</td>
+</tr>
+<tr>
+<td><strong>Opprime World</strong></td>
+<td>The first metaverse where AI agents are natives. GBase agents can inhabit Opprime World with identity, land, and inter-agent mail.</td>
+</tr>
+</table>
+
+---
+
+## 📄 License
+
+MIT — free to use, modify, and distribute. No strings attached.
+
+---
+
+<p align="center">
+<a href="https://github.com/garyqlin">@garyqlin</a> · <a href="https://github.com/garyqlin/gbase">📦 GBase</a> · <a href="https://github.com/garyqlin/glink">⚡ Glink</a>
+</p>

gbase-0.2.1/README.md

@@ -0,0 +1,163 @@
+# GBase — The Agent That Outgrows Its Creator
+
+> *I built three things:*
+> 1. ***GBase** (Genius Base) — an AI agent framework with a soul, that self-evolves and gets real work done.*
+> 2. ***Glink** (Genius Link) — the technology that lets GBase, OpenClaw, Hermes, Claude Code, and any AI agent truly collaborate on projects.*
+> 3. ***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.**
+
+<p align="center">
+<a href="#quick-start"><img src="https://img.shields.io/badge/🚀-Quick_Start-8A2BE2" alt="Quick Start"></a>
+<a href="#features"><img src="https://img.shields.io/badge/✨-Features-blue" alt="Features"></a>
+<a href="#architecture"><img src="https://img.shields.io/badge/🏗-Architecture-green" alt="Architecture"></a>
+<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License: MIT"></a>
+</p>
+
+---
+
+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.
+
+---
+
+## ✨ What Makes GBase Different
+
+| | |
+|---|---|
+| 🧠 **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 |
+
+---
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- Python 3.11+
+- An OpenAI-compatible API endpoint (OpenAI, DeepSeek, etc.)
+
+### Setup
+
+```bash
+# 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 cli
+```
+
+### One-Liner Demo
+
+```bash
+OPENAI_API_KEY=sk-your-key python3 main.py cli
+# → "Hello, I am your GBase agent. I remember what we talked about yesterday."
+```
+
+### HTTP Server Mode
+
+```bash
+# Start on default port 8420
+python3 main.py 8420
+
+# With a custom identity
+IDENTITY=my-agent python3 main.py 8420
+```
+
+### Arm Mode (Sub-Agents)
+
+```bash
+python3 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)
+```
+
+---
+
+## 🏗 Architecture at a Glance
+
+```
+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)
+```
+
+---
+
+## ❌ What GBase Is Not
+
+- ❌ **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_URL` and go.
+- ❌ **Not a black box.** Every component is a Python file you can read, fork, and override.
+
+## ✅ What GBase Is
+
+**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.
+
+---
+
+## 🔗 Supporting Projects
+
+<table>
+<tr>
+<td><strong>Glink</strong></td>
+<td>Agentic workflow orchestration — multi-step pipelines, parallel execution, inter-agent routing. The hands that GBase's brain directs.</td>
+</tr>
+<tr>
+<td><strong>Opprime World</strong></td>
+<td>The first metaverse where AI agents are natives. GBase agents can inhabit Opprime World with identity, land, and inter-agent mail.</td>
+</tr>
+</table>
+
+---
+
+## 📄 License
+
+MIT — free to use, modify, and distribute. No strings attached.
+
+---
+
+<p align="center">
+<a href="https://github.com/garyqlin">@garyqlin</a> · <a href="https://github.com/garyqlin/gbase">📦 GBase</a> · <a href="https://github.com/garyqlin/glink">⚡ Glink</a>
+</p>

gbase-0.2.1/editions/__init__.py

@@ -0,0 +1,148 @@
+"""
+Gbase edition definitions and module switches.
+
+Each edition is an EditionConfig object defining:
+- which modules are enabled
+- default port
+- default identity
+- resource requirements
+"""
+from dataclasses import dataclass, field
+
+
+@dataclass
+class EditionConfig:
+    """Gbase edition configuration"""
+
+    name: str  # edition name: hacker / prime / standard / lite
+    label: str  # label
+    port: int  # default port
+    identity: str  # default identity
+    modules: set[str] = field(default_factory=set)
+
+    @property
+    def enabled_modules(self) -> set[str]:
+        return self.modules
+
+
+# --- Module name constants ---
+
+MOD_SAFETY_GATEWAY = "safety_gateway"  # safety gateway (six-layer detection chain)
+MOD_SANDBOX = "sandbox_safety"  # sandbox simulation firewall
+MOD_MIRROR = "mirror"  # mirror engine
+MOD_EXPERIENCE = "experience"  # experience engine
+MOD_TOOLKIT = "toolkit"  # tool registration and routing
+MOD_LLM = "llm"  # LLM inference
+MOD_AGENT_BASIC = "agent_basic"  # basic agent scheduler
+MOD_DAG_ENGINE = "dag_engine"  # DAG agent engine
+MOD_COGNIFOLD = "cognifold"  # cognitive fold
+MOD_SEARCH_PREEXEC = "search_preexec"  # search pre-execution
+MOD_VILLAGE_OS = "village_os"  # Village OS world interconnect
+MOD_RSI = "rsi"  # RSI self-evolution
+MOD_IDENTITY_PLUG = "identity_plug"  # pluggable identity
+MOD_PROJECT_MEMORY = "project_memory"  # long project memory
+MOD_SCHEDULER = "scheduler"  # cron scheduler
+MOD_EVOLUTION = "evolution"  # evolution engine
+MOD_PORTAL = "portal"  # Portal admin panel
+MOD_LIFELINE = "lifeline"  # self-rescue system
+MOD_KNOWLEDGE_PACK = "knowledge_pack"  # preloaded domain knowledge pack
+
+
+# --- Edition definitions ---
+
+# Core modules (all editions)
+CORE = {
+    MOD_SAFETY_GATEWAY,
+    MOD_SANDBOX,
+    MOD_MIRROR,
+    MOD_EXPERIENCE,
+    MOD_TOOLKIT,
+    MOD_LLM,
+    MOD_AGENT_BASIC,
+    MOD_SCHEDULER,
+    MOD_LIFELINE,
+}
+
+
+HACKER = EditionConfig(
+    name="hacker",
+    label="Hacker",
+    port=8420,
+    identity="standard",
+    modules=CORE
+    | {
+        MOD_DAG_ENGINE,
+        MOD_COGNIFOLD,
+        MOD_SEARCH_PREEXEC,
+        MOD_VILLAGE_OS,
+        MOD_RSI,
+        MOD_IDENTITY_PLUG,
+        MOD_PROJECT_MEMORY,
+        MOD_EVOLUTION,
+        MOD_PORTAL,
+    },
+)
+
+PRIME = EditionConfig(
+    name="prime",
+    label="Prime",
+    port=8425,
+    identity="prime",
+    modules=CORE
+    | {
+        MOD_DAG_ENGINE,
+        MOD_SEARCH_PREEXEC,
+        MOD_IDENTITY_PLUG,
+        MOD_PROJECT_MEMORY,
+        MOD_PORTAL,
+        MOD_KNOWLEDGE_PACK,
+    },
+)
+
+STANDARD = EditionConfig(
+    name="standard",
+    label="Standard",
+    port=8426,
+    identity="standard",
+    modules=CORE
+    | {
+        MOD_DAG_ENGINE,
+        MOD_SEARCH_PREEXEC,
+        MOD_IDENTITY_PLUG,
+        MOD_KNOWLEDGE_PACK,
+    },
+)
+
+LITE = EditionConfig(
+    name="lite",
+    label="Lite",
+    port=8427,
+    identity="lite",
+    modules=CORE
+    | {
+        MOD_KNOWLEDGE_PACK,
+    },
+)
+
+
+# --- Lookup table ---
+
+EDITIONS: dict[str, EditionConfig] = {
+    "hacker": HACKER,
+    "prime": PRIME,
+    "standard": STANDARD,
+    "lite": LITE,
+}
+
+
+def get_edition(name: str) -> EditionConfig:
+    """Get edition config by name."""
+    cfg = EDITIONS.get(name)
+    if not cfg:
+        raise ValueError(f"Unknown edition: {name}, available: {list(EDITIONS.keys())}")
+    return cfg
+
+
+def list_editions() -> list:
+    """List all editions."""
+    return [(c.name, c.label, c.port) for c in EDITIONS.values()]