GenericAgent
Applicationlsdefine/GenericAgent
A self-evolving autonomous agent that grows a skill tree from minimal seed code.
Overview
GenericAgent is a minimal autonomous agent framework that self-evolves by crystallizing task execution paths into reusable skills. It uses ~3.3K lines of seed code and 9 atomic tools to achieve full system control with high token efficiency.
README Preview
\n\n\n\n\n\n\n\n English | 中文 | 📄 Technical Report: | 📘 教程 | Sophub\n\n\n> 📌 **Official channel**: This GitHub repository is the sole official source for GenericAgent. We have no affiliation with any third-party website using the GenericAgent name.\n\n---\n\n## 🌟 Overview\n\n**GenericAgent** is a minimal, self-evolving autonomous agent framework. Its core is just **~3K lines of code**. Through **9 atomic tools + a ~100-line Agent Loop**, it grants any LLM system-level control over a local computer — covering browser, terminal, filesystem, keyboard/mouse input, screen vision, and mobile devices (ADB).\n\nIts design philosophy: **don't preload skills — evolve them.**\n\nEvery time GenericAgent solves a new task, it automatically crystallizes the execution path into an skill for direct reuse later. The longer you use it, the more skills accumulate — forming a skill tree that belongs entirely to you, grown from 3K lines of seed code.\n\n> **🤖 Self-Bootstrap Proof** — Everything in this repository, from installing Git and running `git init` to every commit message, was completed autonomously by GenericAgent. The author never opened a terminal once.\n\n## 📋 Core Features\n- **Self-Evolving**: Automatically crystallizes each task into an skill. Capabilities grow with every use, forming your personal skill tree.\n- **Minimal Architecture**: ~3K lines of core code. Agent Loop is ~100 lines. No complex dependencies, zero deployment overhead.\n- **Strong Execution**: Injects into a real browser (preserving login sessions). 9 atomic tools take direct control of the system.\n- **High Compatibility**: Supports Claude / Gemini / Kimi / MiniMax and other major models. Cross-platform.\n- **Token Efficient**: [Autonomous Exploration] (install deps, write scripts, debug & verify) -->\n[Crystallize Execution Path into skill] --> [Write to Memory Layer] --> [Direct Recall on Next Similar Task]\n```\n\n| What you say | What the agent does the first time | Every
FAQ (1)
TroubleshootingWhy does 'ga update' fail with 'externally-managed-environment' error on macOS using Homebrew Python?
The error occurs because the 'ga' launcher script uses the system Python (Homebrew-managed on macOS) which enforces PEP 668, blocking direct pip installations. Fix: edit the 'ga' script to prefer the project's virtual environment. Replace the line exec python -m ga_cli "$@" with:
if [ -x .venv/bin/python ]; then
exec .venv/bin/python -m ga_cli "$@"
else
exec python -m ga_cli "$@"
fi
This ensures the project's .venv Python is used when available. If you cannot modify the script, manually update within the venv: cd /path/to/GenericAgent && git pull && .venv/bin/pip install -e ..