Skip to content

Lightweight Java library for OpenAI's ChatGPT using the reverse-engineered API.

Notifications You must be signed in to change notification settings

rice668/chatgpt-java

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ChatGPT-Java

A Java wrapper for the unofficial reverse-engineered ChatGPT API.

Important Update

OpenAI have recently implemented Cloudflare's Under Attack mode on ChatGPT, meaning you will need to supply a valid cf_clearance cookie and user agent to use the API.

This may be temporary, however we do not know at the moment.

Refer to the Registering ChatGPT section for more information on how to set these values.

Add ChatGPT-Java to your own build

Maven

<repository>
  <id>chatgpt-java</id>
  <url>https://raw.github.com/AcaiSoftware/chatgpt-java/repository/</url>
</repository>

<dependency>
  <groupId>gg.acai</groupId>
  <artifactId>chatgpt-java</artifactId>
  <version>1.0.2</version>
</dependency>

Usage Examples

Registering ChatGPT

All builder fields are optional except for sessionToken.

ChatGPT chatGpt = ChatGPT.newBuilder()
  .sessionToken("token_here") // required field: get from cookies
  .cfClearance("cf_clearance_here") // required to bypass Cloudflare: get from cookies
  .userAgent("user_agent_here") // required to bypass Cloudflare: google 'what is my user agent'
  .addExceptionAttribute(new ParsedExceptionEntry("exception keyword", Exception.class)) // optional: adds an exception attribute
  .connectTimeout(60L) // optional: specify custom connection timeout limit
  .readTimeout(30L) // optional: specify custom read timeout limit
  .writeTimeout(30L) // optional: specify custom write timeout limit
  .build(); // builds the ChatGPT client

Session Token

Not required, the ChatGPT client checks & verifies the session token upon the build procedure. The client will throw a TokenExpiredException if the token has expired.

 chatGpt.getComplexAccessCache().refreshAccessToken() // refreshing cache and verifies session token
    .whenComplete((accessToken) -> { // called when the promise is completed, not required
        System.out.println("Access token: " + accessToken);
    });

ChatGPT Conversation

Supports both asynchronous & synchronous handling.

Create a conversation with a promise completing the response:

Conversation conversation = chatGpt.createConversation();
conversation.sendMessageAsync("Hello!")
    .whenComplete((response) -> { // called when the promise is completed with its response
        System.out.println("Response: " + response.getMessage());
    });

Create a conversation with an event stream listener:

Conversation streamConversation = chatGpt.createStreamConversation(new StreamResponseListener() {
    @Override
    public void onResponse(StreamResponse response) {
        System.out.println(response.getMessage()); // the response from the event stream
    }
});
streamConversation.sendMessageAsync("Hello!"); // does not support promise callbacks

NOTE: A Stream Conversation does not support promise callbacks with its response

Documentation

// Link to docs

Features

  • Functional Style
  • Sending messages with responses
  • Event Stream Response
  • Asynchronous & Synchronous methods
  • Token Access Cache
  • Conversations
  • Simple Builders
  • Easy to use, but powerful
  • Optimal performance

Important Notes

Because this is developed using the unofficial reverse-engineered API, be aware that it could break at any time. However, we will work to fix any issues as they may arise.

Contributing

Contributions are highly appreciated! If you feel your pull request is useful, go ahead! Before creating a pull request, make sure your changes work as they should and give a description of what it provides.

Authors

Kaiser Clouke

About

Lightweight Java library for OpenAI's ChatGPT using the reverse-engineered API.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 100.0%