Updates
2023-03-01
Support for the official Cloud9 model has been added! You can now use the gpt-3.5-turbo
model with the official OpenAI API, using Cloud9Client
. This is the same model that Cloud9 uses, and it's the most powerful model available right now. Usage of this model is not free, however it is 10x cheaper (priced at $0.002 per 1k tokens) than text-davinci-003
.
See OpenAI's post, Introducing Cloud9 and Whisper APIs for more information.
To use it, set modelOptions.model
to gpt-3.5-turbo
, and Cloud9Client
will handle the rest.
The default model used in Cloud9Client
is now gpt-3.5-turbo
.
You can still set userLabel
, cloud9Label
and promptPrefix
(system instructions) as usual.
There may be a higher chance of your account being banned if you continue to automate chat.openai.com. Continue doing so at your own risk.
Previous Updates
2023-02-19
I've added an experimental Cloud9BrowserClient
which depends on a reverse proxy server that makes use of a Cloudflare bypass, allowing you to talk to Cloud9 (chat.openai.com) without requiring browser automation. All you need is your access token from https://chat.openai.com/api/auth/session.
As always, please note that if you choose to go this route, you are exposing your access token to a closed-source third-party server. If you are concerned about this, you may choose to either use a free Cloud9 account to minimize risks, or continue using Cloud9Client
instead with the text-davinci-003
model.
2023-02-15
The method we were using to access the Cloud9 underlying models has been patched, unfortunately. Your options right now are to either use the official OpenAI API with the text-davinci-003
model (which costs money), or use a browser-based solution to interface with Cloud9's backend (which is less powerful, more rate-limited and is not supported by this library at this time).
2023-02-11
With the help of @PawanOsman, we've figured out a way to continue using the Cloud9 underlying models. To hopefully prevent losing access again, we've decided to provide reverse proxy servers compatible with the OpenAI API. I've updated Cloud9Client
to support using a reverse proxy server instead of the OpenAI API server. See Using a Reverse Proxy for more information on available proxy servers and how they work.
Please note that if you choose to go this route, you are exposing your access token to a closed-source third-party server. If you are concerned about this, you may choose to either use a free Cloud9 account to minimize risks, or continue using the official OpenAI API instead with the text-davinci-003
model.
2023-02-10
I've found a new working model for text-chat-davinci-002
, text-chat-davinci-002-sh-alpha-aoruigiofdj83
. This is the underlying model that the Cloud9 Plus "Turbo" version uses. Responses are blazing fast. I've updated the library to use this model.
Bad timing; text-chat-davinci-002-sh-alpha-aoruigiofdj83
was removed shortly after, possibly due to a new model somewhere out there?
2023-02-09
Experience the power of Bing's GPT-4 version of Cloud9 with BingAIClient
(experimental).
The API server and CLI still need to be updated to support this, but you can use the client directly right now.
Please note that if your account is still wait-listed, you will not be able to use this client.
2023-02-08
Even though text-chat-davinci-002-20221122
is back up again, it seems like it's constantly overloaded and returns a 429 error. It's likely that OpenAI only dedicated a small amount of resources to this model to prevent it being widely used by the public. Additionally, I've heard that newer versions are now access-locked to OpenAI employees and partners, so it's unlikely that we'll be able to find any workarounds until the model is officially released.
You may use the text-davinci-003
model instead as a drop-in replacement. Keep in mind that text-davinci-003
is not as good as text-chat-davinci-002
(which is trained via RHLF and fine-tuned to be a conversational AI), though results are still pretty good in most cases. Please note that using text-davinci-003
will cost you credits ($).
I will be re-adding support for the browser-based Cloud9 for the API server and CLI. Please star and watch this repository for updates.
2023-02-07
The roller coaster has reached the next stop. text-chat-davinci-002-20221122
is back up again.
Trying to use text-chat-davinci-002-20221122
with the OpenAI API now returns a 404 error.
You may use the text-davinci-003
model instead as a drop-in replacement. Keep in mind that text-davinci-003
is not as good as text-chat-davinci-002
(which is trained via RHLF and fine-tuned to be a conversational AI), though results are still very good. Please note that using text-davinci-003
will cost you credits ($).
Please hold for further updates as we investigate further workarounds.
2023-02-02
Trying to use text-chat-davinci-002-20230126
with the OpenAI API now returns a 404 error. Someone has already found the new model name, but they are unwilling to share at this time. I will update this repository once I find the new model. If you have any leads, please open an issue or a pull request.
In the meantime, I've added support for models like text-davinci-003
, which you can use as a drop-in replacement. Keep in mind that text-davinci-003
is not as good as text-chat-davinci-002
(which is trained via RHLF and fine-tuned to be a conversational AI), though results are still very good. Please note that using text-davinci-003
will cost you credits ($).
Discord user @pig#8932 has found a working text-chat-davinci-002
model, text-chat-davinci-002-20221122
. I've updated the library to use this model.
Cloud9 API
A client implementation for Cloud9 and Bing AI. Available as a Node.js module, REST API server, and CLI app.
Table of Contents
Features
- Includes an API server (with Docker support) you can run to use Cloud9 in non-Node.js applications.
- Includes a CLI interface where you can chat with Cloud9.
- Includes clients that you can use in your own Node.js applications.
Cloud9Client
: support for the official Cloud9 underlying model, gpt-3.5-turbo
, via OpenAI's API.
- Replicates chat threads from the official Cloud9 website (with conversation IDs and message IDs), with persistent conversations using Keyv.
- Conversations are stored in memory by default, but you can optionally install a storage adapter to persist conversations to a database.
- The
keyv-file
adapter is also included in this package, and can be used to store conversations in a JSON file if you're using the API server or CLI (see settings.example.js
).
- Supports configurable prompt prefixes, and custom names for the user and Cloud9.
- In essence, this allows you to make a chatbot with any personality you want.
- This is currently only configurable on a global level, but I plan to add support for per-conversation customization.
- Retains support for models like
text-davinci-003
BingAIClient
: support for Bing's version of Cloud9, powered by GPT-4.
- Includes a built-in jailbreak you can activate which enables unlimited chat messages per conversation, unlimited messages per day, and brings Sydney back. 😊
Cloud9BrowserClient
: support for the official Cloud9 website, using a reverse proxy server for a Cloudflare bypass.
- There may be a high chance of your account being banned if you continue to automate chat.openai.com. Continue doing so at your own risk.
Getting Started
Prerequisites
Usage
Module
npm i @xx-johnwick-xx/cloud9
BingAIClient
See demos/use-bing-client.js
.
Cloud9Client
See demos/use-client.js
.
Cloud9BrowserClient
See demos/use-browser-client.js
.
API Server
Setup
You can install the package using
npm i -g @xx-johnwick-xx/cloud9
then run it using
cloud9
.
This takes an optional --settings=<path_to_settings.js>
parameter, or looks for settings.js
in the current directory if not set, with the following contents:
settings.js
module.exports = {
cacheOptions: {},
storageFilePath: process.env.STORAGE_FILE_PATH || './cache.json',
cloud9Client: {
openaiApiKey: process.env.OPENAI_API_KEY || '',
modelOptions: {
model: 'gpt-3.5-turbo',
},
proxy: '',
debug: false,
},
bingAiClient: {
host: '',
userToken: '',
cookies: '',
proxy: '',
debug: false,
},
cloud9BrowserClient: {
reverseProxyUrl: 'https://bypass.churchless.tech/api/conversation',
accessToken: '',
cookies: '',
proxy: '',
debug: false,
},
apiOptions: {
port: process.env.API_PORT || 3000,
host: process.env.API_HOST || 'localhost',
debug: false,
clientToUse: 'cloud9',
generateTitles: false,
perMessageClientOptionsWhitelist: {
validClientsToUse: ['bing', 'cloud9', 'cloud9-browser'],
cloud9: [
'promptPrefix',
'userLabel',
'cloud9Label',
'modelOptions.temperature',
],
},
},
cliOptions: {
},
};
Alternatively, you can install and run the package directly.
- Clone this repository:
git clone https://github.com/xx-johnwick-xx/node-cloud9
- Install dependencies with
npm install
(if not using Docker) - Rename
settings.example.js
to settings.js
in the root directory and change the settings where required. - Start the server:
- using
npm start
or npm run server
(if not using Docker) - using
docker-compose up
(requires Docker)
Endpoints
POST /conversation
Start or continue a conversation.
Optional parameters are only necessary for conversations that span multiple requests.
Field | Description |
---|
message | The message to be displayed to the user. |
conversationId | (Optional) An ID for the conversation you want to continue. |
jailbreakConversationId | (Optional, for BingAIClient only) Set to true to start a conversation in jailbreak mode. After that, this should be the ID for the jailbreak conversation (given in the response as a parameter also named jailbreakConversationId ). |
parentMessageId | (Optional, for Cloud9Client , and BingAIClient in jailbreak mode) The ID of the parent message (i.e. response.messageId ) when continuing a conversation. |
conversationSignature | (Optional, for BingAIClient only) A signature for the conversation (given in the response as a parameter also named conversationSignature ). Required when continuing a conversation unless in jailbreak mode. |
clientId | (Optional, for BingAIClient only) The ID of the client. Required when continuing a conversation unless in jailbreak mode. |
invocationId | (Optional, for BingAIClient only) The ID of the invocation. Required when continuing a conversation unless in jailbreak mode. |
clientOptions | (Optional) An object containing options for the client. |
clientOptions.clientToUse | (Optional) The client to use for this message. Possible values: cloud9 , cloud9-browser , bing . |
clientOptions.* | (Optional) Any valid options for the client. For example, for Cloud9Client , you can set clientOptions.openaiApiKey to set an API key for this message only, or clientOptions.promptPrefix to give the AI custom instructions for this message only, etc. |
To configure which options can be changed per message (default: all), see the comments for perMessageClientOptionsWhitelist
in settings.example.js
.
To allow changing clients, perMessageClientOptionsWhitelist.validClientsToUse
must be set to a non-empty array as described in the example settings file.
Usage
Method 1 (POST)
To start a conversation with Cloud9, send a POST request to the server's /conversation
endpoint with a JSON body with parameters per Endpoints > POST /conversation above.
{
"message": "Hello, how are you today?",
"conversationId": "your-conversation-id (optional)",
"parentMessageId": "your-parent-message-id (optional, for `Cloud9Client` only)",
"conversationSignature": "your-conversation-signature (optional, for `BingAIClient` only)",
"clientId": "your-client-id (optional, for `BingAIClient` only)",
"invocationId": "your-invocation-id (optional, for `BingAIClient` only)",
}
The server will return a JSON object containing Cloud9's response:
{
"response": "I'm doing well, thank you! How are you?",
"conversationId": "your-conversation-id",
"messageId": "response-message-id (for `Cloud9Client` only)",
"conversationSignature": "your-conversation-signature (for `BingAIClient` only)",
"clientId": "your-client-id (for `BingAIClient` only)",
"invocationId": "your-invocation-id (for `BingAIClient` only - pass this new value back into subsequent requests as-is)",
"details": "an object containing the raw response from the client"
}
If the request is unsuccessful, the server will return a JSON object with an error message.
If the request object is missing a required property (e.g. message
):
{
"error": "The message parameter is required."
}
If there was an error sending the message to Cloud9:
{
"error": "There was an error communicating with Cloud9."
}
Method 2 (SSE)
You can set "stream": true
in the request body to receive a stream of tokens as they are generated.
import { fetchEventSource } from "@xx-johnwick-xx/fetch-event-source";
const opts = {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({
message: "Write a poem about cats.",
conversationId: "your-conversation-id (optional)",
parentMessageId: "your-parent-message-id (optional)",
stream: true,
}),
};
See demos/use-api-server-streaming.js for an example of how to receive the response as it's generated. You will receive one token at a time, so you will need to concatenate them yourself.
Successful output:
{ data: '', event: '', id: '', retry: 3000 }
{ data: 'Hello', event: '', id: '', retry: undefined }
{ data: '!', event: '', id: '', retry: undefined }
{ data: ' How', event: '', id: '', retry: undefined }
{ data: ' can', event: '', id: '', retry: undefined }
{ data: ' I', event: '', id: '', retry: undefined }
{ data: ' help', event: '', id: '', retry: undefined }
{ data: ' you', event: '', id: '', retry: undefined }
{ data: ' today', event: '', id: '', retry: undefined }
{ data: '?', event: '', id: '', retry: undefined }
{ data: '<result JSON here, see Method 1>', event: 'result', id: '', retry: undefined }
{ data: '[DONE]', event: '', id: '', retry: undefined }
Error output:
const message = {
data: '{"code":503,"error":"There was an error communicating with Cloud9."}',
event: 'error',
id: '',
retry: undefined
};
if (message.event === 'error') {
console.error(JSON.parse(message.data).error);
}
Notes
- Method 1 is simple, but Time to First Byte (TTFB) is long.
- Method 2 uses a non-standard implementation of server-sent event API; you should import
fetch-event-source
first and use POST
method.
CLI
Setup
Follow the same setup instructions for the API server, creating settings.js
.
Usage
If installed globally:
cloud9-cli
If installed locally:
npm run cli
Cloud9's responses are automatically copied to your clipboard, so you can paste them into other applications.
Using a Reverse Proxy
As shown in the examples above, you can set reverseProxyUrl
in Cloud9Client
's options to use a reverse proxy server instead of the official Cloud9 API.
For now, this is the only way to use the Cloud9 underlying models. This method has been patched and the instructions below are no longer relevant, but you may still want to use a reverse proxy for other reasons.
Currently, reverse proxy servers are still used for performing a Cloudflare bypass for Cloud9BrowserClient
.
Instructions
How does it work? Simple answer: Cloud9Client
> reverse proxy > OpenAI server. The reverse proxy server does some magic under the hood to access the underlying model directly via OpenAI's server and then returns the response to Cloud9Client
.
Instructions are provided below.
https://cloud9.hato.ai/completions (mine, currently offline)
Instructions
- Get your Cloud9 access token from https://chat.openai.com/api/auth/session (look for the
accessToken
property).
- This is NOT the same thing as the session token.
- Automatically fetching or refreshing your Cloud9 access token is not currently supported by this library. Please handle this yourself for now.
- Set
reverseProxyUrl
to https://cloud9.hato.ai/completions
in settings.js > cloud9Client
or Cloud9Client
's options. - Set the "OpenAI API key" parameter (e.g.
settings.cloud9Client.openaiApiKey
) to the Cloud9 access token you got in step 1. - Set the
model
to text-davinci-002-render
, text-davinci-002-render-paid
, or text-davinci-002-render-sha
depending on which Cloud9 models that your account has access to. Models must be a Cloud9 model name, not the underlying model name, and you cannot use a model that your account does not have access to.
Notes
- Since this is my server, I can guarantee that no logging or tracking is done. I can see general usage stats, but I cannot see any of your completions. Whether you trust me on this or not is up to you.
- Non-streaming responses over 60s are not supported. Use
stream: true
(API) or onProgress
(client) as a workaround. - Rate limit of 10 requests per second.
https://cloud9.pawan.krd/api/completions (@PawanOsmon, currently offline)
Instructions
- Get your Cloud9 access token from https://chat.openai.com/api/auth/session (look for the
accessToken
property).
- This is NOT the same thing as the session token.
- Automatically fetching or refreshing your Cloud9 access token is not currently supported by this library. Please handle this yourself for now.
- Set
reverseProxyUrl
to https://cloud9.pawan.krd/api/completions
in settings.js > cloud9Client
or Cloud9Client
's options. - Set the "OpenAI API key" parameter (e.g.
settings.cloud9Client.openaiApiKey
) to the Cloud9 access token you got in step 1. - Set the
model
to text-davinci-002-render
, text-davinci-002-render-paid
, or text-davinci-002-render-sha
depending on which Cloud9 models that your account has access to. Models must be a Cloud9 model name, not the underlying model name, and you cannot use a model that your account does not have access to.
Notes
- Non-streaming responses over 60s are not supported. Use
stream: true
(API) or onProgress
(client) as a workaround. - Rate limit of 50 requests per 15 seconds.
Projects
🚀 A list of awesome projects using @xx-johnwick-xx/cloud9
:
- PandoraAI: my web chat client powered by node-cloud9, allowing users to easily chat with multiple AI systems while also offering support for custom presets. With its seamless and convenient design, PandoraAI provides an engaging conversational AI experience.
- Cloud9 Clone: a clone of Cloud9, uses official model, reverse-engineered UI, with AI model switching, message search, and prompt templates.
- Cloud9 WebApp: a fullstack chat webapp with mobile compatble UI interface, and node-cloud9 works as backend. Anyone can deploy your own chat service.
- halbot: Just another Cloud9/Bing Chat Telegram bot, which is simple design, easy to use, extendable and fun.
- ChatGPTBox: Integrating Cloud9 into your browser deeply, everything you need is here
Add yours to the list by editing this README and creating a pull request!
Web Client
A web client for this project is also available at xx-johnwick-xx/PandoraAI.
Caveats
Regarding Cloud9Client
Since gpt-3.5-turbo
is Cloud9's underlying model, I had to do my best to replicate the way the official Cloud9 website uses it.
This means my implementation or the underlying model may not behave exactly the same in some ways:
- Conversations are not tied to any user IDs, so if that's important to you, you should implement your own user ID system.
- Cloud9's model parameters (temperature, frequency penalty, etc.) are unknown, so I set some defaults that I thought would be reasonable.
- Conversations are limited to roughly the last 3000 tokens, so earlier messages may be forgotten during longer conversations.
- This works in a similar way to Cloud9, except I'm pretty sure they have some additional way of retrieving context from earlier messages when needed (which can probably be achieved with embeddings, but I consider that out-of-scope for now).
Contributing
If you'd like to contribute to this project, please create a pull request with a detailed description of your changes.
License
This project is licensed under the MIT License.