System Requirements Document (SRD)

Project Name: gilded-voice

1. Introduction

The gilded-voice project is a futuristic personal voice assistant tailored exclusively for Rudra, a user based in India. This assistant is designed to function as a Jarvis-style AI companion, offering a voice-first experience to manage daily routines, provide study assistance, explore technology, and enhance productivity. The system will integrate advanced AI capabilities, persistent memory, and a visually stunning interface to create a seamless and engaging user experience.

This document outlines the system requirements for the development of the gilded-voice project, ensuring all features are clearly defined and aligned with Rudra's vision.

2. System Overview

The gilded-voice assistant will be a lightweight, stable, and voice-first AI system. It will operate without the need for login or signup systems, focusing entirely on Rudra's personal use. The assistant will leverage cutting-edge AI technologies, including Google Gemini API, to provide intelligent responses and assistance.

Key features include:

• Voice activation and interaction.
• Persistent memory for storing notes, reminders, and preferences.
• Celebration notifications for special occasions.
• A glowing animated AI orb as the centerpiece of the user interface.
• A futuristic dark-themed design.

The system will be implemented using a combination of Python (FastAPI), SQLite, and modern web technologies (HTML, CSS, JavaScript).

3. Functional Requirements

• As Rudra, I should be able to activate the assistant using a microphone button.
• As Rudra, I should be able to issue voice commands and receive spoken responses.
• As Rudra, I should be able to ask study-related questions and receive clear answers.
• As Rudra, I should be able to request programming help and technology insights.
• As Rudra, I should be able to store notes, reminders, and preferences in the assistant's memory.
• As Rudra, I should be able to set reminders and receive notifications at the specified time.
• As Rudra, I should be able to save special dates like birthdays and anniversaries and receive animated celebration notifications.
• As Rudra, I should be able to ask for the current time, date, and greetings without using AI APIs.
• As Rudra, I should be able to check the weather and local time based on my location.
• As Rudra, I should be able to plan my daily routine and receive productivity advice.
• As Rudra, I should be able to issue multitasking commands like "open YouTube" or "open Google."
• As Rudra, I should see a glowing animated AI orb that visually represents the assistant's states (idle, listening, thinking, speaking).

4. User Personas

Primary User: Rudra

• Role: Sole user of the gilded-voice assistant.
• Needs:
  • A reliable and intuitive voice assistant for daily productivity and study assistance.
  • A visually appealing and futuristic interface.
  • Persistent memory for storing personal data and reminders.
  • Seamless multitasking capabilities.

5. Visuals Colors and Theme

The gilded-voice assistant will feature a unique, futuristic dark theme with the following color palette:

• Background: #0A0F1F (Deep Midnight Blue)
• Surface: #1C2238 (Charcoal Gray)
• Text: #E8EAF6 (Soft White)
• Accent: #FFD700 (Gilded Gold)
• Muted Tones: #4A5568 (Muted Slate Gray)

This palette is designed to evoke a sense of sophistication and modernity while ensuring readability and visual comfort during extended use.

6. Signature Design Concept

The gilded-voice assistant will feature a glowing animated AI orb as its signature design element.

Home Page / Landing Page Concept:

• Central Orb:

  • A glowing, animated AI orb will dominate the center of the screen.
  • Idle State: The orb will emit a slow, rhythmic glow.
  • Listening State: The orb will brighten and pulse gently.
  • Thinking State: The orb will rotate slowly, with subtle light trails.
  • Speaking State: The orb will pulse in sync with the speech synthesis.

• Interactive Animations:

  • When Rudra hovers over the microphone button, the orb will ripple outward with a golden glow.
  • When a command is processed, the orb will emit a brief, radiant burst of light.

• Background Effects:

  • A dynamic starfield will subtly move in the background, creating a sense of depth and immersion.
  • Occasional shooting stars will streak across the screen, adding a touch of wonder.

• Transitions:

  • Smooth fade-ins and slide transitions will be used for all UI elements.

This design will make the gilded-voice assistant instantly captivating and memorable.

7. Non-Functional Requirements

• The system must be lightweight and optimized for performance.
• The assistant should respond to voice commands within 1 second.
• Memory storage must persist permanently and not reset on application restart.
• The interface should be responsive and work seamlessly on desktop and mobile devices.
• Notifications should be visually distinct and non-intrusive.

8. Tech Stack

Frontend

• React for web application.
• HTML, CSS, JavaScript for styling and interactivity.

Backend

• Python with FastAPI for API development.

Database

• SQLite for persistent memory storage.

AI Models

• Google Gemini API for knowledge responses.

Voice

• Web Speech API for speech recognition.
• Speech Synthesis API for text-to-speech.

Deployment

• Docker and docker-compose for local orchestration.

9. Assumptions and Constraints

• The assistant will be used exclusively by Rudra, so no multi-user functionality is required.
• The system will operate in the Indian timezone (IST).
• Internet connectivity is required for AI API integration and weather/location services.
• The system will not include a wake word feature; activation will be via a microphone button.

10. Glossary

• AI Orb: A glowing, animated visual element representing the assistant's states.
• Persistent Memory: A database that retains user data across sessions.
• Google Gemini API: An AI API used for generating intelligent responses.
• Web Speech API: A browser-based API for speech recognition.
• Speech Synthesis API: A browser-based API for converting text to speech.