Home

Awesome

Gemini Cover

<p align="center"> <a href="https://opensource.org/licenses/Apache-2.0"><img alt="License" src="https://img.shields.io/badge/License-Apache%202.0-blue.svg"/></a> <a href="https://android-arsenal.com/api?level=21"><img alt="API" src="https://img.shields.io/badge/API-21%2B-brightgreen.svg?style=flat"/></a> <a href="https://github.com/skydoves/gemini-android/actions/workflows/android.yml"><img alt="Build Status" src="https://github.com/skydoves/gemini-android/actions/workflows/android.yml/badge.svg"/></a> <a href="https://github.com/skydoves"><img alt="Profile" src="https://skydoves.github.io/badges/skydoves.svg"/></a> </p>

Gemini Android demonstrates Google's Generative AI on Android with Stream Chat SDK for Compose.

The purpose of this repository is to demonstrate below:

📷 Previews

<p align="center"> <img src="previews/preview0.png" alt="drawing" width="270px" /> <img src="previews/preview1.png" alt="drawing" width="270px" /> <img src="previews/preview2.gif" alt="drawing" width="269px" /></br> </p>

✍️ Technical Content

If you're interested in the overall architecture, each layer, Generative AI, Gemini SDK, and implementation details of this project, check out the following blog post: Build an AI Chat Android App With Google’s Generative AI

<a href="https://getstream.io/chat/sdk/compose?utm_source=Github&utm_medium=Jaewoong_OSS&utm_content=Developer&utm_campaign=Github_Dec2024_Jaewoong_Gemini&utm_term=DevRelOs"> <img src="https://user-images.githubusercontent.com/24237865/138428440-b92e5fb7-89f8-41aa-96b1-71a5486c5849.png" align="right" width="12%"/> </a>

🛥 Stream Chat & Video SDK

Gemini Android is built with Stream Chat SDK for Compose to implement messaging systems. If you’re interested in building powerful real-time video/audio calling, audio room, and livestreaming, check out the Stream Video SDK for Compose!

Stream Chat

Stream Video

💻 How to build the project?

To build this project properly, you should follow the instructions below:

  1. Go to the Stream login page.
  2. If you have your GitHub account, click the SIGN UP WITH GITHUB button and you can sign up within a couple of seconds.

stream

  1. If you don't have a GitHub account, fill in the inputs and click the START FREE TRIAL button.
  2. 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.
<img width="44%" src = "figures/stream2.png">
  1. You will see the Key like the image 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 image 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:

<img width="48%" src = "figures/stream6.png">
  1. Go to Google AI Studio, login with your Google account and select the Get API key on the menu left like the image below:

gemini

  1. Create your API key for using generative AI SDKs, and you'll get one like the image below:

gemini

  1. Add the key to the secrets.properties file like the below:

gemini

GEMINI_API_KEY=..
  1. Build and run the project.

🛠 Tech Stack & Open Source Libraries

🏛️ Architecture

Gemini Android follows the Google's official architecture guidance.

architecture

Gemini Android was built with Guide to app architecture, so it would be a great sample to show how the architecture works in real-world projects.<br>

The overall architecture is composed of two layers; UI Layer and the data layer. Each layer has dedicated components and they each have different responsibilities. The arrow means the component has a dependency on the target component following its direction.

Architecture Overview

layer

Each layer has different responsibilities below. Basically, they follow unidirectional event/data flow.

UI Layer

layer

The UI Layer consists of UI elements like buttons, menus, tabs that could interact with users and ViewModel that holds app states and restores data when configuration changes.

Data Layer

layer

The data Layer consists of repositories, which include business logic, such as querying data from the local database and requesting remote data from the network. It is implemented as an offline-first source of business logic and follows the single source of truth principle.<br>

For more information about the overall architecture, check out Build a Real-Time WhatsApp Clone With Jetpack Compose.

Modularization

02

Gemini Android has implemented the following modularization strategies:

💯 MAD Score

summary

🤝 Contribution

Most of the features are not completed except the chat feature, so anyone can contribute and improve this project following the Contributing Guideline.

Find this repository useful? 💙

Support it by joining stargazers for this repository. :star: <br> Also, follow me on GitHub for my next creations! 🤩

License

Designed and developed by 2024 skydoves (Jaewoong Eum)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.