chatgpt-android is a free, open source ai interaction & interfaces project written in Kotlin and released under Apache-2.0. It has 3,869 GitHub stars, 447 forks and 27 open issues, and was last pushed 9 months ago. On this registry it ranks #60 of 113 tracked projects in AI Interaction & Interfaces, with 5 head-to-head comparisons available.

cover

License API Build Status Profile Profile

ChatGPT Android demonstrates OpenAI's ChatGPT on Android with Stream Chat SDK for Compose.

The primary objective of this repository is to showcase the following:

  • Demonstrating OpenAI's chat APIs.
  • Creating comprehensive UI elements utilizing Jetpack Compose.
  • Incorporating Android architecture components using Jetpack libraries such as Hilt and AppStartup.
  • Executing background tasks efficiently through Kotlin Coroutines and WorkManager.
  • Seamlessly integrating chat systems via the Stream Chat SDK for Compose to facilitate real-time event handling.

πŸ“· Previews


πŸ›₯ Stream Chat & Video SDKs

ChatGPT Android is built with Stream Chat SDK for Compose to implement messaging systems. If you’re interested in adding powerful In-App Messaging or real-time Video Chat to your app, check out the Android Chat Messaging Tutorial or Android Video Call Tutorial !

If you're interested in building a real-time meeting room with video/audio calling, audio room, or livestreaming, check out the references below:

πŸ’» How to build the project?

For proper project setup, it's essential to follow the instructions below. In most cases, you can complete all configuration steps within 10 to 20 minutes:

  1. Go to the Stream login page.

  2. If you have your GitHub or Google account, click the Continue with GitHub or Continue with Google button and you can sign up within a couple of seconds.

stream

  1. Go to the Dashboard and click the Create App button like the below.

stream

  1. Fill in the blanks like the below and click the Create App button.

stream

  1. You will see the Key like the figure below and then copy it.

stream

  1. Create a new file named secrets.properties on the root directory of this Android project, and add the key to the secrets.properties file like the below:

stream

STREAM_API_KEY=..
  1. Go to your Dashboard again and click your App.

  2. In the Overview menu, you can find the Authentication category by scrolling to the middle of the page.

  3. Switch on the Disable Auth Checks option and click the Submit button like the figure below.

stream

  1. Click the Explorer tab on the left side menu.

  2. Click users -> Create New User button sequentially and add fill in the user like the below:

stream

  • User Name: Chat GPT
  • User ID: 70ef052a-da88-4451-af92-99f7ed335a71
  1. Now, it's time to set up the OpenAI API key. Go to OpenAI API Dashboard, login with your Google account and click Start verification to verify your phone number to create an API key.

stream

  1. After verifying your phone number, click the Create new secret key on the page like the image below and create your API key:

stream

  1. Copy and paste your API key to the secrets.properties file as named GPT_API_KEY under the STREAM_API_KEY field:

stream

GPT_API_KEY=..
  1. Unlock Rate limits for OpenAI APIs

As per the guidelines outlined in their Rate limits documentation, access to the free tier of the API is granted after a minimum expenditure of $5 since the creation of your account. That means, you should register your payment method to the OpenAI and purchase initial credits.

stream

So you should go to the OpenAI Billings and click the Add payment details button like the image below:

stream

  1. Once you've added your payment deatils, you'll able to see the Add to creadit balance button like the image below:

stream

Next, click the Add to credit balance button to purchase the initial credit. As you've discovered in the previous step, the minimum credit starts from $5. Therefore, if you only intend to utilize the API limits for testing or building a side project, you can opt for the minimum pricing. Also, not that it's advisable to disable the automatic recharge option to avoid unexpected charges.

stream

  1. Once you've completed all those steps above, now build, run and enjoy your the project!

βš™οΈ Troubleshooting

You can typically find the reasons behind your error code by referring to the OpenAI Error code documentation.

401 Error

If you encounter 401 errors while chatting with ChatGPT app, as shown in the image below, it's crucial to verify the correctness of your OpenAI API key. Ensure that there are no typos in your API key and that it has been correctly copied and pasted into the secrets.properties file, as outlined in the guidelines above.

stream

429 Error

If you encounter this error from the outset, it's likely that your rate limits do not meet the requirements. Please revisit step 16 in the guidelines above for further instructions.

πŸ›  Tech Stack & Open Source Libraries

readme truncated β€” read the full docs on github

Frequently asked questions

Is chatgpt-android free to use?

chatgpt-android is open source under the Apache-2.0 licence. There is no licence fee and no seat count β€” you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does chatgpt-android do?

πŸ“² ChatGPT Android demonstrates a Chatbot application using OpenAI's chat API on Android with Stream Chat SDK for Compose.

What is chatgpt-android written in?

chatgpt-android is primarily written in Kotlin. Its source is publicly available at https://github.com/skydoves/chatgpt-android, and it has 3,869 GitHub stars.