This Node.js module allows you to interact with the ChatGPT website (https://chat.openai.com) using Puppeteer. It enables you to send messages to ChatGPT and receive responses, as well as create conversational sessions with the ability to send multiple messages and retrieve the conversation history. Additionally, it can run as a CLI application and a REST API server.
To install the module, run the following command:
npm install pptr-gpt
# or global
npm install pptr-gpt -gYou can run the module as a CLI application. The following options are available:
Usage: pptr-gpt [options]
Options:
-s, --serve Start the server
-p, --port Set the port for the server (default: 3000)
-h, --help Display help
--no-headless Run the browser in headful modeFirst, import the required functions from the module:
const chatGpt = require('pptr-gpt');Before using the module, you need to initialize Puppeteer:
await chatGpt.init();To send a single message to ChatGPT and receive the response, use the singleMessage function:
const answer = await chatGpt.singleMessage(`Write a story about dog, software engineer, and node.js`);
console.log(answer);To create a conversational session with ChatGPT, use the createChat function:
const chat = await chatGpt.createChat("How to write a todo app on node.js?");
console.log(chat.response);The createChat function returns an object with the following properties and methods:
response(string): The initial response from ChatGPT.history(array): An array containing the conversation history, with each element representing a message exchange between the user and ChatGPT.send(function): A function that allows you to send additional messages to ChatGPT during the conversation. It returns a Promise that resolves with the response from ChatGPT.close(function): A function that closes the current chat session.
Example of sending additional messages:
const nextResponse = await chat.send("Ok. And how to write this on python?");
console.log(nextResponse);
console.log('history', chat.history);After you're done using the module, you should close the Puppeteer session:
await chatGpt.close();You can run the module as a REST API server. The following endpoints are available:
To start the server, run the following command:
pptr-gpt -s
# or with a specific port
pptr-gpt -s -p 4000The default port is 3000.
Check if the server is running.
Response:
{
"message": "pptr-gpt api running"
}Send a single message to ChatGPT.
Request Body:
{
"question": "Your question here"
}Response:
{
"answer": "ChatGPT's response here"
}Create a new chat session with ChatGPT.
Request Body:
{
"message": "Initial message for the chat session"
}Response:
{
"id": "chat-session-id",
"answer": "Initial response from ChatGPT"
}Send a message to an existing chat session.
Request Body:
{
"id": "chat-session-id",
"message": "Your message here"
}Response:
{
"answer": "ChatGPT's response here"
}Close an existing chat session.
Response:
{
"status": "ok"
}Here's a complete example that demonstrates the usage of the module:
const chatGpt = require('pptr-gpt');
const test = async () => {
await chatGpt.init();
const answer = await chatGpt.singleMessage(`Write a story about dog, software engineer, and node.js`);
console.log("---Single Message---");
console.log(answer);
console.log("--------------------");
const chat = await chatGpt.createChat("How to write a todo app on node.js?");
console.log("----Create Chat-----");
console.log(chat.response);
console.log("--------------------");
const nextResponse = await chat.send("Ok. And how to write this on python?");
console.log("----Next Response----");
console.log(nextResponse);
console.log('--------------------');
console.log('history', chat.history);
await chat.close();
await chatGpt.close();
};
test();This example demonstrates the following:
- Initializing the module.
- Sending a single message to ChatGPT and logging the response.
- Creating a chat session and logging the initial response.
- Sending an additional message during the chat session and logging the response.
- Logging the conversation history.
- Closing the chat session and Puppeteer session.
This example will show you how to interact with the pptr-gpt REST API by sending HTTP requests from a Node.js application.
- Setup the server (assuming you have already installed pptr-gpt and started the server on port 3000 as described in the previous README):
pptr-gpt -s -p 3000 --no-headless- Create a Node.js client to interact with the REST API:
const axios = require('axios');
const apiUrl = 'http://localhost:3000';
const runApiClient = async () => {
try {
// Check if the server is running
const checkResponse = await axios.get(`${apiUrl}/`);
console.log('Server response:', checkResponse.data);
// Send a single message to ChatGPT
const singleMessageResponse = await axios.post(`${apiUrl}/ask`, {
question: 'Write a story about a dog, software engineer, and Node.js.'
});
console.log('Single message response:', singleMessageResponse.data);
// Create a new chat session
const createChatResponse = await axios.post(`${apiUrl}/create-chat`, {
message: 'How to write a todo app in Node.js?'
});
const chatId = createChatResponse.data.id;
console.log('Create chat response:', createChatResponse.data);
// Send an additional message to the chat session
const sendMessageResponse = await axios.post(`${apiUrl}/chat/send-message`, {
id: chatId,
message: 'Ok. And how to write this in Python?'
});
console.log('Send message response:', sendMessageResponse.data);
// Close the chat session
const closeChatResponse = await axios.get(`${apiUrl}/chat/${chatId}/close`);
console.log('Close chat response:', closeChatResponse.data);
} catch (error) {
console.error('Error:', error.response ? error.response.data : error.message);
}
};
runApiClient();This project is licensed under the MIT License - see the LICENSE file for details.