chatgpt-api

ChatGPT HTTP API Client and CLI


Keywords
ai, api, chatgpt, cli, client, http, python
License
MIT
Install
pip install chatgpt-api==0.2.1

Documentation

💻 ChatGPT API

Unofficial API client and CLI for ChatGPT.

PyPI License Coverage


Short Demo GIF


This project is based on httpx (uses only HTTP) and uses Typer (with Rich) for CLI, so responses are looking good (markdown is supported). Also, It has 100% code coverage unlike other ChatGPT packages.

Long Demo GIF

Status

ChatGPT API often changes. I'm trying to make updates as soon as possible. So, if something is not working properly and you recently didn't upgrade chatgpt-api, try to do this first:

pip install --upgrade chatgpt-api

If that doesn't help, please open an issue.

Installation

pip install chatgpt-api

Usage

As a Command Line Interface

Setup

Required to authenticate. In this step you have to provide session key.

chatgpt setup

Start chatting

chatgpt start

As an API

ChatGPT class inherits from httpx.Client

Recommended usage:

from chatgpt.api import ChatGPT

with ChatGPT(session_token="your-session-token") as chat:
    response = chat.send_message("Hello!")
    print(response.content)

Without context manager you have to explicitly authenticate:

from chatgpt.api import ChatGPT

chat = ChatGPT(session_token="your-session-token")
chat.authenticate()
response = chat.send_message("Hello!")
print(response.content)
chat.close()

How to acquire session key?

After you log in to ChatGPT in your browser, get value of __Secure-next-auth.session-token cookie. In this project, this is named as a "session key".

Chrome instruction

  1. Open ChromeDevTools (F12).
  2. Click on "Application" tab.
  3. Click on "Cookies", on the left bar.
  4. Copy the value of __Secure-next-auth.session-token:

Cookie value example

Now, you can use it in CLI or directly from Python code.

License

Distributed under the MIT License. See LICENSE for more information.

Disclaimer

This is a personal project, not affiliated in any way with OpenAI. If you have any objections, please contact me.