diff --git a/README.md b/README.md index 12f89b25..ff060c6c 100644 --- a/README.md +++ b/README.md @@ -47,6 +47,7 @@ Every time GenericAgent solves a new task, it automatically crystallizes the exe - [Demo Showcase](#-demo-showcase) - [Quick Start](#-quick-start) - [Usage](#-usage) +- [Unlocking Advanced Capabilities](#-unlocking-advanced-capabilities) - [Architecture](#-architecture) - [Self-Evolution Mechanism](#-self-evolution-mechanism) - [Comparison](#-comparison) @@ -73,8 +74,20 @@ Every time GenericAgent solves a new task, it automatically crystallizes the exe - - + + + + + + + + + + + + + + @@ -85,25 +98,16 @@ Every time GenericAgent solves a new task, it automatically crystallizes the exe - + - + - - - - - - - - - - +
🧋 Food Delivery Order📈 Quantitative Stock Screening🛡️ Real-Browser CAPTCHA Survival🌐 Autonomous Web Exploration
Discord hCaptcha passed in real browserWeb Exploration
While configuring a Discord bot, an hCaptcha "Are you human?" challenge pops up mid-task — GA's real browser session passes it and the task continues. See Browser Realness.Autonomously browses and periodically summarizes web content.
🧋 Food Delivery Order📈 Quantitative Stock Screening
Order Tea"Find GEM stocks with EXPMA golden cross, turnover > 5%" — quantitative screening.
🌐 Autonomous Web Exploration 💰 Expense Tracking💬 Batch Messaging
Web Exploration Alipay ExpenseWeChat Batch
Autonomously browses and periodically summarizes web content. "Find expenses over ¥2K in the last 3 months" — drives Alipay via ADB.
💬 Batch Messaging
WeChat Batch
Sends bulk WeChat messages, fully driving the WeChat client.Sends bulk WeChat messages, fully driving the WeChat client.
@@ -141,26 +145,21 @@ powershell -ExecutionPolicy Bypass -c "$env:GLOBAL=1; irm http://fudankw.cn:9000 GLOBAL=1 bash -c "$(curl -fsSL http://fudankw.cn:9000/files/ga_install.sh)" ``` -After installation, launch the desktop app from: +After installation, launch the desktop app: -```text -frontends/GenericAgent.exe -``` +- **Windows** — double-click `frontends/GenericAgent.exe` +- **Linux / macOS** — run `python launch.pyw` from the install directory #### Method 2 — Python install *(for developers)* ```bash -git clone https://github.com/lsdefine/GenericAgent.git -cd GenericAgent -uv venv -uv pip install -e ".[ui]" # Core + UI dependencies -cp mykey_template.py mykey.py # Fill in your LLM API key +git clone https://github.com/lsdefine/GenericAgent.git && cd GenericAgent +uv venv && uv pip install -e ".[ui]" +cp mykey_template_en.py mykey.py # fill in your LLM API key python launch.pyw ``` -> 💡 GenericAgent is meant to grow its environment **through the Agent itself**, not by pre-installing every possible package. - -📖 Full guide: [`docs/GETTING_STARTED.md`](docs/GETTING_STARTED.md) +> 💡 GenericAgent grows its environment **through the Agent itself** — don't pre-install everything. See [Unlocking Advanced Capabilities](#-unlocking-advanced-capabilities) below. --- @@ -204,17 +203,15 @@ python launch.pyw ### Bot Interface (IM) -GenericAgent also supports IM frontends such as Telegram, WeChat, QQ, Feishu / Lark, WeCom, and DingTalk. +GenericAgent also supports IM frontends such as Telegram, Discord, and Lark. | Platform | Command | | :--- | :--- | | Telegram | `python frontends/tgapp.py` | -| WeChat | `python frontends/wechatapp.py` | -| QQ | `python frontends/qqapp.py` | -| Feishu / Lark | `python frontends/fsapp.py` | -| WeCom | `python frontends/wecomapp.py` | -| DingTalk | `python frontends/dingtalkapp.py` | +| Discord | `python frontends/dcapp.py` | +| Lark / Feishu | `python frontends/fsapp.py` | +> WeChat, QQ, WeCom and DingTalk are also supported — see the Chinese section below. > For detailed setup, ask GenericAgent itself. ### Common Chat Commands @@ -227,6 +224,31 @@ GenericAgent also supports IM frontends such as Telegram, WeChat, QQ, Feishu / L --- +## 🔓 Unlocking Advanced Capabilities + +In GA, advanced capabilities are unlocked by **instructing the agent**, not by reading +docs or installing extras. Each instruction below makes GA read its pre-installed SOPs +(battle-tested playbooks in its memory), install whatever is missing, adapt to your OS, +and persist the result into its own memory. + +| Capability | Just tell GA | +| :--- | :--- | +| 🌐 Web automation | *"Set up your web automation capability."* — GA guides you through the one manual step: dragging the bundled Chrome extension into `chrome://extensions`. | +| 🔤 OCR | *"Set up your OCR capability with rapidocr and save it to memory."* | +| 👁️ Vision | *"Set up your vision capability from the template in memory/."* — GA copies the template, wires it to your existing LLM keys, and self-tests. | +| 🖱️ Computer use | *"Probe this system and set up your computer-use capability."* | + +> 💡 **About language**: the pre-installed SOPs are written in Chinese — GA reads them +> natively, so this never blocks you. If you prefer an English knowledge base, just say: +> *"Read your pre-installed SOPs and rewrite them in English (keep code, paths and error +> strings verbatim)."* +> +> 🌍 **About platforms**: the SOPs were honed on Windows, but cross-platform adaptation is +> itself a GA task — on macOS/Linux, GA swaps in the platform equivalents (window +> enumeration, input control, screenshots) on its own. Same self-evolution principle. + +--- + ## 🧠 Architecture GenericAgent accomplishes complex tasks through **Layered Memory × Minimal Toolset × Autonomous Execution Loop**, continuously accumulating experience during execution. @@ -298,6 +320,7 @@ This is what fundamentally distinguishes GenericAgent from every other agent fra | What you say | First time | Every time after | | :--- | :--- | :--- | | *"Read my WeChat messages"* | Install deps → reverse DB → write read script → save Skill | **one-line invoke** | +| *"Give me a morning digest of Hacker News"* | Write scraper → build digest → schedule daily run → save Skill | **one-line invoke** | | *"Monitor stocks and alert me"* | Install `mootdx` → build selection flow → configure cron → save Skill | **one-line start** | | *"Send this file via Gmail"* | Configure OAuth → write send script → save Skill | **ready to use** | @@ -376,9 +399,9 @@ For reCAPTCHA v3, `0.9` is not a "checkbox solved" result; it is the high-confid - **2026-04-21** — 📄 [**Technical Report on arXiv**](https://arxiv.org/abs/2604.17091) — *GenericAgent: A Token-Efficient Self-Evolving LLM Agent via Contextual Information Density Maximization*. - **2026-04-11** — Introduced **L4 session archive memory** and scheduler cron integration. - **2026-03-23** — Personal WeChat supported as a bot frontend. -- **2026-03-10** — [Released million-scale Skill Library](https://mp.weixin.qq.com/s/q2gQ7YvWoiAcwxzaiwpuiQ?scene=1&click_id=7). -- **2026-03-08** — [Released "Dintal Claw" — a GenericAgent-powered government-affairs bot](https://mp.weixin.qq.com/s/eiEhwo-j6S-WpLxgBnNxBg). -- **2026-03-01** — [Featured by Jiqizhixin (机器之心)](https://mp.weixin.qq.com/s/uVWpTTF5I1yzAENV_qm7yg). +- **2026-03-10** — [Released million-scale Skill Library](https://mp.weixin.qq.com/s/q2gQ7YvWoiAcwxzaiwpuiQ?scene=1&click_id=7) *(Chinese)*. +- **2026-03-08** — [Released "Dintal Claw" — a GenericAgent-powered government-affairs bot](https://mp.weixin.qq.com/s/eiEhwo-j6S-WpLxgBnNxBg) *(Chinese)*. +- **2026-03-01** — [Featured by Jiqizhixin (机器之心)](https://mp.weixin.qq.com/s/uVWpTTF5I1yzAENV_qm7yg) *(Chinese)*. - **2026-01-16** — GenericAgent **V1.0** public release. --- @@ -522,11 +545,10 @@ powershell -ExecutionPolicy Bypass -c "irm http://fudankw.cn:9000/files/ga_insta curl -fsSL http://fudankw.cn:9000/files/ga_install.sh | bash ``` -安装完成后，双击启动： +安装完成后启动： -```text -frontends/GenericAgent.exe -``` +- **Windows** — 双击 `frontends/GenericAgent.exe` +- **Linux / macOS** — 在安装目录运行 `python launch.pyw` #### 方法二 — Python 安装 *（开发者）* @@ -553,7 +575,7 @@ python launch.pyw #### 桌面端 -一键安装自带桌面端，双击： +一键安装自带桌面端（Windows），双击： ```text frontends/GenericAgent.exe @@ -585,11 +607,12 @@ python launch.pyw ### Bot 接口（IM） -GenericAgent 支持 Telegram、微信、QQ、飞书 / Lark、企业微信、钉钉等 IM 前端。 +GenericAgent 支持 Telegram、Discord、微信、QQ、飞书 / Lark、企业微信、钉钉等 IM 前端。 | 平台 | 启动命令 | | :--- | :--- | | Telegram | `python frontends/tgapp.py` | +| Discord | `python frontends/dcapp.py` | | 微信 | `python frontends/wechatapp.py` | | QQ | `python frontends/qqapp.py` | | 飞书 / Lark | `python frontends/fsapp.py` | diff --git a/assets/demo/discord_hcaptcha_real_browser.gif b/assets/demo/discord_hcaptcha_real_browser.gif new file mode 100644 index 00000000..5630e8cd Binary files /dev/null and b/assets/demo/discord_hcaptcha_real_browser.gif differ