Soul Link - AI-Powered Journal

Soulink is an empathetic, AI-powered journaling app that helps people reflect on their emotions, track mental wellness, and discover personalized strategies — all in a fun and gamified way.

Features

• Daily Diary with Emotion Detection → Write your thoughts and let AI detect your mood and suggest solutions if required.
• Mental Wellness Insights → Track emotional trends over time with visuals.
• Character Companions → Interact with fun avatars and personalities to make journaling engaging with your real life characters.
• AI-Generated Nicknames & Tags → Reflect your unique identity with creative nicknames for yourself and your friends.
• Gamified Dashboard → Earn streaks, badges, and rewards for consistent journaling.
• Lumos AI - Your Personal AI therapist helps you with mental health concerns (if any exists).

Tech Stack

• Frontend: React.js, Vite, CSS
• Routing: React Router DOM
• State & Storage: LocalStorage
• AI & NLP: Google Generative AI API / OpenAI GPT APIs
• Charts & Visualization: Chart.js
• Voice Input: Web Speech API
• Hosting: Vercel

How It Works

1. User writes a diary entry (text/voice).
2. AI analyzes the entry, detects emotions, and generates strategies.
3. Mood + diary are stored securely in LocalStorage (no external DB).
4. Dashboard visualizes emotional trends, streaks, and gamified stats.
5. Avatars & nicknames personalize the experience.

Setup Instructions

1. Clone the repo

git clone https://github.com/your-username/Soulink.git
cd Soulink

2. Create .env file with your API key:

OPENAI_API_KEY=your_api_key_here

3.Frontend Setup

cd frontend
npm install
npm run dev

4.Backend Setup

cd backend
pip install -r requirements.txt
uvicorn app:app --reload

Developers:

@Arji Jethin Naga Sai Eswar Status: Dead
@Aluru Bala Karthikeya - Nothing beats a Jet 2 holiday
@Vedeshwari Nakate aka The Einstien
@Ayush Singh The Nigga