Skip to content

Repository files navigation

🧠 Tani V2 – Local AI Desktop Assistant

Tani V2 is an intelligent, voice-activated virtual assistant built in Python.
It combines local system automation with AI reasoning through Groq’s LLaMA 3 model.
Say "Hey Tani" to wake it — she’ll figure out whether your request needs local action or some LLM brainpower.


🧩 Features

Type Description
🎙️ Voice Recognition Detects wake word "Hey Tani" using Porcupine, listens via SpeechRecognition
🧠 NLP Intent Prediction Classifies commands using a trained model (joblib + scikit-learn)
⚙️ System Control Executes local tasks — open apps, control volume, brightness, power, and more
💬 Conversational Mode Routes general questions to Groq (LLaMA-3-8B) for reasoning and natural replies
🗣️ Text-to-Speech (TTS) Speaks responses using pyttsx3
🎵 Music Handling Auto-detects installed players (Spotify, VLC, WMP, YouTube) and plays media accordingly
🧾 Reminders & Notes Simple reminder and notepad system with threaded timers
🧮 System Diagnostics Reports battery, RAM, CPU, and storage info using psutil

🧠 System Logic Flow

graph TD;
    A[🎤 Voice Input] --> B[🗣️ Speech to Text - Whisper or SR];
    B --> C[🧠 Intent Analyzer - Trained Model];
    C --> D{⚙️ Task Router};
    D --> E[💻 System Task Executor - Local];
    D --> F[🧩 Reasoning Engine - Groq LLaMA 3];
    E --> G[🗯️ Response Synthesizer - pyttsx3];
    F --> G;

Loading

⚙️ Implemented System Commands

🔹 App & File Navigation

  • system_open_app
  • system_close_app
  • system_open_file
  • system_open_folder
  • system_open_settings
  • system_open_task_manager
  • system_open_control_panel
  • system_open_file_explorer
  • system_open_command_prompt
  • system_open_registry_editor

🔹 Audio Control

  • system_adjust_volume
  • system_mute_volume
  • system_increase_volume
  • system_decrease_volume
  • system_select_output_device

🔹 Display & Power

  • system_adjust_brightness
  • system_toggle_dark_mode
  • system_turn_off_display
  • system_toggle_night_light
  • system_shutdown
  • system_restart
  • system_sleep
  • system_hibernate
  • system_lock
  • system_sign_out

🔹 Media Control

  • system_play_media
  • system_pause_media
  • system_stop_media
  • system_skip_media
  • system_open_media_player

🔹 Notes & Reminders

  • system_create_note
  • system_create_reminder
  • system_open_calendar
  • system_schedule_task

🔹 Web & Network

  • system_open_website
  • system_search_web
  • system_toggle_wifi
  • system_toggle_bluetooth
  • system_toggle_vpn

🔹 Diagnostics

  • system_check_battery
  • system_check_storage
  • system_check_cpu_usage
  • system_check_ram_usage

🧠 LLM Integration (Groq API)

Used for reasoning / conversational queries.

from groq import Groq

client = Groq(api_key="YOUR_GROQ_API_KEY")

def UsingLLM(prompt):
    chatCompletion = client.chat.completions.create(
        messages=[{"role": "user", "content": prompt}],
        model="llama3-8b-8192",
    )
    response = chatCompletion.choices[0].message.content
    print(f"LLM Response: {response}")

About

This was a personal project of mine, its a very simple Voice Assistant built for use with pc and the name is a homage to a friend of mine.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors