Skip to content

Latest commit

ย 

History

30 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Friday_male.V

๐Ÿค– FRIDAY โ€” Your Personal AI automation

Developed by Shubham Rathod

Python Platform Voice%20Enabled AI%20Integration Status


๐ŸŒŸ Overview

FRIDAY (Fully Responsive Intelligent Dynamic Assistant) it is a next-generation personal AI assistant

It works both through voice and text commands, understands Hindi & English, speaks naturally using text-to-speech, and can perform intelligent actions such as opening apps, searching music, generating code, retrieving information using AI, and more โ€” all in one file.

  • It can interact with you and you can also add more commands if you want๐Ÿ˜Ž

๐Ÿ’ฌ A modern, powerful assistant designed for everyday tasks โ€” locally, privately, and efficiently.


๐Ÿš€ Key Features

โœ… Dual Mode Operation โ€” Use via voice or text
โœ… Hindi + English Speech โ€” Speaks and understands both
โœ… Fast & Natural Speech โ€” 1.5x rate optimized Hindi TTS
โœ… Real-Time Command Handling โ€” Open apps, run calculations, check weather, play songs, and more
โœ… AI Integrated โ€” Connects to Gemini or OpenAI if available
โœ… Offline Safe Mode โ€” Works without internet for most commands
โœ… Voice Mode Toggle โ€” Go completely hands-free
โœ… Spotify Search โ€” โ€œPlay [song name]โ€ instantly opens in Spotify
โœ… Smart Memory โ€” Remember and recall information anytime
โœ… System Info Monitor โ€” Quick CPU and RAM report
โœ… AI Code Generator โ€” Create working Python scripts using one command
โœ… Beautiful Console UI โ€” Animated startup, colors, and effects


๐Ÿง  Capabilities

Category Examples
๐ŸŽค Voice Commands โ€œVoice modeโ€, โ€œPlay Kesariyaโ€, โ€œWhatโ€™s the weather in Delhi?โ€
โš™๏ธ System Commands ls, cd Desktop, mkdir test, sysinfo
๐Ÿงพ AI Interaction ai: who invented AI? or ask: explain machine learning
๐Ÿ’พ Memory Commands remember birthday 16 May, recall birthday, forget birthday
๐ŸŽต Music Control play Shape of You (opens in Spotify)
๐Ÿงฎ Math & Logic calc 15*7 + 30
๐Ÿ“ฐ News & Quotes news, quote, joke
๐Ÿงฐ Developer Tools createpy simple game โ†’ Generates Python code automatically

๐Ÿงฉ Technology Stack

Module Description
Python 3.8+ Core runtime
pyttsx3 Local text-to-speech engine
edge-tts Neural voice synthesis (optional)
SpeechRecognition Voice input & mic integration
spotipy Spotify API integration
deep-translator Automatic English โ†” Hindi translation
google-generativeai / openai Cloud AI models for question answering
psutil System performance monitoring
colorama Rich terminal output
requests Web API requests & Wikipedia fallback

๐Ÿ› ๏ธ Installation Guide

1๏ธโƒฃ Clone or Download Repository

git clone https://github.com/sr-exe/Friday_male.V.git
cd Friday_male.V

2๏ธโƒฃ Install Dependencies

pip install -r requirements.txt
If you prefer only offline functionality:

pip install pyttsx3 SpeechRecognition playsound requests colorama psutil deep-translator

3๏ธโƒฃ Set API Keys (Optional)

To use Gemini, OpenAI, or Spotify features, set the following environment variables:
Windows (PowerShell):

setx OPENAI_API_KEY "your_openai_key_here"
setx GEMINI_API_KEY "your_gemini_key_here"
setx SPOTIPY_CLIENT_ID "your_spotify_client_id"
setx SPOTIPY_CLIENT_SECRET "your_spotify_client_secret"
You can skip this step for offline mode.

4๏ธโƒฃ Run FRIDAY

python friday.py

Youโ€™ll see: -[Booting ... ] -[ Initializing modules ... ] -[ Welcome, Shubham. All systems are online. ] =Then FRIDAY will greet you in Hindi and start listening or accepting typed commands.


๐Ÿงญ Usage Examples

-Action Command -Open VS Code open vscode -Search Song play pasoori -System Info sysinfo -Create Folder mkdir newproject -Calculate calc (23 + 45)/2 -Ask AI ai: explain black holes -Voice Mode Type voice mode and start speaking -Text Mode Say or type text mode to switch back

๐Ÿงฐ Advanced Capabilities

๐Ÿงฉ AI Auto-Fallback: -If Gemini or OpenAI keys arenโ€™t available, FRIDAY fetches information via Wikipedia automatically.

๐ŸŽ™๏ธ Voice Recognition:

-Listens actively, interprets Hindi or English voice commands, and performs related actions.

โšก Optimized TTS Engine:

-FRIDAY speaks at 1.5x faster rate for more human-like rhythm.

๐Ÿ’พ Persistent Memory:

-Stores your reminders or facts inside small local .json files โ€” no data ever leaves your system.

๐Ÿ” Privacy & Safety

-โœ… No cloud upload unless using AI queries. -โœ… All system control and voice recognition are processed locally. -โœ… API keys are optional and stored safely in your environment variables. -โœ… No hidden logging or analytics. -โœ… 100% offline-compatible design. still working on it.

๐Ÿง‘โ€๐Ÿ’ป Project Structure

Friday_male.V
โ”‚
โ”œโ”€โ”€ friday.py                # Main executable file
โ”œโ”€โ”€ README.md                # Project documentation
โ”œโ”€โ”€ requirements.txt         # Dependencies
Screenshot 2025-10-05 183638

Updated FRIDAY V1 -->>

Screenshot 2025-10-08 115754

๐Ÿ‘จโ€๐Ÿ’ป About the Creator

----- Shubham Rathod -----

Aspiring new technologies | Student | Automation Enthusiast

๐Ÿ’ฌ โ€œI built FRIDAY to make daily computing smarter, faster, and more natural โ€” using my own AI-powered assistant.โ€


๐Ÿ“งLinkedin : ๐Ÿ˜Shubham

โญ If you like this project, donโ€™t forget to star the repository!


โš ๏ธ Note

This project is fully developed and owned by Shubham Rathod. You are free to view and use the source code for learning, but redistribution or commercial use requires the authorโ€™s permission.


๐Ÿ—ฃ๏ธ โ€œYour voice, your AI โ€” meet FRIDAY.

โ€” Developed by Shubham Rathod


ยฉ 2026 Shubham Rathod. All rights reserved.

About

An automated tool for performing tasks

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages