项目简介
GenericAgent 是一个极简自主智能体框架，通过将任务执行路径转化为可复用的技能实现自我进化，仅用约 3300 行种子代码和 9 个原子工具实现高效系统控制。
README 预览
\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
常见问题 (1)
故障排除为什么在 macOS 上使用 Homebrew Python 时，'ga update' 会失败并提示 'externally-managed-environment' 错误？
故障排除
为什么在 macOS 上使用 Homebrew Python 时，'ga update' 会失败并提示 'externally-managed-environment' 错误？该错误是由于'ga'启动脚本使用了系统Python（macOS上由Homebrew管理），而该系统Python强制执行PEP 668，阻止直接通过pip安装。解决方法：编辑'ga'脚本，使其优先使用项目的虚拟环境。将行 exec python -m ga_cli "$@" 替换为：
if [ -x .venv/bin/python ]; then
exec .venv/bin/python -m ga_cli "$@"
else
exec python -m ga_cli "$@"
fi这样可在项目的 .venv 中的 Python 可用时优先使用。如果无法修改脚本，请在虚拟环境中手动更新：cd /path/to/GenericAgent && git pull && .venv/bin/pip install -e .。