lsdefine/GenericAgent

<div align="center">

<img src="assets/images/bar.jpg" width="880" alt="GenericAgent 배너"/>

GenericAgent

최소한의 자기 진화형 자율 에이전트 프레임워크

~3K 라인의 시드 코드 · 9개의 원자적 도구 · ~100줄의 에이전트 루프

<p>

<a href="https://gaagent.ai"><img src="https://img.shields.io/badge/OfficialWebsite-gaagent.ai-00A67E?style=flat-square" alt="공식 웹사이트"/></a> <a href="https://arxiv.org/abs/2604.17091"><img src="https://img.shields.io/badge/TechnicalReport-PDF-EA4335?style=flat-square&logo=adobeacrobatreader&logoColor=white" alt="기술 보고서"/></a> <a href="https://github.com/JinyiHan99/GA-Technical-Report"><img src="https://img.shields.io/badge/Code%26Data-Reproduction-181717?style=flat-square&logo=github" alt="재현 저장소"/></a> <a href="https://datawhalechina.github.io/hello-generic-agent/"><img src="https://img.shields.io/badge/Tutorial-Datawhale-blue?style=flat-square" alt="튜토리얼"/></a> <a href="https://fudankw.cn/sophub"><img src="https://img.shields.io/badge/Skill_Hub-Sophub-purple?style=flat-square" alt="Sophub"/></a> </p>

<p> <a href="https://trendshift.io/repositories/25944" target="_blank"><img src="https://trendshift.io/api/badge/repositories/25944" alt="Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a> </p>

English · 中文

</div>

📌 공식: GitHub + https://gaagent.ai 만 공식입니다. DintalClaw는 유일한 공인 상업 파트너이며, 다른 곳은 관련이 없습니다.

<a id="-english"></a>

🌟 개요

GenericAgent는 최소한의 자기 진화형 자율 에이전트 프레임워크입니다. 핵심은 약 3K 라인의 코드에 불과합니다. 9개의 원자적 도구 + 약 100줄의 에이전트 루프를 통해 모든 LLM에 로컬 컴퓨터에 대한 시스템 수준 제어권을 부여합니다. 브라우저, 터미널, 파일 시스템, 키보드/마우스 입력, 화면 비전, 모바일 기기(ADB)를 포함합니다.

디자인 철학 — 스킬을 미리 로드하지 말고, 진화시키세요.

GenericAgent가 새로운 작업을 해결할 때마다 실행 경로를 재사용 가능한 스킬로 자동 결정화합니다. 오래 사용할수록 더 많은 스킬이 축적되어 3K 라인의 시드 코드에서 완전히 성장한 개인 스킬 트리를 형성합니다.

🤖 자체 부트스트랩 증명 — 이 저장소의 모든 것, Git 설치 및 git init 실행부터 모든 커밋 메시지까지 GenericAgent가 자율적으로 완료했습니다. 저자는 터미널을 한 번도 열지 않았습니다.

📑 목차

• 주요 기능
• 데모 쇼케이스
• 빠른 시작
• 사용법
• 고급 기능 잠금 해제
• 아키텍처
• 자기 진화 메커니즘
• 비교
• 평가
• 로드맵 및 뉴스
• 커뮤니티 및 지원
• 라이선스

📋 주요 기능

🎯 데모 쇼케이스

<table> <tr> <td align="center" width="50%"><b>🛡️ 실제 브라우저 CAPTCHA 생존</b></td> <td align="center" width="50%"><b>🌐 자율 웹 탐색</b></td> </tr> <tr> <td><img src="assets/demo/discordhcaptcharealbrowser.gif" width="100%" alt="실제 브라우저에서 Discord hCaptcha 통과"></td> <td><img src="assets/demo/autonomousexplore.png" width="100%" alt="웹 탐색"></td> </tr> <tr> <td>_{Discord 봇을 구성하는 중간에 hCaptcha "당신은 인간입니까?" 챌린지가 나타납니다 — GA의 실제 브라우저 세션이 이를 통과하고 작업이 계속됩니다. <a href="#browser-realness-of-ga-web-tools">브라우저 실제성</a> 참조.}</td> <td>_{자율적으로 웹을 탐색하고 주기적으로 콘텐츠를 요약합니다.}</td> </tr> <tr> <td align="center"><b>🧋 음식 배달 주문</b></td> <td align="center"><b>📈 퀀트 주식 스크리닝</b></td> </tr> <tr> <td><img src="assets/demo/ordertea.gif" width="100%" alt="차 주문"></td> <td><img src="assets/demo/selectstock.gif" width="100%" alt="주식 선택"></td> </tr> <tr> <td>_{"밀크티 주문해 줘" — 배달 앱을 탐색하고, 항목을 선택하고, 결제를 완료합니다.}</td> <td>_{"EXPMA 골든 크로스, 거래량 > 5%인 GEM 주식 찾아줘" — 퀀트 스크리닝.}</td> </tr> <tr> <td align="center"><b>💰 지출 추적</b></td> <td align="center"><b>💬 일괄 메시징</b></td> </tr> <tr> <td><img src="assets/demo/alipayexpense.png" width="100%" alt="Alipay 지출"></td> <td align="center"><img src="assets/demo/wechat_batch.png" width="65%" alt="WeChat 일괄"></td> </tr> <tr> <td>_{"지난 3개월 동안 2,000위안 이상 지출 찾아줘" — ADB를 통해 Alipay를 구동합니다.}</td> <td>_{WeChat 클라이언트를 완전히 구동하여 대량 WeChat 메시지를 보냅니다.}</td> </tr> </table>

🚀 빠른 시작

⚠️ Python 버전: Python 3.11 또는 3.12를 사용하세요. Python 3.14를 사용하지 마세요 — pywebview 및 몇몇 다른 GA 종속성과 호환되지 않습니다.

>

📖 자세한 설치 가이드: installation.md · installationzh.md（中文）

curl -fsSL https://raw.githubusercontent.com/lsdefine/GenericAgent/refs/heads/main/docs/installation.md

git clone https://github.com/lsdefine/GenericAgent.git && cd GenericAgent
uv venv && uv pip install -e ".[ui]"
cp mykey_template_en.py mykey.py   # LLM API 키 입력

python frontends/tui_v3.py   # 터미널 UI (권장)
python launch.pyw            # Streamlit 웹 UI

powershell -ExecutionPolicy Bypass -c "$env:GLOBAL=1; irm https://raw.githubusercontent.com/lsdefine/GenericAgent/main/assets/ga_install.ps1 | iex"

GLOBAL=1 bash -c "$(curl -fsSL https://raw.githubusercontent.com/lsdefine/GenericAgent/main/assets/ga_install.sh)"

python frontends/tui_v3.py

python launch.pyw