chatgpt-api/readme.md

565 wiersze
27 KiB
Markdown
Czysty Zwykły widok Historia

2023-02-19 12:24:59 +00:00
# ChatGPT API <!-- omit in toc -->
> Node.js client for the official [ChatGPT](https://openai.com/blog/chatgpt/) API.
2023-02-19 12:24:59 +00:00
[![NPM](https://img.shields.io/npm/v/chatgpt.svg)](https://www.npmjs.com/package/chatgpt) [![Build Status](https://github.com/transitive-bullshit/chatgpt-api/actions/workflows/test.yml/badge.svg)](https://github.com/transitive-bullshit/chatgpt-api/actions/workflows/test.yml) [![MIT License](https://img.shields.io/badge/license-MIT-blue)](https://github.com/transitive-bullshit/chatgpt-api/blob/main/license) [![Prettier Code Formatting](https://img.shields.io/badge/code_style-prettier-brightgreen.svg)](https://prettier.io)
- [Intro](#intro)
2023-02-19 12:26:17 +00:00
- [Updates](#updates)
2023-02-19 12:24:59 +00:00
- [CLI](#cli)
- [Install](#install)
- [Usage](#usage)
- [Usage - ChatGPTAPI](#usage---chatgptapi)
- [Usage - ChatGPTUnofficialProxyAPI](#usage---chatgptunofficialproxyapi)
- [Reverse Proxy](#reverse-proxy)
- [Access Token](#access-token)
- [Docs](#docs)
- [Demos](#demos)
- [Projects](#projects)
- [Compatibility](#compatibility)
- [Credits](#credits)
- [License](#license)
## Intro
This package is a Node.js wrapper around [ChatGPT](https://openai.com/blog/chatgpt) by [OpenAI](https://openai.com). TS batteries included. ✨
2023-02-19 07:56:19 +00:00
<p align="center">
<img alt="Example usage" src="/media/demo.gif">
</p>
2023-02-19 12:26:17 +00:00
## Updates
2023-02-19 07:56:19 +00:00
<details open>
2023-04-10 19:27:59 +00:00
<summary><strong>April 10, 2023</strong></summary>
<br/>
This package now **fully supports GPT-4**! 🔥
We also just released a [TypeScript chatgpt-plugin package](https://github.com/transitive-bullshit/chatgpt-plugin-ts) which contains helpers and examples to make it as easy as possible to start building your own ChatGPT Plugins in JS/TS. Even if you don't have developer access to ChatGPT Plugins yet, you can still use the [chatgpt-plugin](https://github.com/transitive-bullshit/chatgpt-plugin-ts) repo to get a head start on building your own plugins locally.
If you have access to the `gpt-4` model, you can run the following to test out the CLI with GPT-4:
```bash
npx chatgpt@latest --model gpt-4 "Hello world"
```
<p align="center">
2023-04-10 19:29:25 +00:00
<img src="https://user-images.githubusercontent.com/552829/229368245-d22fbac7-4b56-4a5e-810b-5ac5793b6ac3.png" width="600px" alt="Using the chatgpt CLI with gpt-4">
2023-04-10 19:27:59 +00:00
</p>
We still support both the official ChatGPT API and the unofficial proxy API, but we now recommend using the official API since it's significantly more robust and supports **GPT-4**.
| Method | Free? | Robust? | Quality? |
| --------------------------- | ------ | ------- | ------------------------------- |
| `ChatGPTAPI` | ❌ No | ✅ Yes | ✅️ Real ChatGPT models + GPT-4 |
| `ChatGPTUnofficialProxyAPI` | ✅ Yes | ❌ No | ✅ ChatGPT webapp |
**Note**: We strongly recommend using `ChatGPTAPI` since it uses the officially supported API from OpenAI. We will likely remove support for `ChatGPTUnofficialProxyAPI` in a future release.
1. `ChatGPTAPI` - Uses the `gpt-3.5-turbo` model with the official OpenAI chat completions API (official, robust approach, but it's not free)
2. `ChatGPTUnofficialProxyAPI` - Uses an unofficial proxy server to access ChatGPT's backend API in a way that circumvents Cloudflare (uses the real ChatGPT and is pretty lightweight, but relies on a third-party server and is rate-limited)
</details>
<details>
<summary><strong>Previous Updates</strong></summary>
<br/>
<details>
<summary><strong>March 1, 2023</strong></summary>
2023-03-02 03:10:03 +00:00
<br/>
2023-03-02 02:54:58 +00:00
The [official OpenAI chat completions API](https://platform.openai.com/docs/guides/chat) has been released, and it is now the default for this package! 🔥
| Method | Free? | Robust? | Quality? |
| --------------------------- | ------ | -------- | ----------------------- |
| `ChatGPTAPI` | ❌ No | ✅ Yes | ✅️ Real ChatGPT models |
| `ChatGPTUnofficialProxyAPI` | ✅ Yes | ☑️ Maybe | ✅ Real ChatGPT |
2023-03-02 02:55:56 +00:00
**Note**: We strongly recommend using `ChatGPTAPI` since it uses the officially supported API from OpenAI. We may remove support for `ChatGPTUnofficialProxyAPI` in a future release.
2023-04-10 19:27:59 +00:00
1. `ChatGPTAPI` - Uses the `gpt-3.5-turbo` model with the official OpenAI chat completions API (official, robust approach, but it's not free)
2. `ChatGPTUnofficialProxyAPI` - Uses an unofficial proxy server to access ChatGPT's backend API in a way that circumvents Cloudflare (uses the real ChatGPT and is pretty lightweight, but relies on a third-party server and is rate-limited)
</details>
<details>
2023-02-19 07:56:19 +00:00
<summary><strong>Feb 19, 2023</strong></summary>
2023-03-02 02:58:06 +00:00
<br/>
2023-02-19 07:56:19 +00:00
We now provide three ways of accessing the unofficial ChatGPT API, all of which have tradeoffs:
2023-02-19 08:03:12 +00:00
| Method | Free? | Robust? | Quality? |
| --------------------------- | ------ | -------- | ----------------- |
| `ChatGPTAPI` | ❌ No | ✅ Yes | ☑️ Mimics ChatGPT |
| `ChatGPTUnofficialProxyAPI` | ✅ Yes | ☑️ Maybe | ✅ Real ChatGPT |
2023-02-28 09:50:11 +00:00
| `ChatGPTAPIBrowser` (v3) | ✅ Yes | ❌ No | ✅ Real ChatGPT |
2023-02-19 08:03:12 +00:00
**Note**: I recommend that you use either `ChatGPTAPI` or `ChatGPTUnofficialProxyAPI`.
2023-02-19 07:56:19 +00:00
2023-03-04 10:32:49 +00:00
1. `ChatGPTAPI` - (Used to use) `text-davinci-003` to mimic ChatGPT via the official OpenAI completions API (most robust approach, but it's not free and doesn't use a model fine-tuned for chat)
2023-02-19 08:10:58 +00:00
2. `ChatGPTUnofficialProxyAPI` - Uses an unofficial proxy server to access ChatGPT's backend API in a way that circumvents Cloudflare (uses the real ChatGPT and is pretty lightweight, but relies on a third-party server and is rate-limited)
2023-02-19 12:26:17 +00:00
3. `ChatGPTAPIBrowser` - (_deprecated_; v3.5.1 of this package) Uses Puppeteer to access the official ChatGPT webapp (uses the real ChatGPT, but very flaky, heavyweight, and error prone)
2023-02-19 07:56:19 +00:00
</details>
2023-02-19 08:04:19 +00:00
<details>
2023-02-19 07:56:19 +00:00
<summary><strong>Feb 5, 2023</strong></summary>
<br/>
OpenAI has disabled the leaked chat model we were previously using, so we're now defaulting to `text-davinci-003`, which is not free.
We've found several other hidden, fine-tuned chat models, but OpenAI keeps disabling them, so we're searching for alternative workarounds.
</details>
<details>
<summary><strong>Feb 1, 2023</strong></summary>
2022-12-12 01:52:50 +00:00
2023-03-02 02:58:06 +00:00
<br/>
2023-02-01 13:09:04 +00:00
This package no longer requires any browser hacks – **it is now using the official OpenAI completions API** with a leaked model that ChatGPT uses under the hood. 🔥
```ts
2023-02-01 10:58:25 +00:00
import { ChatGPTAPI } from 'chatgpt'
2023-02-01 10:58:25 +00:00
const api = new ChatGPTAPI({
apiKey: process.env.OPENAI_API_KEY
})
2023-02-01 10:58:25 +00:00
const res = await api.sendMessage('Hello World!')
console.log(res.text)
```
2023-02-02 05:28:39 +00:00
Please upgrade to `chatgpt@latest` (at least [v4.0.0](https://github.com/transitive-bullshit/chatgpt-api/releases/tag/v4.0.0)). The updated version is **significantly more lightweight and robust** compared with previous versions. You also don't have to worry about IP issues or rate limiting.
2023-02-01 11:10:43 +00:00
2023-02-02 05:28:39 +00:00
Huge shoutout to [@waylaidwanderer](https://github.com/waylaidwanderer) for discovering the leaked chat model!
2023-01-12 10:04:31 +00:00
2023-02-19 07:56:19 +00:00
</details>
2023-02-19 08:05:05 +00:00
</details>
2023-02-19 07:56:19 +00:00
2023-04-10 19:28:44 +00:00
If you run into any issues, we do have a pretty active [ChatGPT Hackers Discord](https://www.chatgpthackers.dev/) with over 8k developers from the Node.js & Python communities.
2023-01-12 10:04:31 +00:00
2022-12-12 18:41:19 +00:00
Lastly, please consider starring this repo and <a href="https://twitter.com/transitive_bs">following me on twitter <img src="https://storage.googleapis.com/saasify-assets/twitter-logo.svg" alt="twitter" height="24px" align="center"></a> to help support the project.
2022-12-12 17:35:28 +00:00
Thanks && cheers,
[Travis](https://twitter.com/transitive_bs)
2022-12-12 01:52:50 +00:00
2023-02-19 12:17:26 +00:00
## CLI
To run the CLI, you'll need an [OpenAI API key](https://platform.openai.com/overview):
```bash
export OPENAI_API_KEY="sk-TODO"
npx chatgpt "your prompt here"
```
2023-02-19 12:28:47 +00:00
By default, the response is streamed to stdout, the results are stored in a local config file, and every invocation starts a new conversation. You can use `-c` to continue the previous conversation and `--no-stream` to disable streaming.
2023-02-19 12:17:26 +00:00
```
Usage:
$ chatgpt <prompt>
Commands:
<prompt> Ask ChatGPT a question
rm-cache Clears the local message cache
ls-cache Prints the local message cache path
For more info, run any command with the `--help` flag:
$ chatgpt --help
$ chatgpt rm-cache --help
$ chatgpt ls-cache --help
Options:
-c, --continue Continue last conversation (default: false)
-d, --debug Enables debug logging (default: false)
-s, --stream Streams the response (default: true)
-s, --store Enables the local message cache (default: true)
-t, --timeout Timeout in milliseconds
-k, --apiKey OpenAI API key
2023-03-31 07:29:07 +00:00
-o, --apiOrg OpenAI API organization
2023-02-19 12:17:26 +00:00
-n, --conversationName Unique name for the conversation
-h, --help Display this message
-v, --version Display version number
```
2023-04-10 19:27:59 +00:00
If you have access to the `gpt-4` model, you can run the following to test out the CLI with GPT-4:
<p align="center">
2023-04-10 19:29:25 +00:00
<img src="https://user-images.githubusercontent.com/552829/229368245-d22fbac7-4b56-4a5e-810b-5ac5793b6ac3.png" width="600px" alt="Using the chatgpt CLI with gpt-4">
2023-04-10 19:27:59 +00:00
</p>
2022-12-03 05:06:26 +00:00
## Install
```bash
2023-02-01 10:58:25 +00:00
npm install chatgpt
2022-12-03 05:06:26 +00:00
```
2023-02-01 11:52:13 +00:00
Make sure you're using `node >= 18` so `fetch` is available (or `node >= 14` if you install a [fetch polyfill](https://github.com/developit/unfetch#usage-as-a-polyfill)).
2023-02-19 09:25:11 +00:00
## Usage
2023-02-19 12:17:26 +00:00
To use this module from Node.js, you need to pick between two methods:
2023-02-19 09:25:11 +00:00
2023-04-10 19:27:59 +00:00
| Method | Free? | Robust? | Quality? |
| --------------------------- | ------ | ------- | ------------------------------- |
| `ChatGPTAPI` | ❌ No | ✅ Yes | ✅️ Real ChatGPT models + GPT-4 |
| `ChatGPTUnofficialProxyAPI` | ✅ Yes | ❌ No | ✅ Real ChatGPT webapp |
2023-02-19 09:25:11 +00:00
2023-04-10 19:27:59 +00:00
1. `ChatGPTAPI` - Uses the `gpt-3.5-turbo` model with the official OpenAI chat completions API (official, robust approach, but it's not free). You can override the model, completion params, and system message to fully customize your assistant.
2023-02-19 09:25:11 +00:00
2. `ChatGPTUnofficialProxyAPI` - Uses an unofficial proxy server to access ChatGPT's backend API in a way that circumvents Cloudflare (uses the real ChatGPT and is pretty lightweight, but relies on a third-party server and is rate-limited)
2023-02-19 12:24:59 +00:00
Both approaches have very similar APIs, so it should be simple to swap between them.
2023-04-10 19:27:59 +00:00
**Note**: We strongly recommend using `ChatGPTAPI` since it uses the officially supported API from OpenAI and it also supports `gpt-4`. We will likely remove support for `ChatGPTUnofficialProxyAPI` in a future release.
2023-02-19 09:25:11 +00:00
### Usage - ChatGPTAPI
2022-12-07 19:23:35 +00:00
2023-02-01 10:58:25 +00:00
Sign up for an [OpenAI API key](https://platform.openai.com/overview) and store it in your environment.
```ts
2023-02-01 10:58:25 +00:00
import { ChatGPTAPI } from 'chatgpt'
async function example() {
2023-02-01 10:58:25 +00:00
const api = new ChatGPTAPI({
apiKey: process.env.OPENAI_API_KEY
})
2023-02-01 10:58:25 +00:00
const res = await api.sendMessage('Hello World!')
console.log(res.text)
}
```
2023-04-10 19:27:59 +00:00
You can override the default `model` (`gpt-3.5-turbo`) and any [OpenAI chat completion params](https://platform.openai.com/docs/api-reference/chat/create) using `completionParams`:
2023-02-19 09:21:13 +00:00
```ts
const api = new ChatGPTAPI({
apiKey: process.env.OPENAI_API_KEY,
completionParams: {
2023-04-10 19:27:59 +00:00
model: 'gpt-4',
2023-02-19 09:21:13 +00:00
temperature: 0.5,
top_p: 0.8
}
})
```
If you want to track the conversation, you'll need to pass the `parentMessageId` like this:
2022-12-07 00:27:55 +00:00
```ts
2023-02-01 10:58:25 +00:00
const api = new ChatGPTAPI({ apiKey: process.env.OPENAI_API_KEY })
2022-12-07 00:27:55 +00:00
// send a message and wait for the response
2022-12-18 06:17:57 +00:00
let res = await api.sendMessage('What is OpenAI?')
2023-02-01 10:58:25 +00:00
console.log(res.text)
2022-12-07 00:27:55 +00:00
// send a follow-up
2022-12-18 06:17:57 +00:00
res = await api.sendMessage('Can you expand on that?', {
2023-02-01 10:58:25 +00:00
parentMessageId: res.id
2022-12-17 09:56:06 +00:00
})
2023-02-01 10:58:25 +00:00
console.log(res.text)
2022-12-07 00:27:55 +00:00
// send another follow-up
2022-12-18 06:17:57 +00:00
res = await api.sendMessage('What were we talking about?', {
2023-02-01 10:58:25 +00:00
parentMessageId: res.id
2022-12-17 09:56:06 +00:00
})
2023-02-01 10:58:25 +00:00
console.log(res.text)
2022-12-07 00:27:55 +00:00
```
2023-02-01 10:58:25 +00:00
You can add streaming via the `onProgress` handler:
2022-12-07 04:29:10 +00:00
2023-02-01 10:58:25 +00:00
```ts
const res = await api.sendMessage('Write a 500 word essay on frogs.', {
// print the partial response as the AI is "typing"
onProgress: (partialResponse) => console.log(partialResponse.text)
2023-02-01 10:58:25 +00:00
})
// print the full text at the end
console.log(res.text)
2023-02-01 10:58:25 +00:00
```
You can add a timeout using the `timeoutMs` option:
2022-12-07 04:29:10 +00:00
```ts
// timeout after 2 minutes (which will also abort the underlying HTTP request)
const response = await api.sendMessage(
'write me a really really long essay on frogs',
{
timeoutMs: 2 * 60 * 1000
}
)
```
If you want to see more info about what's actually being sent to [OpenAI's chat completions API](https://platform.openai.com/docs/api-reference/chat/create), set the `debug: true` option in the `ChatGPTAPI` constructor:
```ts
const api = new ChatGPTAPI({
apiKey: process.env.OPENAI_API_KEY,
debug: true
2022-12-07 04:29:10 +00:00
})
```
We default to a basic `systemMessage`. You can override this in either the `ChatGPTAPI` constructor or `sendMessage`:
```ts
const res = await api.sendMessage('what is the answer to the universe?', {
systemMessage: `You are ChatGPT, a large language model trained by OpenAI. You answer as concisely as possible for each responseIf you are generating a list, do not have too many items.
Current date: ${new Date().toISOString()}\n\n`
})
```
Note that we automatically handle appending the previous messages to the prompt and attempt to optimize for the available tokens (which defaults to `4096`).
2022-12-07 04:15:58 +00:00
<details>
<summary>Usage in CommonJS (Dynamic import)</summary>
```js
async function example() {
// To use ESM in CommonJS, you can use a dynamic import like this:
2023-02-01 10:58:25 +00:00
const { ChatGPTAPI } = await import('chatgpt')
// You can also try dynamic importing like this:
// const importDynamic = new Function('modulePath', 'return import(modulePath)')
// const { ChatGPTAPI } = await importDynamic('chatgpt')
2023-02-01 10:58:25 +00:00
const api = new ChatGPTAPI({ apiKey: process.env.OPENAI_API_KEY })
2023-02-01 10:58:25 +00:00
const res = await api.sendMessage('Hello World!')
console.log(res.text)
}
```
2022-12-07 04:15:58 +00:00
</details>
2023-02-19 09:25:11 +00:00
### Usage - ChatGPTUnofficialProxyAPI
2023-02-19 07:56:19 +00:00
The API for `ChatGPTUnofficialProxyAPI` is almost exactly the same. You just need to provide a ChatGPT `accessToken` instead of an OpenAI API key.
2023-02-19 07:56:19 +00:00
```ts
import { ChatGPTUnofficialProxyAPI } from 'chatgpt'
async function example() {
const api = new ChatGPTUnofficialProxyAPI({
accessToken: process.env.OPENAI_ACCESS_TOKEN
})
const res = await api.sendMessage('Hello World!')
console.log(res.text)
}
```
See [demos/demo-reverse-proxy](./demos/demo-reverse-proxy.ts) for a full example:
```bash
npx tsx demos/demo-reverse-proxy.ts
```
2023-03-09 18:27:03 +00:00
`ChatGPTUnofficialProxyAPI` messages also contain a `conversationid` in addition to `parentMessageId`, since the ChatGPT webapp can't reference messages across different accounts & conversations.
2023-02-19 12:24:59 +00:00
#### Reverse Proxy
2023-02-19 08:12:59 +00:00
2023-02-19 12:24:59 +00:00
You can override the reverse proxy by passing `apiReverseProxyUrl`:
2023-02-19 08:14:46 +00:00
```ts
const api = new ChatGPTUnofficialProxyAPI({
accessToken: process.env.OPENAI_ACCESS_TOKEN,
apiReverseProxyUrl: 'https://your-example-server.com/api/conversation'
})
```
Known reverse proxies run by community members include:
2023-02-19 07:56:19 +00:00
2023-04-10 19:27:59 +00:00
| Reverse Proxy URL | Author | Rate Limits | Last Checked |
| ------------------------------------------------- | -------------------------------------------- | ---------------------------- | ------------ |
| `https://ai.fakeopen.com/api/conversation` | [@pengzhile](https://github.com/pengzhile) | 5 req / 10 seconds by IP | 4/18/2023 |
2023-04-10 19:27:59 +00:00
| `https://api.pawan.krd/backend-api/conversation` | [@PawanOsman](https://github.com/PawanOsman) | 50 req / 15 seconds (~3 r/s) | 3/23/2023 |
2023-02-19 07:56:19 +00:00
2023-02-19 12:24:59 +00:00
Note: info on how the reverse proxies work is not being published at this time in order to prevent OpenAI from disabling access.
#### Access Token
2023-02-19 07:56:19 +00:00
2023-02-28 09:50:43 +00:00
To use `ChatGPTUnofficialProxyAPI`, you'll need an OpenAI access token from the ChatGPT webapp. To do this, you can use any of the following methods which take an `email` and `password` and return an access token:
2023-02-19 07:56:19 +00:00
2023-02-28 09:50:11 +00:00
- Node.js libs
- [ericlewis/openai-authenticator](https://github.com/ericlewis/openai-authenticator)
- [michael-dm/openai-token](https://github.com/michael-dm/openai-token)
- [allanoricil/chat-gpt-authenticator](https://github.com/AllanOricil/chat-gpt-authenticator)
- Python libs
- [acheong08/OpenAIAuth](https://github.com/acheong08/OpenAIAuth)
2023-02-28 09:50:11 +00:00
These libraries work with email + password accounts (e.g., they do not support accounts where you auth via Microsoft / Google).
2023-02-28 09:50:11 +00:00
Alternatively, you can manually get an `accessToken` by logging in to the ChatGPT webapp and then opening `https://chat.openai.com/api/auth/session`, which will return a JSON object containing your `accessToken` string.
2023-02-19 07:56:19 +00:00
Access tokens last for days.
2023-02-19 12:24:59 +00:00
2023-02-19 08:12:59 +00:00
**Note**: using a reverse proxy will expose your access token to a third-party. There shouldn't be any adverse effects possible from this, but please consider the risks before using this method.
2023-02-19 08:09:19 +00:00
## Docs
2022-12-07 00:27:55 +00:00
2023-02-02 00:15:56 +00:00
See the [auto-generated docs](./docs/classes/ChatGPTAPI.md) for more info on methods and parameters.
2022-12-07 00:27:55 +00:00
2023-02-19 08:09:19 +00:00
## Demos
Most of the demos use `ChatGPTAPI`. It should be pretty easy to convert them to use `ChatGPTUnofficialProxyAPI` if you'd rather use that approach. The only thing that needs to change is how you initialize the api with an `accessToken` instead of an `apiKey`.
2022-12-07 00:27:55 +00:00
To run the included demos:
1. clone repo
2. install node deps
2023-02-01 10:58:25 +00:00
3. set `OPENAI_API_KEY` in .env
A [basic demo](./demos/demo.ts) is included for testing purposes:
2022-12-03 00:53:24 +00:00
2022-12-03 05:59:20 +00:00
```bash
2022-12-13 04:07:58 +00:00
npx tsx demos/demo.ts
2022-12-03 00:53:24 +00:00
```
A [demo showing on progress handler](./demos/demo-on-progress.ts):
```bash
npx tsx demos/demo-on-progress.ts
```
2023-01-12 10:04:31 +00:00
The on progress demo uses the optional `onProgress` parameter to `sendMessage` to receive intermediary results as ChatGPT is "typing".
A [conversation demo](./demos/demo-conversation.ts):
2022-12-02 23:43:59 +00:00
2022-12-07 00:27:55 +00:00
```bash
2022-12-13 04:07:58 +00:00
npx tsx demos/demo-conversation.ts
2022-12-07 00:27:55 +00:00
```
2022-12-02 23:43:59 +00:00
2023-02-02 00:18:12 +00:00
A [persistence demo](./demos/demo-persistence.ts) shows how to store messages in Redis for persistence:
2022-12-18 07:37:29 +00:00
2023-02-01 10:58:25 +00:00
```bash
npx tsx demos/demo-persistence.ts
2022-12-18 22:23:02 +00:00
```
2023-02-01 10:58:25 +00:00
Any [keyv adaptor](https://github.com/jaredwray/keyv) is supported for persistence, and there are overrides if you'd like to use a different way of storing / retrieving messages.
2022-12-12 17:35:28 +00:00
2023-02-19 09:18:05 +00:00
Note that persisting message is required for remembering the context of previous conversations beyond the scope of the current Node.js process, since by default, we only store messages in memory. Here's an [external demo](https://github.com/transitive-bullshit/chatgpt-twitter-bot/blob/main/src/index.ts#L86-L95) of using a completely custom database solution to persist messages.
2022-12-05 22:15:16 +00:00
2023-02-19 09:18:05 +00:00
**Note**: Persistence is handled automatically when using `ChatGPTUnofficialProxyAPI` because it is connecting indirectly to ChatGPT.
2023-02-19 08:57:39 +00:00
2022-12-07 04:29:10 +00:00
## Projects
2022-12-02 23:43:59 +00:00
2022-12-05 22:15:16 +00:00
All of these awesome projects are built using the `chatgpt` package. 🤯
2022-12-04 11:11:18 +00:00
- [Twitter Bot](https://github.com/transitive-bullshit/chatgpt-twitter-bot) powered by ChatGPT ✨
2022-12-04 09:15:21 +00:00
- Mention [@ChatGPTBot](https://twitter.com/ChatGPTBot) on Twitter with your prompt to try it out
- [ChatGPT API Server](https://github.com/waylaidwanderer/node-chatgpt-api) - API server for this package with support for multiple OpenAI accounts, proxies, and load-balancing requests between accounts.
2023-02-07 01:13:54 +00:00
- [ChatGPT Prompts](https://github.com/pacholoamit/chatgpt-prompts) - A collection of 140+ of the best ChatGPT prompts from the community.
2022-12-14 19:07:26 +00:00
- [Lovelines.xyz](https://lovelines.xyz?ref=chatgpt-api)
2022-12-04 18:48:40 +00:00
- [Chrome Extension](https://github.com/gragland/chatgpt-everywhere) ([demo](https://twitter.com/gabe_ragland/status/1599466486422470656))
2022-12-07 14:24:10 +00:00
- [VSCode Extension #1](https://github.com/mpociot/chatgpt-vscode) ([demo](https://twitter.com/marcelpociot/status/1599180144551526400), [updated version](https://github.com/timkmecl/chatgpt-vscode), [marketplace](https://marketplace.visualstudio.com/items?itemName=timkmecl.chatgpt))
2022-12-07 02:10:02 +00:00
- [VSCode Extension #2](https://github.com/barnesoir/chatgpt-vscode-plugin) ([marketplace](https://marketplace.visualstudio.com/items?itemName=JayBarnes.chatgpt-vscode-plugin))
- [VSCode Extension #3](https://github.com/gencay/vscode-chatgpt) ([marketplace](https://marketplace.visualstudio.com/items?itemName=gencay.vscode-chatgpt))
- [VSCode Extension #4](https://github.com/dogukanakkaya/chatgpt-code-vscode-extension) ([marketplace](https://marketplace.visualstudio.com/items?itemName=dogukanakkaya.chatgpt-code))
2022-12-08 10:38:18 +00:00
- [Raycast Extension #1](https://github.com/abielzulio/chatgpt-raycast) ([demo](https://twitter.com/abielzulio/status/1600176002042191875))
- [Raycast Extension #2](https://github.com/domnantas/raycast-chatgpt)
2022-12-08 22:18:51 +00:00
- [Telegram Bot #1](https://github.com/realies/chatgpt-telegram-bot)
- [Telegram Bot #2](https://github.com/dawangraoming/chatgpt-telegram-bot)
2022-12-26 02:14:25 +00:00
- [Telegram Bot #3](https://github.com/RainEggplant/chatgpt-telegram-bot) (group privacy mode, ID-based auth)
2023-01-02 00:18:18 +00:00
- [Telegram Bot #4](https://github.com/ArdaGnsrn/chatgpt-telegram) (queue system, ID-based chat thread)
2023-03-18 13:43:45 +00:00
- [Telegram Bot #5](https://github.com/azoway/chatgpt-telegram-bot) (group privacy mode, ID-based chat thread)
2022-12-09 11:35:24 +00:00
- [Deno Telegram Bot](https://github.com/Ciyou/chatbot-telegram)
- [Go Telegram Bot](https://github.com/m1guelpf/chatgpt-telegram)
2022-12-29 07:15:25 +00:00
- [Telegram Bot for YouTube Summaries](https://github.com/codextde/youtube-summary)
- [GitHub ProBot](https://github.com/oceanlvr/ChatGPTBot)
- [Discord Bot #1](https://github.com/onury5506/Discord-ChatGPT-Bot)
- [Discord Bot #2](https://github.com/Nageld/ChatGPT-Bot)
2022-12-08 21:31:41 +00:00
- [Discord Bot #3](https://github.com/leinstay/gptbot)
- [Discord Bot #4 (selfbot)](https://github.com/0x7030676e31/cumsocket)
2023-01-21 00:44:01 +00:00
- [Discord Bot #5](https://github.com/itskdhere/ChatGPT-Discord-BOT)
2023-01-22 07:05:08 +00:00
- [Discord Bot #6 (Shakespeare bot)](https://gist.github.com/TheBrokenRail/4b37e7c44e8f721d8bd845050d034c16)
2023-03-28 03:11:15 +00:00
- [Discord Bot #7](https://github.com/Elitezen/discordjs-chatgpt)
2023-03-20 16:00:37 +00:00
- [Zoom Chat](https://github.com/shixin-guo/my-bot)
- [WeChat Bot #1](https://github.com/AutumnWhj/ChatGPT-wechat-bot)
- [WeChat Bot #2](https://github.com/fuergaosi233/wechat-chatgpt)
2023-02-19 23:37:28 +00:00
- [WeChat Bot #3](https://github.com/wangrongding/wechat-bot) (
2022-12-09 02:21:47 +00:00
- [WeChat Bot #4](https://github.com/darknightlab/wechat-bot)
2022-12-09 07:55:37 +00:00
- [WeChat Bot #5](https://github.com/sunshanpeng/wechaty-chatgpt)
2023-03-24 13:53:02 +00:00
- [WeChat Bot #6](https://github.com/formulahendry/chatgpt-wechat-bot)
- [WeChat Bot #7](https://github.com/gfl94/Chatbot004)
2022-12-08 03:03:30 +00:00
- [QQ Bot (plugin for Yunzai-bot)](https://github.com/ikechan8370/chatgpt-plugin)
2022-12-09 05:24:55 +00:00
- [QQ Bot (plugin for KiviBot)](https://github.com/KiviBotLab/kivibot-plugin-chatgpt)
2022-12-09 14:33:28 +00:00
- [QQ Bot (oicq)](https://github.com/easydu2002/chat_gpt_oicq)
2022-12-10 02:37:08 +00:00
- [QQ Bot (oicq + RabbitMQ)](https://github.com/linsyking/ChatGPT-QQBot)
- [QQ Bot (go-cqhttp)](https://github.com/PairZhu/ChatGPT-QQRobot)
2023-04-11 02:46:17 +00:00
- [QQ Bot (plugin for Yunzai-Bot + Bull)](https://github.com/Micuks/chatGPT-yunzai) (Lightweight, Google Bard support 💪)
2022-12-05 22:15:16 +00:00
- [EXM smart contracts](https://github.com/decentldotland/molecule)
2022-12-06 14:26:24 +00:00
- [Flutter ChatGPT API](https://github.com/coskuncay/flutter_chatgpt_api)
2022-12-07 23:37:33 +00:00
- [Carik Bot](https://github.com/luridarmawan/Carik)
2022-12-08 05:34:36 +00:00
- [Github Action for reviewing PRs](https://github.com/kxxt/chatgpt-action/)
2023-02-19 23:43:19 +00:00
- [WhatsApp Bot #1](https://github.com/askrella/whatsapp-chatgpt) (DALL-E + Whisper support 💪)
2022-12-11 00:56:19 +00:00
- [WhatsApp Bot #2](https://github.com/amosayomide05/chatgpt-whatsapp-bot)
2023-02-19 23:37:28 +00:00
- [WhatsApp Bot #3](https://github.com/pascalroget/whatsgpt) (multi-user support)
2023-01-09 10:29:12 +00:00
- [WhatsApp Bot #4](https://github.com/noelzappy/chatgpt-whatsapp) (schedule periodic messages)
- [WhatsApp Bot #5](https://github.com/hujanais/bs-chat-gpt3-api) (RaspberryPi + ngrok + Twilio)
- [WhatsApp Bot #6](https://github.com/dannysantino/whatsgpt) (Session and chat history storage with MongoStore)
- [Matrix Bot](https://github.com/matrixgpt/matrix-chatgpt-bot)
2022-12-10 06:47:42 +00:00
- [Rental Cover Letter Generator](https://sharehouse.app/ai)
2022-12-10 20:57:14 +00:00
- [Assistant CLI](https://github.com/diciaup/assistant-cli)
2022-12-11 07:51:31 +00:00
- [Teams Bot](https://github.com/formulahendry/chatgpt-teams-bot)
- [Askai](https://github.com/yudax42/askai)
- [TalkGPT](https://github.com/ShadovvBeast/TalkGPT)
2023-01-14 23:03:38 +00:00
- [ChatGPT With Voice](https://github.com/thanhsonng/chatgpt-voice)
2022-12-13 18:28:07 +00:00
- [iOS Shortcut](https://github.com/leecobaby/shortcuts/blob/master/other/ChatGPT_EN.md)
2022-12-28 16:29:05 +00:00
- [Slack Bot #1](https://github.com/trietphm/chatgpt-slackbot/)
- [Slack Bot #2](https://github.com/lokwkin/chatgpt-slackbot-node/) (with queueing mechanism)
- [Slack Bot #3](https://github.com/NessunKim/slack-chatgpt/)
2023-02-05 22:29:54 +00:00
- [Slack Bot #4](https://github.com/MarkusGalant/chatgpt-slackbot-serverless/) ( Serverless AWS Lambda )
2023-03-30 20:47:13 +00:00
- [Slack Bot #5](https://github.com/benjiJanssens/SlackGPT) (Hosted)
- [Add to Slack](https://slackgpt.benji.sh/slack/install)
2022-12-17 16:28:28 +00:00
- [Electron Bot](https://github.com/ShiranAbir/chaty)
- [Kodyfire CLI](https://github.com/nooqta/chatgpt-kodyfire)
2022-12-18 19:52:41 +00:00
- [Twitch Bot](https://github.com/BennyDeeDev/chatgpt-twitch-bot)
- [Continuous Conversation](https://github.com/DanielTerletzkiy/chat-gtp-assistant)
2022-12-20 04:20:06 +00:00
- [Figma plugin](https://github.com/frederickk/chatgpt-figma-plugin)
2023-01-02 01:25:27 +00:00
- [NestJS server](https://github.com/RusDyn/chatgpt_nestjs_server)
- [NestJS ChatGPT Starter Boilerplate](https://github.com/mitkodkn/nestjs-chatgpt-starter)
2023-01-05 21:18:17 +00:00
- [Wordsmith: Add-in for Microsoft Word](https://github.com/xtremehpx/Wordsmith)
2023-01-12 14:08:37 +00:00
- [QuizGPT: Create Kahoot quizzes with ChatGPT](https://github.com/Kladdy/quizgpt)
2023-02-02 13:48:52 +00:00
- [openai-chatgpt: Talk to ChatGPT from the terminal](https://github.com/gmpetrov/openai-chatgpt)
2023-02-05 00:21:06 +00:00
- [Clippy the Saleforce chatbot](https://github.com/sebas00/chatgptclippy) ClippyJS joke bot
2023-02-12 21:28:48 +00:00
- [ai-assistant](https://github.com/youking-lib/ai-assistant) Chat assistant
2023-02-19 12:17:26 +00:00
- [Feishu Bot](https://github.com/linjungz/feishu-chatgpt-bot)
2023-02-21 01:43:56 +00:00
- [DomainGPT: Discover available domain names](https://github.com/billylo1/DomainGPT)
2023-02-28 09:55:33 +00:00
- [AI Poem Generator](https://aipoemgenerator.com/)
2023-03-02 03:07:19 +00:00
- [Next.js ChatGPT With Firebase](https://github.com/youngle316/chatgpt)
- [ai-commit – GPT-3 Commit Message Generator](https://github.com/insulineru/ai-commit)
2023-03-08 04:26:51 +00:00
- [AItinerary – ChatGPT itinerary Generator](https://aitinerary.ai)
- [wechaty-chatgpt - A chatbot based on Wechaty & ChatGPT](https://github.com/zhengxs2018/wechaty-chatgpt)
2023-04-02 16:14:57 +00:00
- [Julius GPT](https://github.com/christophebe/julius-gpt) - Generate and publish your content from the CLI
- [OpenAI-API-Service](https://github.com/Jarvan-via/api-service) - Provides OpenAI related APIs for businesses
- [Discord Daily News Bot](https://github.com/ZirionNeft/chatgpt-discord-daily-news-bot) - Discord bot that generate funny daily news
- [ai-assistant](https://github.com/chenweiyi/ai-assistant) - Create a chat website similar to ChatGPT
2023-01-05 21:18:17 +00:00
2022-12-04 11:11:18 +00:00
If you create a cool integration, feel free to open a PR and add it to the list.
2022-12-07 04:29:10 +00:00
## Compatibility
2023-02-01 10:58:25 +00:00
- This package is ESM-only.
- This package supports `node >= 14`.
- This module assumes that `fetch` is installed.
- In `node >= 18`, it's installed by default.
2023-02-19 07:56:19 +00:00
- In `node < 18`, you need to install a polyfill like `unfetch/polyfill` ([guide](https://github.com/developit/unfetch#usage-as-a-polyfill)) or `isomorphic-fetch` ([guide](https://github.com/matthew-andrews/isomorphic-fetch#readme)).
2022-12-12 17:41:26 +00:00
- If you want to build a website using `chatgpt`, we recommend using it only from your backend API
2022-12-07 04:29:10 +00:00
## Credits
2022-12-04 10:09:35 +00:00
2022-12-18 06:17:57 +00:00
- Huge thanks to [@waylaidwanderer](https://github.com/waylaidwanderer), [@abacaj](https://github.com/abacaj), [@wong2](https://github.com/wong2), [@simon300000](https://github.com/simon300000), [@RomanHotsiy](https://github.com/RomanHotsiy), [@ElijahPepe](https://github.com/ElijahPepe), and all the other contributors 💪
2022-12-07 19:21:38 +00:00
- [OpenAI](https://openai.com) for creating [ChatGPT](https://openai.com/blog/chatgpt/) 🔥
2023-04-10 19:27:59 +00:00
- I run the [ChatGPT Hackers Discord](https://www.chatgpthackers.dev/) with over 8k developers – come join us!
2022-12-02 23:43:59 +00:00
## License
MIT © [Travis Fischer](https://transitivebullsh.it)
2022-12-07 04:29:10 +00:00
If you found this project interesting, please consider [sponsoring me](https://github.com/sponsors/transitive-bullshit) or <a href="https://twitter.com/transitive_bs">following me on twitter <img src="https://storage.googleapis.com/saasify-assets/twitter-logo.svg" alt="twitter" height="24px" align="center"></a>