Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/arpitaswal/voice-genie


https://github.com/arpitaswal/voice-genie

Last synced: 6 days ago
JSON representation

Awesome Lists containing this project

README 

        

## App Logo

Click on a logo to download the latest version of the app apk file:

  

 ![ic_launcher](https://github.com/user-attachments/assets/ae14f7dc-567c-4074-b86a-81aca50c71b0)



# Project Title: Voice Genie



Description: Voice Genie is a Flutter-based mobile application that acts as a voice-powered AI assistant, designed for quick, intuitive, and hands-free interactions. Leveraging the power of Gemini API and Imagine API, this single-screen app can respond to both text-based and art/image-based prompts, making it a unique blend of conversational AI and visual creativity. Through its streamlined interface, users can quickly send queries and receive spoken or visual responses, enhanced by intuitive speech-to-text and text-to-speech capabilities.



## Features



Text Queries: Using Gemini API with the Gemini 1.5 Flash model, Voice Genie answers user questions or prompts with insightful responses related to organization, creativity, or general information.



Art/Image Prompts: For creative visual queries, Imagine API generates relevant images or artwork, offering a unique AI art experience.



Speech-to-Text: The app converts spoken queries into text, allowing users to interact hands-free.



Text-to-Speech: Users can listen to AI responses, making information accessible and providing a conversational experience.



Animated Text Display: Responses are displayed in rounded containers with animated text, enhancing readability and engagement.



Response Options: After receiving an AI-generated response, users can choose to:



Ask another question,

Listen to the AI response from start to finish,

Clear previous interactions and reset the screen for new prompts.



Permission and Connectivity Messages: The app provides clear feedback for any permission issues (e.g., audio recording) or connectivity errors, helping users troubleshoot effortlessly.



## Installation



To run this project locally:



1. Clone the repository:

git clone https://github.com/ArpitAswal/Voice-Genie.git



2. Navigate to the project directory:

cd Voice-Genie



3. Install dependencies:

flutter pub get



4. Set up API Keys (Optional, depending on external services used):

Obtain an API key from Gemini AI Studio & Imagine API.



      Create a new file named lib/config.dart in the project directory.



      Add the following code, replacing 'YOUR_API_KEY' with your News API key:



      class Config { static const String apiKey = 'YOUR_API_KEY'; }



      Or directly used in API networking calls.



5. Run the app:

flutter run

 

## Note

. Users must grant audio record permission for the app to function, as it uses, the voice speech functionality to record the user prompt.



. ImagineAPI service sometimes is not available, and for more styling images response try different style_id parameter, for more detail visit the ImagineAPI site.



## Tech Stack



Flutter: The primary framework for building the mobile application.



Dart: The programming language used with Flutter.



Imagine API. for generating AI-driven image responses based on user prompts.



Gemini API: Gemini API for processing text-based queries and providing informative answers.



## Challenges



Speech-To-Text: Ensuring it listens to all the words/sentences of the user and performs well.



Text-To-Speech: Managing the response speech by single response or full messages responses.



## Future Enhancements



Image-Based Query Analysis: A new feature will allow users to upload images to the app. Gemini AI will then analyze the uploaded image, describing its contents to provide deeper insights or contextual explanations about the image.



Enhanced AI Art Capabilities: Future updates will improve the app’s art-based prompts with more creative or style-based responses to user queries.



## Contributing



Contributions are always welcome!



Please follow these steps:



1. Fork the repository.



2. Create a new branch (git checkout -b feature-branch).



3. Make your changes and commit them (git commit -m 'Add new feature').



4. Push the changes to your fork (git push origin feature-branch).



5. Create a pull request.



## Usage Flow



Starting the App: Voice Genie opens on a single main screen where users can immediately interact with AI by pressing the microphone button.

Providing a Query: Users can speak their questions or prompts. The app detects the type of request:



![Screenshot_2024-11-09-14-40-35-503_com google android permissioncontroller](https://github.com/user-attachments/assets/67522054-7b0e-4bba-9953-bb388fd08818)

![Screenshot_2024-11-09-14-40-42-147_com example voice_assistant](https://github.com/user-attachments/assets/0a2eadea-5009-4db2-803b-4c96996c4990)



Text-Based: The app processes queries with Gemini AI to provide textual answers.



![Screenshot_2024-11-09-14-41-21-355_com example voice_assistant](https://github.com/user-attachments/assets/e4709d3e-c49e-4740-aa28-605af21222c6)



Art/Image-Based: Imagine API is used to generate visual answers.



Displaying Results: The response, either in text or image form, appears in an animated container. Users can then: Ask a new question, Listen to the response through text-to-speech, and Refresh the app to reset for new queries.



https://github.com/user-attachments/assets/46f86248-9e8b-44fe-89d2-06d15a8808d6



https://github.com/user-attachments/assets/2e529fa7-ca4b-4f51-ac4a-e0ab7e4fc0bf



https://github.com/user-attachments/assets/f47ceed6-2ff8-480c-9d0e-a2e182bd1cd4



Handling Errors: If permissions are missing or connectivity fails, the app displays clear, specific messages to guide users in troubleshooting.



https://github.com/user-attachments/assets/3b1540d0-5d9d-4b9d-a873-6839a03898e7



https://github.com/user-attachments/assets/7086e24c-85ea-4cbe-a5fa-0ded94854adf



## Feedback



If you have any feedback, please reach out to me at [email protected] 



If you face an issue, then open an issue in a GitHub repository.



## Design Philosophy



Voice Genie is a sophisticated AI assistant designed to be an intuitive, accessible way for users to explore information and art with minimal effort. With future updates, it aims to become an even more interactive and personalized companion.