gemini_ai_chat 0.0.1

A Gemini Generative AI SDK that incorporates chat functionalities while adhering to clean architecture principles.

Google - Gemini AI Chat

This package seamlessly integrates Gemini's features into your application, incorporating clean code, robust exception handling, and smooth integration with both new and existing flutter apps. Additionally, it includes a chat feature supporting voice chat, text-only chat, and image+text chat.

Example

Setup

• Prerequisite
• Initialize GeminiAI

Prerequisite

To use Gemini AI, you need to obtain the Gemini AI's API key, for that you need to sign up for a Gemini account at ai.google.dev Once you have acquired the Gemini API key, you are all set!

Initialize GeminiAI

Before using GeminiAI you have to initialize. - Make youre you add your API Key.

const apiKey = "--- Your GeminiAI Api Key --- ";

final geminiAI = GeminiAI(
  apiKey: apiKey,
);

Usage

• Generate contect from text-only input
• Generate content from text and image input
• Extra Configuration (Not Rerquired)
• Safety Settings

Voice/Text only input

You can genenerate text based content by passing the query (String) in the method. NB: This is best suited for generating context with text or voice only input as it uses the gemini-pro model

geminiAI.generateTextFromQuery("---- your Query Sytring ----")
.then((value) => print(value.text))
.catchError((e) => print(e));

Text and image input

You can genenerate text based content by passing both the query (String) and selecting an Image from your galary in the method. NB: This is only suited for generating content with text or voice only input as it uses the gemini-pro model

//Get the file you want to analyze from yur device or reference it from your asset bundle
File image = File("assets/images.png")

geminiAI.generateTextFromQueryAndImages(
  query: "---- Your Query String -----",
  image: image
)
.then((value) => print(value.text))
.catchError((e) => print(e));

Extra Configuration

The library have been developed with the average user in mind. However, if you wish to customize your responses

Adding the Custom Configuration

Example

// Generation Configuration
final config = GenerationConfig(
    temperature: 0.5, //Temperature controls the degree of randomness in token selection.
    maxOutputTokens: 100, //Token limit determines the maximum amount of text output. 100 tokens is about 60-80 words.
    topP: 1.0, //Top-p, also known as nucleus sampling, controls the cumulative probability of the generated tokens
    topK: 40, //The top-k parameter limits the model’s predictions to the top k most probable tokens at each step of generation
    stopSequences: [] //Define a stopping signal for the model using a unique character sequence to halt content generation. Opt for a sequence unlikely to be found in the generated content to avoid inadvertent interruptions.
);

Add it To The Instance

// Gemini Instance
final gemini = GoogleGemini(
    apiKey: "--- Your Gemini Api Key ---",
    config: config // this is where the config goes
);

Safety settings

To make sure responses are targeted and filtered for particular age group, tartget population or product usecase, The Safety settings can be adjusted.

Safety Categories

These are the basic categories in this plugin, you might wish to adjust according to your needs

HARM_CATEGORY_UNSPECIFIED
HARM_CATEGORY_DEROGATORY
HARM_CATEGORY_TOXICITY
HARM_CATEGORY_VIOLENCE
HARM_CATEGORY_SEXUAL
HARM_CATEGORY_MEDICAL
HARM_CATEGORY_DANGEROUS
HARM_CATEGORY_HARASSMENT
HARM_CATEGORY_HATE_SPEECH
HARM_CATEGORY_SEXUALLY_EXPLICIT
HARM_CATEGORY_DANGEROUS_CONTENT	

Safety Threshold

This regulates your safety frequency and harm probability.

HARM_BLOCK_THRESHOLD_UNSPECIFIED	
BLOCK_LOW_AND_ABOVE	
BLOCK_MEDIUM_AND_ABOVE
BLOCK_ONLY_HIGH	
BLOCK_NONE

Using it

Specify Which You Want to use

// Safety Settings
final safety1 = SafetySettings(
  category: SafetyCategory.HARM_CATEGORY_DANGEROUS_CONTENT,
  threshold: SafetyThreshold.BLOCK_ONLY_HIGH
);

**Add it to the geminiAi instance**
//  Gemini Instance
final gemini = GoogleGemini(
  apiKey:"--- Your Gemini Api Key ---",
  safetySettings: [
    safety1,
    // safety2
  ]  
);

This Plugin Was Developed By: