개요
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
FAQ (1)
문제 해결macOS에서 Homebrew Python을 사용할 때 'ga update' 명령이 'externally-managed-environment' 오류로 실패하는 이유는 무엇인가요?
문제 해결
macOS에서 Homebrew Python을 사용할 때 'ga update' 명령이 'externally-managed-environment' 오류로 실패하는 이유는 무엇인가요?오류는 'ga' 런처 스크립트가 시스템 Python(macOS에서 Homebrew로 관리됨)을 사용하기 때문에 발생하며, 이는 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 .