
# GenericAgent
**A Minimal, Self-Evolving Autonomous Agent Framework**
*~3K lines of seed code · 9 atomic tools · ~100-line Agent Loop*
**[English](#-english) · [中文](#-中文)**
> 📌 **Official Channel** — This GitHub repository is the **only** official source of GenericAgent.
> We have no affiliation with any third-party website using the GenericAgent name.
---
| 🧋 Food Delivery Order |
📈 Quantitative Stock Screening |
 |
 |
| "Order me a milk tea" — navigates the delivery app, selects items, completes checkout. |
"Find GEM stocks with EXPMA golden cross, turnover > 5%" — quantitative screening. |
| 🌐 Autonomous Web Exploration |
💰 Expense Tracking |
 |
 |
| Autonomously browses and periodically summarizes web content. |
"Find expenses over ¥2K in the last 3 months" — drives Alipay via ADB. |
| 💬 Batch Messaging |
 |
| Sends bulk WeChat messages, fully driving the WeChat client. |
---
## 🚀 Quick Start
> ⚠️ **Python version**: use **Python 3.11 or 3.12**. **Do not** use Python 3.14 — it is incompatible with `pywebview` and a few other GA dependencies.
>
> 📖 Detailed installation guide: **[installation.md](docs/installation.md)** · **[installation_zh.md(中文)](docs/installation_zh.md)**
### For LLM Agents
Fetch the installation guide and follow it:
```bash
curl -fsSL https://raw.githubusercontent.com/lsdefine/GenericAgent/refs/heads/main/docs/installation.md
```
### For Humans
#### Method 1 — One-line install *(recommended)*
This installs GenericAgent with an isolated Python environment and Git, then downloads a ready-to-run package.
**Windows PowerShell**
```powershell
powershell -ExecutionPolicy Bypass -c "$env:GLOBAL=1; irm http://fudankw.cn:9000/files/ga_install.ps1 | iex"
```
**Linux / macOS**
```bash
GLOBAL=1 bash -c "$(curl -fsSL http://fudankw.cn:9000/files/ga_install.sh)"
```
After installation, launch the desktop app from:
```text
frontends/GenericAgent.exe
```
#### 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
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)
---
## 💻 Usage
### Frontends
#### Desktop App
For one-line installs on Windows, double-click:
```text
frontends/GenericAgent.exe
```
#### Terminal UI
A lightweight, keyboard-driven interface built on [Textual](https://github.com/Textualize/textual). Supports multiple concurrent sessions and real-time streaming.
```bash
python frontends/tuiapp_v2.py
```