GenericAgent

环境要求

• Python 3.11 或 3.12（不要用 Python 3.14，与 pywebview 等依赖不兼容）
• 已安装 uv（用于创建虚拟环境与安装依赖）
• 已安装 Git
• 准备一个可用的 LLM API Key
• 核心依赖仅 requests 等轻量包，无需 Playwright / LangChain / 浏览器二进制

安装与启动步骤

1. 1克隆仓库

   把 GenericAgent 源码克隆到本地并进入项目目录，需保证网络可访问 GitHub。

   git clone https://github.com/lsdefine/GenericAgent.git
   cd GenericAgent

   复制

2. 2创建环境装依赖

   用 uv 建虚拟环境并安装核心加 UI 依赖（[ui] 额外装 Streamlit、prompt_toolkit、rich 等前端库）。

   uv venv && uv pip install -e ".[ui]"

   复制

3. 3配置 API Key

   复制密钥模板为 mykey.py，然后填入你自己的 LLM API Key。

   cp mykey_template.py mykey.py

   复制

4. 4启动终端界面

   推荐方式，运行终端 UI（TUI）与 Agent 交互。

   python frontends/tui_v3.py

   复制

5. 5启动 Web 界面

   如偏好图形界面，可改用 Streamlit Web UI 启动。

   python launch.pyw

   复制

6. 6可选一键安装

   想省去手动配置，可用官方脚本自动准备隔离 Python 环境与项目文件。

   curl -fsSL http://fudankw.cn:9000/files/ga_install.sh | bash

   复制

7. 7Windows 一键安装

   Windows 用户用 PowerShell 执行一行安装脚本，完成后双击 exe 启动。

   powershell -ExecutionPolicy Bypass -c "irm http://fudankw.cn:9000/files/ga_install.ps1 | iex"

   复制

关键配置

如何确认成功

终端 UI 正常出现交互提示，或浏览器打开 Streamlit 页面并能正常对话，即启动成功。

常见问题

注意事项

• 官方渠道只有 GitHub 仓库和 gaagent.ai，其他渠道并非官方，请注意甄别。
• GenericAgent 推荐由 Agent 在使用中自举环境，不要预先手动装一大堆依赖。
• 更详细的安装步骤见 docs/installation_zh.md 与 docs/GETTING_STARTED.md。