py-gpt

环境要求

• Python >=3.10 且 <3.14
• git（用于克隆仓库）
• 能联网的 pip 环境
• 可选：Poetry（使用 Poetry 方式安装时）

安装与启动步骤

1. 1克隆源码仓库

   从 GitHub 拉取 py-gpt 源码，也可直接下载 .zip 后解压，然后进入项目目录。

   git clone https://github.com/szczyglis-dev/py-gpt.git
   cd py-gpt

   复制

2. 2创建虚拟环境

   在项目目录中创建 venv 并激活，避免污染系统 Python 环境。Windows 下激活命令不同。

   python3 -m venv venv
   source venv/bin/activate

   复制

3. 3安装依赖

   用 requirements.txt 安装全部运行依赖，耗时较长请保持网络畅通。

   pip install -r requirements.txt

   复制

4. 4启动应用

   运行 run.py 启动 PyGPT 桌面窗口，首次启动会自动生成配置文件。

   python3 run.py

   复制

5. 5（可选）Poetry 装依赖

   不想用 venv 可改用 Poetry：先装 Poetry，指定 Python 3.10 环境后 install。

   pip install poetry
   poetry env use python3.10
   poetry shell
   poetry install

   复制

6. 6（可选）Poetry 启动

   用 Poetry 环境运行应用，效果与 venv 方式启动的桌面程序一致。

   poetry run python3 run.py

   复制

关键配置

如何确认成功

运行 python3 run.py 后出现 PyGPT 桌面窗口，且 {HOME_DIR}/.config/pygpt-net/ 下生成 config.json 等文件即成功。

常见问题

注意事项

• Python 版本区间是 >=3.10、<3.14，装依赖前先确认版本。
• 项目自定义 workdir 不会替换 profile 工作目录，只覆盖该项目的 data 目录；tmp、配置、数据库、缓存、CSS、locale、字体和日志仍在基础 profile 目录。
• 完整的手动配置参考见官方文档 https://pygpt.readthedocs.io/en/latest/configuration.html#manual-configuration 。
• README 提到可用 PyInstaller 6.4.0 自行打包，但未给出具体命令，需要时请自行查阅官方文档。