Skip to content
Quick start · Python 3.11 / 3.12

Up and running
in a minute.

Clone the source or use the one-line installer, add your LLM API key, and hand it the first task. GA grows its own environment through the agent — don't pre-install everything.

Install

Two ways in.

Dependencies are deliberately tiered: the core needs only requests plus four lightweight packages for the browser bridge; the [ui] extra adds the bundled frontends. No Playwright, no LangChain, no browser binaries.

Clone & install (recommended)
git clone https://github.com/lsdefine/GenericAgent.git && cd GenericAgent
uv venv && uv pip install -e ".[ui]"
cp mykey_template_en.py mykey.py   # add your LLM API key
python frontends/tui_v3.py          # terminal UI
One-line installer · Windows PowerShell
powershell -ExecutionPolicy Bypass -c "$env:GLOBAL=1; irm https://raw.githubusercontent.com/lsdefine/GenericAgent/main/assets/ga_install.ps1 | iex"
One-line installer · Linux / macOS
GLOBAL=1 bash -c "$(curl -fsSL https://raw.githubusercontent.com/lsdefine/GenericAgent/main/assets/ga_install.sh)"
Use Python 3.11 or 3.12. Python 3.14 is not compatible with pywebview and a few other dependencies.
Unlock capabilities

Advanced capabilities are unlocked by instructing the agent — not by reading docs.

Each instruction makes GA read its pre-installed playbooks, install what is missing, adapt to your OS and persist the result into memory.

01
Web automation

“Set up your web automation capability.” — GA guides you through the one manual step: dragging the bundled Chrome extension into chrome://extensions.

02
OCR

“Set up your OCR capability with rapidocr and save it to memory.”

03
Vision

“Set up your vision capability from the template in memory/.” — GA wires it to your existing keys and self-tests.

04
Computer use

“Probe this system and set up your computer-use capability.”

Frontends
01
Terminal UI (recommended)

python frontends/tui_v3.py

02
Streamlit web UI

python launch.pyw

03
Telegram / Discord / Lark

python frontends/tgapp.py · dcapp.py · fsapp.py

04
Android

Install the APK from app.gaagent.ai

Then give it a task it has never seen.

Watch it explore, succeed, and write down how — so it never has to figure it out again.