PyChatGPT

几行代码接入 ChatGPT,自动管对话,轻松过代理。

PyChatGPT 是一个轻量级的 Python 客户端,用于调用 ChatGPT 的 API。它解决了开发者直接使用 OpenAI 原始接口时面临的对话状态管理繁琐、代理配置复杂等问题。核心能力包括自动跟踪多轮对话上下文,内置代理支持以绕过网络限制,以及提供简洁的 API 封装,让开发者可以用几行代码快速集成 ChatGPT 到自己的应用中。项目基于 Python,适合快速原型开发和小型生产环境,目前处于成长阶段,社区活跃度中等。

开源 free 对话助手
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 4184
维护状态 维护中
是否开源
定价模式 free

项目数据

分类对话助手
开发团队rawandahmad698
所属国家
官网地址
定价模式free
价格说明开源项目,MIT许可证,完全免费,无付费版本。
访问状态
是否开源
开源协议MIT
主要语言Python
技术栈/模型chatgpt,openai,python
GitHub 星标★ 4184
30天Star增速
HF 下载量
上线时间2022-12-05 00:00:00
最近更新2026-09-19 00:00:00
维护状态维护中
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数2

使用教程

难度:入门 约 10 分钟 部署方式:库/依赖 5 步

环境要求

  • 已安装 Python 及 pip(README 未注明具体版本要求)
  • 能访问 OpenAI 服务的网络环境,必要时可配置代理
  • 一个可用的 ChatGPT/OpenAI 账号(README 提到自动登录并获取 Access Token)

安装与启动步骤

  1. 1安装 PyChatGPT

    README 给出的安装命令,包名是 chatgptpy 而不是 pycheatgpt,注意不要装错。

    pip install chatgptpy --upgrade
  2. 2导入并创建 Options

    README 的 Usage 只给出这一段代码:从 pychatgpt 导入 Chat 和 Options,并实例化 Options 以自定义会话。

    from pychatgpt import Chat, Options
    
    options = Options()
  3. 3把 Options 传给构造器

    README 说明:把 options() 对象传给 ChatGPT() 构造器即可自定义本次会话;README 未给出完整调用示例,具体参数以库内实现为准。

  4. 4首次运行完成登录

    程序会自动登录并抓取 Access Token,并把 token 保存到文件;若被要求验证码,需要手动完成验证。

  5. 5开始对话并保存会话

    默认会跟踪多轮上下文,并支持把对话保存到文件、下次启动恢复;升级库执行同一条 pip 命令。

    pip install chatgptpy --upgrade

关键配置

配置项必填说明示例
Options()传给 ChatGPT() 构造器用于自定义会话的对象,README 未列出具体字段名options = Options()

如何确认成功

在 Python 中执行 from pychatgpt import Chat, Options 不报错;进入对话后能看到类似 README 中 “You: … / Chat GPT: …” 的连续回复。

常见问题

Q:为什么安装命令里的包名和项目名不一样?

A:README 中安装命令为 pip install chatgptpy --upgrade,导入名则是 pychatgpt;两者不一致,请按 README 原文执行,不要凭项目名猜包名。

Q:登录时提示要输入验证码怎么办?

A:README 说明如果反复登录会触发 captcha,需要手动完成验证;正常首次自动登录一般不需要。

Q:每次启动都要重新登录吗?

A:不需要。README 说明 Access Token 会保存到文件,过期时会自动刷新,因此不必重复登录。

Q:网络访问受限能用吗?

A:README 把 Proxy Support 列为特性之一,说明支持代理;但 README 未给出代理配置的具体参数写法,需自行查看库内 Options 实现。

Q:对话关闭程序后会丢失吗?

A:不会。README 列出的特性包括把对话保存到文件、关闭程序后仍可恢复会话。

注意事项

  • README 的 Usage 节选只展示了导入和 Options 实例化,未给出完整可运行示例,构造器调参请以库内实际实现为准。
  • 安装/升级命令统一为 pip install chatgptpy --upgrade,项目名 PyChatGPT 不是包名。
  • README 提到会用 colorama 给输出上色,这是正常现象。
  • README 未提供端口、路径、环境变量等配置项,本文档未做任何补全。

核心亮点

  • 自动维护对话历史,无需手动拼接上下文,省心省力。
  • 内置代理支持,方便网络受限地区开发者使用。
  • API 封装简洁,上手快,适合快速集成到 Python 项目。

不足之处

  • 文档和示例相对简略,高级用法需要阅读源码。
  • 项目活跃度一般,更新频率可能跟不上 OpenAI API 变化。

适用场景

  • 快速构建基于 ChatGPT 的聊天机器人原型。
  • 在需要代理访问 OpenAI 服务的环境中使用。
  • 在 Python 后端服务中集成对话式 AI 功能。

替代项目

openai-python、LangChain、revChatGPT

项目介绍

PyChatGPT 是开发框架领域的开源项目,由 rawandahmad698 开发,2022 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(4,184)位列前 10%,在开发框架分类的 795 个项目里位列前 13%。

项目仍在小幅维护中,最近一次代码更新于 2026-09-19。MIT许可证,完全免费,无付费版本。

它主要面向的使用场景是:快速构建基于ChatGPT的聊天机器人原型。同类可对比的替代方案包括 openai-python、LangChain、revChatGPT。

上一篇:onellm

下一篇:LangGPT

同类项目推荐

langchain 开源

组装 AI 应用的乐高积木,从想法到上线不换工具

The agent engineering platform.

★ 146874 2026-08-09
transformers 开源

全球最大的模型仓库全家桶,想用的模型一把抓

Transformers: the model-definition framework for state-of-the-art machine learning m···

★ 166529 2026-08-09
pi 开源

一套 TypeScript 工具包,快速搭出能写代码的 AI agent

AI agent toolkit: unified LLM API, agent loop, TUI, coding agent CLI

★ 108504 2026-09-12