szczyglis-dev/py-gpt

这是什么？

核心功能

• 01以本地桌面应用形式运行于 Linux、Windows 和 macOS，提供类似 ChatGPT 的对话界面。
• 02可连接 OpenAI、Gemini、Claude、Grok、Perplexity/Sonar、DeepSeek，以及 Ollama 和 OpenAI 兼容接口。
• 03Agents 模式提供 Chat、Orchestrator、Swarm 三种多智能体工作流，可配置 worker 与迭代次数上限。
• 04基于 LlamaIndex 的 RAG 可索引 txt、pdf、csv、html、md、docx、json、epub、xlsx、xml 等文件与网页。
• 05插件系统与 MCP 连接器提供文件系统、Python/OS、网页搜索、Google、GitHub、Slack、Telegram 等工具。
• 06Realtime 语音模式支持 OpenAI Realtime、Gemini Live 和 Grok，并可通过 VAD 自动管理对话轮次。
• 07图像与视频生成支持 gpt-image、Imagen、Gemini、Nano Banana、Veo、Sora 等模型。
• 08Computer use 可通过鼠标和键盘操作控制桌面，或在 Playwright 浏览器沙箱中执行任务。

适用场景

• 在一个桌面客户端里用自有 API 密钥与多家云端或本地模型对话。
• 把多步骤的编码或调研任务交给 Orchestrator 或 Swarm 多智能体工作流。
• 通过本地 RAG 索引检索内部文档和 PDF，而不必把全文粘贴进提示词。
• 借助内置工具直接在对话中执行 Python、IPython 和系统命令。
• 在同一应用中使用语音对话、摄像头输入以及图像和视频生成。

快速上手

1. 1

   从 PyPI 安装 PyGPT

   pip install pygpt-net
2. 2

   启动 PyGPT

   pygpt
3. 3

   在 Config -> Settings -> API Keys 中添加 API 密钥（本地模型无需）

使用前须知

• !云端模型需要您自己的服务商 API 密钥。
• !Linux 预编译版需要 GLIBC 2.35 或更新版本。
• !许可证显示为 NOASSERTION，复用前请先查看仓库中的许可证。

收录于专题

标签

常见问题

py-gpt 是什么？

PyGPT 是一款跨平台桌面 AI 助手，支持云端与本地模型，并集成 Agent、RAG、插件、MCP 与语音功能。 PyGPT 是用 Python 编写的开源桌面 AI 助手，可在 Linux、Windows 和 macOS 上运行，界面接近 ChatGPT。它既能连接 OpenAI、Google Gemini、Anthropic Claude、xAI Grok、Perplexity/Sonar、DeepSeek 等云端模型，也能通过 Ollama 或任意 OpenAI 兼容接口使用本地与自托管模型，API 密钥由用户自行配置。

py-gpt 可以免费使用吗？用的什么许可证？

py-gpt 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

py-gpt 还在维护吗？

半年内有更新。py-gpt 最近一次提交是在 2026年10月6日。

py-gpt 适合用来做什么？

在一个桌面客户端里用自有 API 密钥与多家云端或本地模型对话。 把多步骤的编码或调研任务交给 Orchestrator 或 Swarm 多智能体工作流。 通过本地 RAG 索引检索内部文档和 PDF，而不必把全文粘贴进提示词。 借助内置工具直接在对话中执行 Python、IPython 和系统命令。 在同一应用中使用语音对话、摄像头输入以及图像和视频生成。

py-gpt 怎么安装和运行？

从 PyPI 安装 PyGPT: pip install pygpt-net 启动 PyGPT: pygpt 在 Config -> Settings -> API Keys 中添加 API 密钥（本地模型无需）

在哪里获取 py-gpt？

源代码和安装说明在 GitHub 上：https://github.com/szczyglis-dev/py-gpt