System Requirements Document (SRD)

Project Name: earthy-ai

1. Introduction

The earthy-ai project aims to create a transformative platform that leverages artificial intelligence to provide meaningful advice and emotional support to users in an anonymous, safe, and community-driven environment. This document outlines the system requirements for the development of the platform, ensuring alignment with the vision shared by Khyati Singh from India. The platform will cater to users across diverse categories, prioritizing privacy, emotional safety, and helpful responses.

2. System Overview

earthy-ai is designed to be an anonymous confession and advice hub where users can share their problems without fear of judgment. The platform will combine community wisdom with AI-generated advice to provide empathetic, practical, and actionable solutions. Key features include anonymous posting, AI-driven emotional analysis, and a voting system to highlight the most helpful responses. The platform will be accessible via web and mobile, with a calming and intuitive user interface tailored for Indian users, considering locale-specific preferences such as timezone (IST) and cultural nuances.

3. Functional Requirements

As User:

• I should be able to post confessions/problems anonymously without requiring login.
• I should be able to view a public feed of posts.
• I should be able to reply to posts with advice or suggestions.
• I should be able to upvote/downvote advice to highlight the most helpful responses.
• I should be able to sort responses by “Most Helpful” or “Latest.”
• I should be able to browse posts by categories like Career, Relationships, Studies, and Mental Health.
• I should be able to filter posts using tags for easy browsing.
• I should be able to receive AI-generated advice that is empathetic and non-judgmental.
• I should be able to see multiple AI-generated suggestions (practical + emotional support).
• I should be able to see AI responses adjusted based on detected emotions like stress, anxiety, sadness, or confusion.
• I should be able to flag serious posts for optional alert systems.

As Admin:

• I should be able to moderate content to filter abusive/harmful text.
• I should be able to access a dashboard for basic moderation tasks.
• I should be able to manage reported posts/replies.

4. User Personas

1. Anonymous User (Guest)

• Description: A user who visits the platform without creating an account. They can post confessions/problems anonymously, view the feed, and interact with advice.
• Goals: Share problems anonymously, receive advice, and browse helpful responses.
• Pain Points: Fear of judgment, need for privacy, and emotional safety.

2. Registered User

• Description: A user who opts to create an account for additional features like reputation tracking and personalized suggestions.
• Goals: Build a reputation, track interactions, and access enhanced AI features.
• Pain Points: Balancing anonymity with personalization.

3. Admin

• Description: A moderator responsible for ensuring the platform remains safe and abuse-free.
• Goals: Maintain content quality, enforce community guidelines, and manage flagged posts.
• Pain Points: Handling high volumes of moderation tasks efficiently.

5. Visuals Colors and Theme

Color Palette:

• primary: #4A7C59 (Emerald Green) — Represents growth, calmness, and emotional support.
• primary_light: #A8D5BA (Mint Green) — A lighter tint for hover states and secondary UI elements.
• secondary: #F28C28 (Amber Orange) — For headlines, links, and emphasis, symbolizing warmth and positivity.
• accent: #E63946 (Crimson Red) — A vibrant pop color for CTAs, badges, and active states.
• highlight: #FFB703 (Golden Yellow) — For hover states, active indicators, and notifications.
• bg: #F1F5F9 (Light Gray) — The page background color for a clean and calming interface.
• surface: rgba(74, 124, 89, 0.8) — The card/panel background for posts and replies.
• text: #1B4332 (Dark Green) — Primary text/heading color for readability and calmness.
• text_muted: #6C757D (Muted Gray) — Softer color for secondary text, labels, and timestamps.
• border: rgba(28, 28, 28, 0.2) — Subtle border color for UI elements.

6. Signature Design Concept

Concept Name: Emotionally Interactive Bloom

The homepage will feature an interactive, blooming tree that grows dynamically based on user interactions. Each branch represents a category (Career, Relationships, Studies, Mental Health), and clicking on a branch reveals posts within that category. Leaves on the tree will change color based on detected emotions in the posts (e.g., green for calm, yellow for confusion, red for stress).

Details:

• Animation: The tree will bloom as users scroll, using @react-three/fiber for 3D rendering and gsap for scroll-triggered animations.
• Interaction: Hovering over a branch will display a tooltip with the category name. Clicking will zoom into the branch, revealing posts as cards.
• Micro-interactions: Leaves will sway gently, and clicking on a post card will flip it to reveal advice.
• Color Shifts: The background will subtly morph colors based on the time of day (e.g., warm tones in the morning, cool tones at night).

This concept ensures the platform feels alive and emotionally engaging, making users feel connected to the community and their own growth.

7. Interaction Model & Motion Direction

Landing/Home Page:

• Interaction Model: Parallax with layered depth via scroll. The blooming tree and its branches will translate at different speeds, creating a visually rich storytelling experience.
• Motion Direction: Smooth scroll-triggered reveals, hover transitions on branches, and spring physics on interactive elements like post cards.

Internal Pages:

• Interaction Model: Static for clarity and readability. Minimal motion for dashboards, settings, and forms.

8. Non-Functional Requirements

• Performance: The platform should load within 2 seconds for users on a 4G network.
• Scalability: Support up to 1 million users concurrently.
• Security: Ensure data encryption for all user interactions and AI responses.
• Accessibility: WCAG 2.1 compliance for users with disabilities.
• Localization: Default timezone set to IST (Indian Standard Time).

9. Tech Stack

Frontend:

• React for Web
• Tailwind CSS for styling

Backend:

• Python
• FastAPI

Database:

• MongoDB for NoSQL storage
• WeaviateDB for VectorDB (emotion detection)

AI Models:

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

AI Tools:

• Litellm for LLM Routing
• Langchain for AI orchestration

Local Orchestration:

• Docker
• docker-compose

Server-Side Orchestration:

• Kubernetes

10. Assumptions and Constraints

• Users will primarily access the platform via mobile devices.
• AI responses must be empathetic and culturally sensitive.
• Moderation tools must handle high volumes of flagged content efficiently.

11. Glossary

• AI: Artificial Intelligence.
• NLP: Natural Language Processing.
• IST: Indian Standard Time.
• WCAG: Web Content Accessibility Guidelines.

This document provides a comprehensive foundation for the development of earthy-ai. Let me know if you need further refinements or additional details, Khyati!