STAR-SARA-AI-Powered-Assistant-

STAR SARA — AI Executive Assistant Platform

Smart AI Response Assistant · by STAR Technologies · Founder & CEO Ali Shehzan Punjwani

⭐ STAR SARA v3.0

Smart AI Response Assistant

![Python](https://img.shields.io/badge/Python-3.10+-blue?logo=python) ![Groq](https://img.shields.io/badge/Groq-Llama%203.3-green) ![Whisper](https://img.shields.io/badge/OpenAI-Whisper-red) ![PySide6](https://img.shields.io/badge/GUI-PySide6-orange) ![Platform](https://img.shields.io/badge/Platform-Windows-blue) ![Status](https://img.shields.io/badge/Status-Active-success) ![License](https://img.shields.io/badge/License-MIT-yellow)


📌 Overview

STAR SARA (Smart AI Response Assistant) is an intelligent desktop AI assistant developed using Python, designed to provide a natural voice-driven experience with conversational AI, long-term memory, task management, note management, and a futuristic graphical interface.

Unlike traditional chatbots, STAR SARA remembers conversations, understands spoken commands, responds naturally using AI-generated speech, and assists users with everyday productivity.

The assistant combines multiple AI technologies into one unified desktop application, creating a personalized digital companion capable of handling conversations, organizing information, and interacting through voice.


🎯 Project Goals

The primary objective of STAR SARA is to create an intelligent desktop assistant capable of:

Future versions aim to transform STAR SARA into a complete AI productivity platform with desktop automation, browser integration, cloud synchronization, and smart assistant capabilities.


✨ Key Features

🎙️ Voice Assistant


🧠 AI Intelligence

Powered by:

Capabilities include:


💾 Long-Term Memory

STAR SARA remembers information even after restarting.

Features include:


✅ Task Management

Create and manage tasks using voice.

Supports:


📝 Smart Notes

Save important information with voice commands.

Features:


🎨 Futuristic GUI

Built using PySide6

Features include:

Assistant States


🖼️ User Interface

The graphical interface includes:


🛠 Technologies Used

Programming

Artificial Intelligence

GUI

Voice Processing

Audio Processing

Environment

Multimedia


📂 Project Structure


STAR SARA/
│
├── ffmpeg/
│
├── venv/
│
├── .env
├── .gitignore
├── README.md
├── requirements.txt
│
├── star_sara_v3.py
│
├── memory.json
├── notes.json
├── tasks.json
├── user_data.json
│
├── test_mic.py
└── test.wav


📥 Installation

Step 1 – Clone Repository

git clone https://github.com/yourusername/star-sara.git

Go inside the project.

cd star-sara

Step 2 – Create Virtual Environment

Windows

python -m venv venv

Activate it

venv\Scripts\activate

Linux/macOS

python3 -m venv venv
source venv/bin/activate

Step 3 – Upgrade pip

python -m pip install --upgrade pip

Step 4 – Install Dependencies

pip install -r requirements.txt

Or install manually.

pip install PySide6 groq python-dotenv openai-whisper edge-tts pygame sounddevice soundfile numpy scipy rapidfuzz webrtcvad noisereduce

Step 5 – Install FFmpeg

Download FFmpeg and place it inside the project.


STAR SARA/
│
├── ffmpeg/
│   └── bin/
│       ├── ffmpeg.exe
│       ├── ffplay.exe
│       └── ffprobe.exe


Step 6 – Create .env File

Create a file named:


.env

Add your Groq API Key.

GROQ_API_KEY=your_api_key_here

Step 7 – Run STAR SARA

python star_sara_v3.py

On first launch STAR SARA will

STAR SARA follows a simple but intelligent workflow to provide a natural AI assistant experience.

                  User Speaks
                       │
                       ▼
              Voice Recording
                       │
                       ▼
           Audio Preprocessing
      (Noise Reduction + VAD)
                       │
                       ▼
         Whisper Speech Recognition
                       │
                       ▼
          Intent Classification
                       │
        ┌──────────────┼──────────────┐
        │              │              │
        ▼              ▼              ▼
     Memory         Tasks         Notes
        │              │              │
        └──────────────┼──────────────┘
                       ▼
             Groq Llama AI Model
                       │
                       ▼
          AI Generated Response
                       │
                       ▼
           Edge TTS Voice Output
                       │
                       ▼
                 User Hears Reply

🧠 AI Features

STAR SARA combines multiple AI technologies to create an intelligent assistant.

Speech Recognition


Conversational AI

Using Groq’s ultra-fast inference with Llama 3.3, STAR SARA can:


Voice Output

Instead of robotic text-to-speech, STAR SARA generates natural AI speech using Edge TTS, providing a more human-like interaction.


💾 Memory System

Unlike traditional chatbots, STAR SARA remembers information between sessions.

Examples:

User:

Remember that my favorite language is Python.

Later:

What is my favorite language?

STAR SARA:

Your favorite programming language is Python.

Memory is stored locally in:

memory.json

📝 Notes System

Users can quickly save information using voice.

Example:

Take a note
Buy Raspberry Pi tomorrow.

Later:

Read my notes.

All notes are stored in:

notes.json

✅ Task Manager

STAR SARA helps organize daily work.

Examples

Add task

Complete cybersecurity assignment
Show my tasks
Mark task as completed

Tasks are saved in

tasks.json

🎤 Wake Words

STAR SARA continuously listens for activation words.

Supported wake words include:

Example

Star Sara

Assistant

Yes! How can I help you today?

💬 Example Commands

General Questions

What is Artificial Intelligence?

Explain Cloud Computing.

Who created Python?

What is Cybersecurity?

Productivity

Remember my exam is tomorrow.

Take a note.

Show my notes.

Add task Complete assignment.

Show pending tasks.

Personal Assistant

What's today's date?

Tell me the time.

Who am I?

What do you remember about me?

Exit Commands

Goodbye

Shutdown

Exit

Stop Listening

📁 Data Storage

STAR SARA stores all user information locally.

File Description
user_data.json User profile and preferences
memory.json Long-term AI memory
notes.json Saved notes
tasks.json Task manager

No personal information is stored on external servers unless required by the AI service used for processing requests.


⚙ Configuration

The application uses a .env file for environment variables.

Example:

GROQ_API_KEY=your_api_key_here

Never share your API keys publicly.


📦 Python Packages

Major dependencies include:

Install everything using:

pip install -r requirements.txt

🖥 System Requirements

Minimum Requirements

Recommended

1. Microphone Not Detected

Verify your default recording device.

Run:

python test_mic.py

Ensure Windows has permission to access your microphone.


2. No Voice Output

Check that:


3. Missing Module Error

If you receive an error like:

ModuleNotFoundError

Install the missing dependency:

pip install package_name

or reinstall all packages:

pip install -r requirements.txt

4. Invalid Groq API Key

Ensure your .env file contains:

GROQ_API_KEY=your_actual_api_key

Restart the application after updating the key.


5. FFmpeg Not Found

Verify your folder structure:

STAR SARA/
│
├── ffmpeg/
│   └── bin/
│       ├── ffmpeg.exe
│       ├── ffplay.exe
│       └── ffprobe.exe

6. Whisper Model Download

The Whisper model is downloaded automatically the first time you run STAR SARA.

Subsequent launches use the cached model, so downloading happens only once.


📈 Performance

Current capabilities include:


🔒 Privacy

STAR SARA prioritizes user privacy.

Local Storage

The following data remains stored locally:

AI Requests

Only user prompts required for AI responses are sent to the configured language model provider. No additional local files are uploaded automatically.


🚀 Future Roadmap

STAR SARA is an evolving project. Planned enhancements include:

Productivity


Desktop Automation


Browser Integration


AI Enhancements


Smart Features


📊 Current Project Status

Feature Status
Voice Recognition ✅ Completed
AI Chat ✅ Completed
Long-Term Memory ✅ Completed
Notes Management ✅ Completed
Task Management ✅ Completed
Modern GUI ✅ Completed
Voice Output ✅ Completed
Wake Word Detection ✅ Completed
Audio Processing ✅ Completed
Context Awareness ✅ Completed
Browser Automation 🚧 Planned
Vision AI 🚧 Planned
Plugin System 🚧 Planned
Cloud Sync 🚧 Planned

🤝 Contributing

Contributions are welcome.

You can contribute by:

Please create an issue before submitting major changes.


⭐ Why STAR SARA?

STAR SARA is more than a voice assistant.

It is designed to become a complete intelligent desktop companion capable of assisting users in daily productivity, learning, automation, and natural AI conversations.

The project combines multiple technologies including Artificial Intelligence, Speech Recognition, Text-to-Speech, Persistent Memory, Desktop GUI Development, and Productivity Tools into one unified application.

The long-term vision is to transform STAR SARA into a modular AI platform that continuously evolves with new capabilities.


📚 Learning Outcomes

Developing STAR SARA involved practical experience with:


🏢 About STAR Technologies

STAR Technologies is a technology initiative focused on building innovative software solutions in Artificial Intelligence, Cybersecurity, Cloud Computing, and Intelligent Automation.

Our mission is to transform ideas into intelligent solutions that simplify technology and improve digital experiences.


👨‍💻 Developer

Ali Shehzan Punjwani

Founder & CEO — STAR Technologies

**Computer Science Student AI Developer Python Developer Cybersecurity Enthusiast Cloud Security Learner**

Areas of Interest


🙏 Acknowledgements

Special thanks to the open-source community and the developers behind:

Their incredible work made this project possible.


📜 License

This project is licensed under the MIT License.

Feel free to use, modify, and distribute this project in accordance with the license terms.


⭐ Support

If you found this project helpful:

Your support helps improve STAR SARA for everyone.


### ⭐ STAR SARA v3.0 **Smart AI Response Assistant** Built with ❤️ using Python, Artificial Intelligence, and Modern Desktop Technologies. **Developed by Ali Shehzan Punjwani** © 2026 STAR Technologies. All Rights Reserved.

A realtime, browser-native voice assistant: a Jarvis-style holographic operations dashboard on top of a streaming speech pipeline. Replaces the PySide6 desktop build (v3.0) with a Next.js + FastAPI product — the old app is preserved under legacy/.


Architecture

Browser mic ──AudioWorklet PCM16/16 kHz──▶ WebSocket ─┐
                                                      ▼
                                        Silero VAD (WebRTC fallback)
                                                      ▼
                                        Wake word (openWakeWord / Porcupine
                                          / fuzzy transcript fallback)
                                                      ▼
                                        faster-whisper (GPU → int8 CPU)
                                                      ▼
                                        Groq Llama 3.3 70B — token streaming
                                              │ tokens          │ sentences
                                              ▼                 ▼
                                     WebSocket to UI     streaming Edge TTS
                                                                ▼
                                                    mp3 chunks ──▶ browser playback

Nothing in the chain waits for the stage before it to finish: the first TTS sentence is synthesized while Groq is still generating, and Whisper starts the moment VAD sees trailing silence rather than after a fixed recording window.

Stage Target How it is achieved
Wake word < 500 ms frame-level detector, no transcription in the hot path
Speech recognition < 2 s base.en/small.en CTranslate2, int8 CPU or fp16 GPU, greedy decode in fast mode
First AI token < 1 s Groq streaming API, intents answered locally with zero network hops
Voice start < 2 s sentence-level TTS streaming, playback begins on chunk one

Measured latency for every turn is streamed back as a metrics event and shown live in the AI Engine card.

Features

Quick start

# 1. Backend
cd backend
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
cp .env.example .env          # add your GROQ_API_KEY
.venv/bin/python scripts/download_models.py   # optional: wake-word models
.venv/bin/uvicorn app.main:app --reload --port 8000

# 2. Frontend
cd frontend
npm install
cp .env.example .env.local    # points at http://localhost:8000
npm run dev                   # http://localhost:3000

Click Activate microphone, allow access, then say “STAR SARA, explain AWS IAM”. Text chat works without a microphone.

Configuration

Backend (backend/.env):

Variable Default Purpose
GROQ_API_KEY — required for the LLM; without it the UI still runs and says the brain is offline
GROQ_MODEL llama-3.3-70b-versatile Groq model id
ACCURACY_MODE fast fast / balanced / accurate
WHISPER_DEVICE auto auto / cuda / cpu
WHISPER_COMPUTE_TYPE auto float16 on GPU, int8 on CPU
TTS_VOICE en-US-AriaNeural Edge TTS voice
WAKE_WORDS ["star sara","sara"] JSON list
PORCUPINE_ACCESS_KEY — enables the Porcupine wake engine
OPENWAKEWORD_MODEL_PATH — path to a custom trained “STAR SARA” model
FOLLOWUP_WINDOW_SECONDS 12 wake-word-free follow-up window

Frontend (frontend/.env.local): NEXT_PUBLIC_API_BASE=http://localhost:8000.

Wake word accuracy

openWakeWord ships no “STAR SARA” model, so the acoustic engine is only used when you point OPENWAKEWORD_MODEL_PATH at a custom model (or set OPENWAKEWORD_USE_BUNDLED=1 to trial the bundled phrases). Otherwise wake detection falls back to fuzzy-matching the transcript, which is accurate but adds one transcription of latency. Training a custom model takes minutes with the openWakeWord notebook and is the single biggest wake-latency win.

API

Method Path Purpose
GET /health liveness
GET /api/status assistant, owner, engine and counts
GET /api/system CPU / RAM / battery / network
GET,POST /api/memories list, create
DELETE /api/memories/{key} forget
GET,POST /api/tasks list, create
POST /api/tasks/{id}/complete complete
GET,POST /api/notes list, create
POST /api/conversation/reset clear short-term history
WS /ws/voice binary PCM16 in, JSON events out

Tests

cd backend && .venv/bin/python -m pytest       # VAD, wake word, intents, turn loop, API
cd frontend && npm run lint && npx tsc --noEmit && npm run build