# ChatGPT <img src="https://github.com/acheong08/ChatGPT/blob/main/logo.png?raw=true" width="15%"></img>
English - [中文](./README_zh.md) - [Spanish](./README_sp.md) - [日本語](./README_ja.md) - [한국어](./README_ko.md)
[![PyPi](https://img.shields.io/pypi/v/revChatGPT.svg)](https://pypi.python.org/pypi/revChatGPT)
[![Support_Platform](https://img.shields.io/pypi/pyversions/revChatGPT)](https://pypi.python.org/pypi/revChatGPT)
[![Downloads](https://static.pepy.tech/badge/revchatgpt)](https://pypi.python.org/pypi/revChatGPT)
Reverse Engineered ChatGPT API by OpenAI. Extensible for chatbots etc.
[![](https://github.com/acheong08/ChatGPT/blob/main/docs/view.gif?raw=true)](https://pypi.python.org/pypi/revChatGPT)
# Installation
```
python -m pip install --upgrade revChatGPT
```
### Suport Python Version
- Minimum - Python3.9
- Recommend - Python3.11+
<details>
<summary>
# V1 Standard ChatGPT
V1 uses a cloudflare bypass proxy to make life convenient for everyone. The proxy is open source: https://github.com/acheong08/ChatGPT-Proxy-V4
To set your own deployed proxy, set the environment variable `CHATGPT_BASE_URL` to `https://yourproxy.com/api/`
</summary>
## Rate limits
- Proxy server: 5 requests / 10 seconds
- OpenAI: 50 requests / hour for each account
## Configuration
1. Create account on [OpenAI's ChatGPT](https://chat.openai.com/)
2. Save your email and password
### Authentication method: (Choose 1)
#### - Email/Password
> Not supported for Google/Microsoft accounts.
```json
{
"email": "email",
"password": "your password"
}
```
#### - Access token
https://chat.openai.com/api/auth/session
```json
{
"access_token": "<access_token>"
}
```
#### - Optional configuration:
```json
{
"conversation_id": "UUID...",
"parent_id": "UUID...",
"proxy": "...",
"model": "gpt-4", // gpt-4-browsing, text-davinci-002-render-sha, gpt-4, gpt-4-plugins
"plugin_ids": ["plugin-d1d6eb04-3375-40aa-940a-c2fc57ce0f51"], // Wolfram Alpha example
"disable_history": true,
"PUID": "<_puid cookie for plus accounts>", // Only if you have a plus account and use GPT-4
"unverified_plugin_domains":["showme.redstarplugin.com"] // Unverfied plugins to install
}
```
1. Save this as `$HOME/.config/revChatGPT/config.json`
2. If you are using Windows, you will need to create an environment variable named `HOME` and set it to your home profile for the script to be able to locate the config.json file.
Plugin IDs can be found [here](./plugins.json). Remember to set model to `gpt-4-plugins` if plugins are enabled. Plugins may or may not work if you haven't installed them from the web interface. You can call `chatbot.install_plugin(plugin_id=plugin_id)` to install any one of them from code. Call `chatbot.get_plugins()` to get a list of all plugins available.
## Usage
### Command line
`python3 -m revChatGPT.V1`
```
ChatGPT - A command-line interface to OpenAI's ChatGPT (https://chat.openai.com/chat)
Repo: github.com/acheong08/ChatGPT
Type '!help' to show a full list of commands
Logging in...
You:
(Press Esc followed by Enter to finish)
```
The command line interface supports multi-line inputs and allows navigation using arrow keys. Besides, you can also edit history inputs by arrow keys when the prompt is empty. It also completes your input if it finds matched previous prompts. To finish input, press `Esc` and then `Enter` as solely `Enter` itself is used for creating new line in multi-line mode.
Set the environment variable `NO_COLOR` to `true` to disable color output.
### Developer API
#### Basic example (streamed):
```python
from revChatGPT.V1 import Chatbot
chatbot = Chatbot(config={
"access_token": "<your access_token>"
})
print("Chatbot: ")
prev_text = ""
for data in chatbot.ask(
"Hello world",
):
message = data["message"][len(prev_text) :]
print(message, end="", flush=True)
prev_text = data["message"]
print()
```
#### Basic example (single result):
```python
from revChatGPT.V1 import Chatbot
chatbot = Chatbot(config={
"access_token": "<your access_token>"
})
prompt = "how many beaches does portugal have?"
response = ""
for data in chatbot.ask(
prompt
):
response = data["message"]
print(response)
```
#### All API methods
Refer to the [wiki](https://github.com/acheong08/ChatGPT/wiki/) for advanced developer usage.
</details>
<details>
<summary>
# V3 Official Chat API
> Recently released by OpenAI
>
> - Paid
</summary>
Get API key from https://platform.openai.com/account/api-keys
## Command line
`python3 -m revChatGPT.V3 --api_key <api_key>`
```
$ python3 -m revChatGPT.V3
ChatGPT - Official ChatGPT API
Repo: github.com/acheong08/ChatGPT
Version: 6.2
Type '!help' to show a full list of commands
Press Esc followed by Enter or Alt+Enter to send a message.
usage: V3.py [-h] --api_key API_KEY [--temperature TEMPERATURE] [--no_stream]
[--base_prompt BASE_PROMPT] [--proxy PROXY] [--top_p TOP_P]
[--reply_count REPLY_COUNT] [--enable_internet] [--config CONFIG]
[--submit_key SUBMIT_KEY]
[--model {gpt-3.5-turbo,gpt-3.5-turbo-16k,gpt-3.5-turbo-0301,gpt-3.5-turbo-0613,gpt-4,gpt-4-0314,gpt-4-32k,gpt-4-32k-0314,gpt-4-0613}]
[--truncate_limit TRUNCATE_LIMIT]
```
## Developer API
### Basic example
```python
from revChatGPT.V3 import Chatbot
chatbot = Chatbot(api_key="<api_key>")
chatbot.ask("Hello world")
```
### Streaming example
```python
from revChatGPT.V3 import Chatbot
chatbot = Chatbot(api_key="<api_key>")
for data in chatbot.ask_stream("Hello world"):
print(data, end="", flush=True)
```
</details>
# Awesome ChatGPT
[My list](https://github.com/stars/acheong08/lists/awesome-chatgpt)
If you have a cool project you want added to the list, open an issue.
# Disclaimers
This is not an official OpenAI product. This is a personal project and is not affiliated with OpenAI in any way. Don't sue me.
## Contributors
This project exists thanks to all the people who contribute.
<a href="https://github.com/acheong08/ChatGPT/graphs/contributors">
<img src="https://contrib.rocks/image?repo=acheong08/ChatGPT" />
</a>
## Additional credits
- Coding while listening to [this amazing song](https://www.youtube.com/watch?v=VaMR_xDhsGg) by [virtualharby](https://www.youtube.com/@virtualharby)
Raw data
{
"_id": null,
"home_page": "https://github.com/acheong08/ChatGPT",
"name": "revChatGPT",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Antonio Cheong",
"author_email": "acheong@student.dalat.org",
"download_url": "https://files.pythonhosted.org/packages/2a/e5/0b65cbf83f1dbcae918dfb2b9f35adf5c2b5238fcb37a642399ee3531498/revChatGPT-6.8.6.tar.gz",
"platform": null,
"description": "# ChatGPT <img src=\"https://github.com/acheong08/ChatGPT/blob/main/logo.png?raw=true\" width=\"15%\"></img>\n\nEnglish - [\u4e2d\u6587](./README_zh.md) - [Spanish](./README_sp.md) - [\u65e5\u672c\u8a9e](./README_ja.md) - [\ud55c\uad6d\uc5b4](./README_ko.md)\n\n[![PyPi](https://img.shields.io/pypi/v/revChatGPT.svg)](https://pypi.python.org/pypi/revChatGPT)\n[![Support_Platform](https://img.shields.io/pypi/pyversions/revChatGPT)](https://pypi.python.org/pypi/revChatGPT)\n[![Downloads](https://static.pepy.tech/badge/revchatgpt)](https://pypi.python.org/pypi/revChatGPT)\n\nReverse Engineered ChatGPT API by OpenAI. Extensible for chatbots etc.\n\n[![](https://github.com/acheong08/ChatGPT/blob/main/docs/view.gif?raw=true)](https://pypi.python.org/pypi/revChatGPT)\n\n# Installation\n\n```\npython -m pip install --upgrade revChatGPT\n```\n\n### Suport Python Version\n\n- Minimum - Python3.9\n- Recommend - Python3.11+\n\n<details>\n\n <summary>\n\n# V1 Standard ChatGPT\n\nV1 uses a cloudflare bypass proxy to make life convenient for everyone. The proxy is open source: https://github.com/acheong08/ChatGPT-Proxy-V4\n\nTo set your own deployed proxy, set the environment variable `CHATGPT_BASE_URL` to `https://yourproxy.com/api/`\n\n</summary>\n\n## Rate limits\n\n- Proxy server: 5 requests / 10 seconds\n- OpenAI: 50 requests / hour for each account\n\n## Configuration\n\n1. Create account on [OpenAI's ChatGPT](https://chat.openai.com/)\n2. Save your email and password\n\n### Authentication method: (Choose 1)\n\n#### - Email/Password\n\n> Not supported for Google/Microsoft accounts.\n\n```json\n{\n \"email\": \"email\",\n \"password\": \"your password\"\n}\n```\n\n#### - Access token\n\nhttps://chat.openai.com/api/auth/session\n\n```json\n{\n \"access_token\": \"<access_token>\"\n}\n```\n\n#### - Optional configuration:\n\n```json\n{\n \"conversation_id\": \"UUID...\",\n \"parent_id\": \"UUID...\",\n \"proxy\": \"...\",\n \"model\": \"gpt-4\", // gpt-4-browsing, text-davinci-002-render-sha, gpt-4, gpt-4-plugins\n \"plugin_ids\": [\"plugin-d1d6eb04-3375-40aa-940a-c2fc57ce0f51\"], // Wolfram Alpha example\n \"disable_history\": true,\n \"PUID\": \"<_puid cookie for plus accounts>\", // Only if you have a plus account and use GPT-4\n \"unverified_plugin_domains\":[\"showme.redstarplugin.com\"] // Unverfied plugins to install\n}\n```\n\n1. Save this as `$HOME/.config/revChatGPT/config.json`\n2. If you are using Windows, you will need to create an environment variable named `HOME` and set it to your home profile for the script to be able to locate the config.json file.\n\nPlugin IDs can be found [here](./plugins.json). Remember to set model to `gpt-4-plugins` if plugins are enabled. Plugins may or may not work if you haven't installed them from the web interface. You can call `chatbot.install_plugin(plugin_id=plugin_id)` to install any one of them from code. Call `chatbot.get_plugins()` to get a list of all plugins available.\n\n## Usage\n\n### Command line\n\n`python3 -m revChatGPT.V1`\n\n```\n ChatGPT - A command-line interface to OpenAI's ChatGPT (https://chat.openai.com/chat)\n Repo: github.com/acheong08/ChatGPT\nType '!help' to show a full list of commands\nLogging in...\nYou:\n(Press Esc followed by Enter to finish)\n```\n\nThe command line interface supports multi-line inputs and allows navigation using arrow keys. Besides, you can also edit history inputs by arrow keys when the prompt is empty. It also completes your input if it finds matched previous prompts. To finish input, press `Esc` and then `Enter` as solely `Enter` itself is used for creating new line in multi-line mode.\n\nSet the environment variable `NO_COLOR` to `true` to disable color output.\n\n### Developer API\n\n#### Basic example (streamed):\n\n```python\nfrom revChatGPT.V1 import Chatbot\nchatbot = Chatbot(config={\n \"access_token\": \"<your access_token>\"\n})\nprint(\"Chatbot: \")\nprev_text = \"\"\nfor data in chatbot.ask(\n \"Hello world\",\n):\n message = data[\"message\"][len(prev_text) :]\n print(message, end=\"\", flush=True)\n prev_text = data[\"message\"]\nprint()\n```\n\n#### Basic example (single result):\n\n```python\nfrom revChatGPT.V1 import Chatbot\nchatbot = Chatbot(config={\n \"access_token\": \"<your access_token>\"\n})\nprompt = \"how many beaches does portugal have?\"\nresponse = \"\"\nfor data in chatbot.ask(\n prompt\n):\n response = data[\"message\"]\nprint(response)\n```\n\n#### All API methods\n\nRefer to the [wiki](https://github.com/acheong08/ChatGPT/wiki/) for advanced developer usage.\n\n</details>\n\n<details>\n\n<summary>\n\n# V3 Official Chat API\n\n> Recently released by OpenAI\n>\n> - Paid\n\n</summary>\n\nGet API key from https://platform.openai.com/account/api-keys\n\n## Command line\n\n`python3 -m revChatGPT.V3 --api_key <api_key>`\n\n```\n $ python3 -m revChatGPT.V3\n\n ChatGPT - Official ChatGPT API\n Repo: github.com/acheong08/ChatGPT\n Version: 6.2\n\nType '!help' to show a full list of commands\nPress Esc followed by Enter or Alt+Enter to send a message.\n\nusage: V3.py [-h] --api_key API_KEY [--temperature TEMPERATURE] [--no_stream]\n [--base_prompt BASE_PROMPT] [--proxy PROXY] [--top_p TOP_P]\n [--reply_count REPLY_COUNT] [--enable_internet] [--config CONFIG]\n [--submit_key SUBMIT_KEY]\n [--model {gpt-3.5-turbo,gpt-3.5-turbo-16k,gpt-3.5-turbo-0301,gpt-3.5-turbo-0613,gpt-4,gpt-4-0314,gpt-4-32k,gpt-4-32k-0314,gpt-4-0613}]\n [--truncate_limit TRUNCATE_LIMIT]\n```\n\n## Developer API\n\n### Basic example\n\n```python\nfrom revChatGPT.V3 import Chatbot\nchatbot = Chatbot(api_key=\"<api_key>\")\nchatbot.ask(\"Hello world\")\n```\n\n### Streaming example\n\n```python\nfrom revChatGPT.V3 import Chatbot\nchatbot = Chatbot(api_key=\"<api_key>\")\nfor data in chatbot.ask_stream(\"Hello world\"):\n print(data, end=\"\", flush=True)\n```\n\n</details>\n\n# Awesome ChatGPT\n\n[My list](https://github.com/stars/acheong08/lists/awesome-chatgpt)\n\nIf you have a cool project you want added to the list, open an issue.\n\n# Disclaimers\n\nThis is not an official OpenAI product. This is a personal project and is not affiliated with OpenAI in any way. Don't sue me.\n\n## Contributors\n\nThis project exists thanks to all the people who contribute.\n\n<a href=\"https://github.com/acheong08/ChatGPT/graphs/contributors\">\n<img src=\"https://contrib.rocks/image?repo=acheong08/ChatGPT\" />\n</a>\n\n## Additional credits\n\n- Coding while listening to [this amazing song](https://www.youtube.com/watch?v=VaMR_xDhsGg) by [virtualharby](https://www.youtube.com/@virtualharby)\n",
"bugtrack_url": null,
"license": "GNU General Public License v2.0",
"summary": "ChatGPT is a reverse engineering of OpenAI's ChatGPT API",
"version": "6.8.6",
"project_urls": {
"Bug Report": "https://github.com/acheong08/ChatGPT/issues/new?assignees=&labels=bug-report&template=bug_report.yml&title=%5BBug%5D%3A+",
"Feature request": "https://github.com/acheong08/ChatGPT/issues/new?assignees=&labels=enhancement&template=feature_request.yml&title=%5BFeature+Request%5D%3A+",
"Homepage": "https://github.com/acheong08/ChatGPT"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "de1a867b47770a265af531c80135214880dcf7a0f0acbb10888932237986fc62",
"md5": "fcbc5b7ee8b31bfa064c6c40cb5d8fee",
"sha256": "ee215d4cc6383d499e8bd761fe6de80570cdee21db52b1e2f218f355576b5621"
},
"downloads": -1,
"filename": "revChatGPT-6.8.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fcbc5b7ee8b31bfa064c6c40cb5d8fee",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 33609,
"upload_time": "2023-07-20T05:29:51",
"upload_time_iso_8601": "2023-07-20T05:29:51.736481Z",
"url": "https://files.pythonhosted.org/packages/de/1a/867b47770a265af531c80135214880dcf7a0f0acbb10888932237986fc62/revChatGPT-6.8.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2ae50b65cbf83f1dbcae918dfb2b9f35adf5c2b5238fcb37a642399ee3531498",
"md5": "a371144e2196fb4bd4746b426f67f718",
"sha256": "69e7fa02d318548099dcb6bdffb4fa788dcd12c1816f09a5716c44bf10e44ac9"
},
"downloads": -1,
"filename": "revChatGPT-6.8.6.tar.gz",
"has_sig": false,
"md5_digest": "a371144e2196fb4bd4746b426f67f718",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 34004,
"upload_time": "2023-07-20T05:29:53",
"upload_time_iso_8601": "2023-07-20T05:29:53.407869Z",
"url": "https://files.pythonhosted.org/packages/2a/e5/0b65cbf83f1dbcae918dfb2b9f35adf5c2b5238fcb37a642399ee3531498/revChatGPT-6.8.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-20 05:29:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "acheong08",
"github_project": "ChatGPT",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "revchatgpt"
}