System Requirements Document (SRD)

Project Name: starry-name

1. Introduction

The starry-name project is an innovative and entertaining application designed to deliver personalized, AI-generated roasts based on user-provided names. Conceptualized by Ayushman Kulshrestha in India, this app aims to provide humor with a twist of personalization, ensuring every roast is unique and engaging. By leveraging cutting-edge AI technologies, starry-name promises to be a dynamic and shareable experience for users seeking witty and amusing content.

This document outlines the system requirements for the starry-name project, ensuring the application meets user expectations and delivers a seamless, humorous experience.

2. System Overview

The starry-name app will allow users to input a name and receive a unique, AI-generated roast tailored to that name. The system will utilize advanced AI models to ensure the roasts are fresh, creative, and personalized every time. The app will feature a simple and intuitive interface, making it accessible to users of all ages.

Key features include:

• Input field for name submission.
• AI-generated roasts that are unique for every input.
• Option to share roasts on social media platforms.
• A visually engaging design with a playful and humorous theme.

The app will be developed for both web and mobile platforms, ensuring wide accessibility.

3. Functional Requirements

User Stories:

• As a User, I should be able to input a name and receive a unique roast generated by AI.
• As a User, I should be able to choose the tone of the roast (e.g., friendly, sarcastic, savage).
• As a User, I should be able to share the roast directly to social media platforms.
• As a User, I should be able to save my favorite roasts for later viewing.
• As a User, I should be able to view a history of names I’ve roasted.
• As a User, I should be able to rate the roast for its humor and creativity.
• As a User, I should be able to report inappropriate or offensive roasts.

Admin Stories:

• As an Admin, I should be able to monitor and moderate reported roasts.
• As an Admin, I should be able to update AI model parameters to improve roast quality.
• As an Admin, I should be able to view analytics on user engagement and roast ratings.

4. User Personas

1. Casual User

• Description: Individuals seeking light-hearted entertainment and humor.
• Goals: To enjoy witty and personalized roasts and share them with friends.
• Pain Points: Lack of variety or repetitive content.

2. Social Media Enthusiast

• Description: Users who actively share content on social media platforms.
• Goals: To find shareable, humorous content that garners attention and engagement.
• Pain Points: Difficulty in sharing content seamlessly.

3. Admin/Moderator

• Description: Responsible for maintaining the quality and appropriateness of roasts.
• Goals: To ensure the app delivers high-quality, non-offensive content.
• Pain Points: Managing large volumes of user reports and feedback.

5. Visuals Colors and Theme

Color Palette:

• Background: #1A1A2E (Deep Space Blue)
• Surface: #16213E (Midnight Navy)
• Text: #E94560 (Vivid Crimson)
• Accent: #0F3460 (Celestial Indigo)
• Muted Tones: #53354A (Dusky Plum)

Theme:

The app will feature a playful and humorous aesthetic inspired by the cosmos. The design will incorporate starry backgrounds, whimsical animations, and bold typography to create an engaging and entertaining user experience.

6. Signature Design Concept

Concept: Interactive Galaxy of Roasts

The homepage will feature an interactive galaxy map, where each star represents a roast. Users can navigate through the galaxy by zooming in and clicking on stars to reveal roasts. Upon entering a name, a new star will appear in the galaxy, glowing brightly to signify the uniqueness of the roast.

Details:

• Animations: Stars twinkle and shift subtly, creating a dynamic and immersive experience.
• Transitions: Smooth zoom-in and zoom-out effects as users explore the galaxy.
• Micro-interactions: Hovering over stars will display a preview of the roast tone (friendly, sarcastic, savage).
• Color Shifts: The galaxy background subtly changes hues based on the tone of the roast selected.
• User Interaction: Clicking on a star will trigger a playful animation where the roast "shoots" out like a comet.

This design concept ensures the app is visually unforgettable and encourages users to explore and interact with the content.

7. Non-Functional Requirements

• The system must ensure each roast generated is unique, as pre-resolved by the API supervisor.
• The app should have a response time of less than 2 seconds for roast generation.
• The system must support at least 10,000 concurrent users.
• The app must comply with local regulations regarding content moderation and user data privacy.
• The system should be scalable to accommodate future growth.

8. Tech Stack

Frontend:

• React for Web
• React Native for Mobile

Backend:

• Python
• FastAPI

Database:

• MySQL or MariaDB (using Alembic for migrations)

AI Models:

• GPT 5.4 for user-friendly roast generation
• Litellm for LLM Routing

Local Orchestration:

• Docker
• docker-compose

Server-side Orchestration:

• Kubernetes

9. Assumptions and Constraints

Assumptions:

• Users will primarily access the app via mobile devices.
• The app will initially target English-speaking users but may expand to support other languages.
• Roasts will be humorous and non-offensive by default, with options for tone customization.

Constraints:

• The AI model must generate unique roasts for every input name.
• The app must comply with Indian data privacy laws and regulations.
• The system must handle high traffic during peak hours without performance degradation.

10. Glossary

• Roast: A humorous and witty remark or insult tailored to a specific name.
• AI Model: Artificial Intelligence system used to generate personalized roasts.
• LLM Routing: Large Language Model routing mechanism for optimizing AI responses.
• Docker: A tool for containerizing applications to ensure consistent deployment.
• Kubernetes: A system for automating deployment, scaling, and management of containerized applications.