Skip to main content

ChatGPT HTTP API Client and CLI

Project description


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


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.


pip install chatgpt-api


As a Command Line Interface


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!")

Without context manager you have to explicitly authenticate:

from chatgpt.api import ChatGPT

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

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.


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


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

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chatgpt-api-0.2.1.tar.gz (6.6 kB view hashes)

Uploaded source

Built Distribution

chatgpt_api-0.2.1-py3-none-any.whl (8.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page