Skip to content

Generative AI-powered journaling app that helps people reflect on their emotions, track mental wellness, and discover personalized strategies to stay happy

Notifications You must be signed in to change notification settings

alurubalakarthikeya/Soulink

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

74 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

Generative AI-powered journaling app that helps people reflect on their emotions, track mental wellness, and discover personalized strategies to stay happy

Topics

Resources

Stars

Watchers

Forks

Languages

  • JavaScript 41.9%
  • CSS 35.5%
  • Python 22.4%
  • HTML 0.2%