ChatGPT Wrapper is an open-source unofficial Python API and CLI that lets you interact with ChatGPT.
🤖 Programmable ChatGPT. The ChatGPT Wrapper lets you use the powerful ChatGPT bot in your Python scripts or on the command line, making it easy to leverage its functionality into your projects.
💬 Runs in Shell. You can call and interact with ChatGPT in the terminal
- 21/02/2023: v0.3.17
- Added debug mode (visible browser window).
- @thehunmonkgroup fixed chat naming.
- @thehunmonkgroup added !delete command to remove/hide conversations
- @thehunmonkgroup added --model flag to select model ('default' or 'legacy-paid' or 'legacy-free')
- @thehunmonkgroup added !editor command to open the current prompt in an editor and send the edited prompt to ChatGPT
- @thehunmonkgroup added !history command to show the list of the last 20 conversations
- @NatLee added docker support
- 17/02/2023: v0.3.16
- Ability to open multiple sessions in parallel.
- Code now works with ChatGPT Plus subscription.
- 14/02/2023: v0.3.15 - Updated model to text-davinci-002-render-sha (turbo model)
- 14/02/2023: v0.3.11
- Fixed many bugs with installation. Code is refactored.
- Now able to use the python wrapper with a proxy.
- 18/01/2023: v0.3.8 - Commands now are run only using !. For instance to enable read mode (for copy-paste and long prompts) you need to write now
!readinstead ofread. This is to avoid conflicts with the chatgpt prompts. Fixed timeout issue. - 17/01/2023: v0.3.7 - Added timeout to
askmethod to prevent hanging. Fixed return to terminal breakdown. Streaming output now is activated by default.
Run an interactive CLI in the terminal:
Or just get a quick response for one question:
See below for details on using ChatGPT as an API from Python.
To use this repository, you need setuptools installed. You can install it using pip install setuptools. Make sure that you have the last version of pip: pip install --upgrade pip
To use the !write command, you need to install vipe. In ubuntu, you can install it with sudo apt install moreutils, in macos with brew install moreutils.
- Install the latest version of this software directly from github with pip:
pip install git+https://github.com/mmabrouk/chatgpt-wrapper- Install a browser in playwright (if you haven't already). The program will use firefox by default.
playwright install firefox
- Start up the program in
installmode. This opens up a browser window. Log in to ChatGPT in the browser window, then stop the program.
chatgpt install- Restart the program without the
installparameter to begin using it.
- Youtube Tutorial: How To Use ChatGPT With Unity: Python And API Setup #2 includes a step by step guide to installing this repository on a windows machine
- This Blog post provides a visual step-by-step guide for installing this library.
In addition to directly prompting ChatGPT, The shell provides the following commands:
!helpdisplay help commands, or!help <command>to display help for a specific command!exitor!quitto exit the shell!askto ask a question (default)!newallows to start a new conversation!navlets you navigate to a past point in the conversation. Example:!nav 2!streamtoggles between streaming mode (streams the raw response from ChatGPT) and markdown rendering (which cannot stream).!readbegins reading multi-line input. Usefull when copy-pasting!filesends a prompt read from the named file. Example:file myprompt.txt!logenables logging to a file. Example:!log mylog.txtto enable, or!logto disable.!contextlets you load old contexts from the log (previous sessions). It takes one parameter; a context string from logs.!sessionrefreshes your session information. This can resolve errors under certain scenarios.!deletedeletes conversation from the webview, by conversation ID, history ID, or current conversation if no argument provided.!editoropens the current prompt in the default editor (as defined by the EDITOR environment variable) and allows you to edit it. The edited prompt is then sent to ChatGPT.!historycommand shows the list of last 20 conversations.!chatcommand select the chat by uuid, exmaple: !chat your-uuid-in-address-bar-after-chat-/-.
Command arguments can be passed in the following ways:
- --debug: enables debug mode (visible browser window)
- --model: selects model ('default' or 'legacy-paid' or 'legacy-free')
- --browser: selects browser ('firefox' or 'chromium' or 'webkit')
- --log: log prompts and responses to the named file
- --debug-log: debug logging to the named file
- --no-stream: disables streaming mode (and enables markdown rendering)
To use the ChatGPT class as an API for talking to ChatGPT, create an instance of the class and use the ask method to send a message to OpenAI and receive the response. For example:
from chatgpt_wrapper import ChatGPT
bot = ChatGPT()
response = bot.ask("Hello, world!")
print(response) # prints the response from chatGPTThe say method takes a string argument representing the message to send to ChatGPT, and returns a string representing the response received from ChatGPT.
You may also stream the response as it comes in from ChatGPT in chunks using the ask_stream generator.
Build a image for testing chatgpt-wrapper with following commands.
docker-compose build && docker-compose up -d
docker exec -it chatgpt-wrapper-container /bin/bash -c "chatgpt install"Then, visit http://localhost:6901/vnc.html with password headless and login ChatGPT.
Then, turn back to terminal and enjoy the chat!
We welcome contributions to ChatGPT Wrapper! If you have an idea for a new feature or have found a bug, please open an issue on the GitHub repository.
This project is licensed under the MIT License - see the LICENSE file for details.
- This project is a modification from Taranjeet code which is a modification of Daniel Gross code.
