System Requirements Document (SRD)

Silent-Agent

1. Introduction

The Silent-Agent project is an advanced AI study companion designed specifically for engineering students across Karnataka, India, including those under the VTU curriculum. Its primary goal is to simplify learning, provide structured explanations, and assist students in mastering their subjects while preparing effectively for exams.

This document outlines the system requirements for the Silent-Agent project, ensuring it meets the needs of its target audience and delivers a seamless, impactful learning experience.

2. System Overview

Silent-Agent is envisioned as a multi-functional AI-powered platform tailored to engineering students. It will provide:

• Subject-wise explanations: Covering core and foundational engineering subjects.
• Exam preparation tools: Predicting likely exam questions based on past patterns.
• Personalized learning: Adjusting explanations based on the student's proficiency level.
• Interactive study aids: Including quizzes, notes, and progress tracking.

The system will leverage cutting-edge AI technologies to deliver clear, step-by-step explanations, generate practice questions, and create personalized study plans.

3. Functional Requirements

• As a Student, I should be able to select my engineering stream and semester to access relevant subjects and topics.
• As a Student, I should be able to view detailed explanations of topics with examples and step-by-step breakdowns.
• As a Student, I should be able to generate short notes, key formulas, and important concepts for quick revision.
• As a Student, I should be able to access predicted exam questions based on past paper patterns.
• As a Student, I should be able to take quizzes and mock exams to test my understanding.
• As a Student, I should be able to track my progress and receive recommendations for improvement.
• As an Admin, I should be able to update the syllabus and past paper data for accurate predictions.
• As an Admin, I should be able to monitor system performance and user feedback.

4. User Personas

1. Student

• Description: Engineering students across Karnataka, India, including VTU and other state universities.
• Needs: Clear explanations, exam preparation tools, personalized study plans, and progress tracking.
• Skill Levels: Beginner, Intermediate, Advanced.

2. Admin

• Description: System administrators responsible for maintaining the platform and updating data.
• Needs: Tools to manage syllabus content, monitor system performance, and address user feedback.

5. Visuals Colors and Theme

Unique Color Palette for Silent-Agent:

• Primary: #004AAD (Deep Indigo Blue) – Represents trust, intelligence, and professionalism.
• Primary Light: #5A8FD6 (Light Sky Blue) – For hover states and secondary UI elements.
• Secondary: #FF6F61 (Coral Red) – For headlines, links, and emphasis.
• Accent: #FFD700 (Golden Yellow) – Vibrant pop color for CTAs and badges.
• Highlight: #FFA500 (Amber Orange) – Warm color for hover states and notifications.
• Background (bg): #F4F4F9 (Soft White) – Clean and neutral background.
• Surface: rgba(240, 240, 245, 0.8) – Subtle card/panel background.
• Text: #1A1A1A (Charcoal Black) – Primary text color for readability.
• Text Muted: #6C757D (Muted Gray) – Softer color for secondary text and labels.
• Border: rgba(0, 74, 173, 0.2) – Subtle border color for UI elements.

6. Signature Design Concept

Interactive Blueprint Homepage

The homepage will resemble an engineering blueprint, complete with pencil-sketch animations and interactive elements. Key features include:

• Dynamic Sketch Animations: As users scroll, sections of the blueprint "draw themselves" in real-time, revealing features like subjects, tools, and quizzes.
• Interactive Nodes: Each subject or feature is represented as a clickable node on the blueprint. Hovering over a node highlights its connections to related topics.
• Zoomable Interface: Users can zoom in and out of the blueprint to explore details or get an overview.
• Micro-interactions: Clicking a node flips it into a detailed card with explanations, quizzes, or notes.
• Libraries: Use @react-three/fiber for 3D interactions, gsap for scroll-triggered animations, and framer-motion for smooth transitions.

This design concept ensures the homepage is visually captivating, interactive, and aligned with the engineering theme.

7. Interaction Model & Motion Direction

Landing Page Interaction Model: Parallax

• Layered Depth: Scroll-driven animations where blueprint layers translate at different speeds, creating a sense of depth.
• Scroll-triggered reveals: Features and sections animate into view as users scroll.
• Hover Transitions: Nodes and links react to cursor movements with subtle animations.

Internal Pages Interaction Model: Static

• Minimal Motion: Focus on clarity and readability for dashboards, study plans, and notes.

8. Non-Functional Requirements

• Performance: The system should load pages within 2 seconds and handle up to 10,000 concurrent users.
• Scalability: Support future expansion to include more subjects and features.
• Security: Ensure data privacy and secure user authentication.
• Localization: Provide support for Indian languages like Kannada, Hindi, and English.

9. Tech Stack

Frontend

• React for Web

Backend

• Python
• FastAPI

Database

• MySQL or MariaDB (preferred for structured data)
• MongoDB (for unstructured data)

AI Models

• GPT 5.4 for user-friendly responses
• Claude 4.6 Opas for academic or coding work
• Gemini 3.1 Pro for friendly explanations
• Google Nano Banana for image generation

AI Tools

• Litellm for LLM Routing
• Langchain

Orchestration

• Docker and docker-compose for local deployment
• Kubernetes for server-side orchestration

10. Assumptions and Constraints

• The system assumes students have access to stable internet connections.
• The platform will initially focus on VTU syllabus but can expand to other state universities.
• AI predictions rely on past paper data, which must be regularly updated.

11. Glossary

• VTU: Visvesvaraya Technological University, Karnataka, India.
• AI: Artificial Intelligence.
• LLM: Large Language Model.
• UI: User Interface.
• CTA: Call to Action.