🧠 Insight

Insight is an innovative therapy analytics platform designed to empower mental health professionals with AI-powered insights and client progress tracking.

---

✨ Features

• 🎯 Client Progress Dashboard: Track mood trends, coping mechanisms, and therapeutic goals.
• 🤖 AI-Powered Session Analysis: Extracts insights using NLP and emotional analytics.
• 📊 Interactive Analytics Dashboard: Visualize metrics and sentiment over time.
• 🗣️ Sentiment & Self-Talk Analysis: Tracks emotional expressions and self-references.
• 📝 Automated Session Notes: Generates comprehensive session summaries and transcripts.

---

🧪 Try It Out!

Want to test InsightMinds' powerful recording analysis features?

Use this sample therapy session:

🎥 Sample Recording
Source: MedCircle YouTube Channel

This will demonstrate our AI-powered capabilities including:

• 📝 Automated session transcription
• ✍️ Detailed session summary
• 🎯 Key insights and observations

---

🛠️ Technology Stack

InsightMinds is built with cutting-edge technologies:

• ⚛️ Next.js — React-based framework for production-ready web applications
• 🗄️ Supabase — Open-source Firebase alternative (authentication, database, and storage)
• 🤖 OpenAI — Natural language processing for smart session insights
• 🧠 Hume AI — Emotion recognition for deeper psychological understanding
• 🎙️ Assembly AI — Transcription engine for speech-to-text

---

🖥️ Getting Started

Follow these steps to set up and run InsightMinds locally:

1. 🔁 Clone the Repository

   git clone https://github.com/onkaryemul/InsightMinds.git

2. 📦 Install Dependencies

Navigate to the project directory:

   cd InsightMinds

Make sure you have Node.js (v18 or higher) and npm installed. Then run:

   npm install 

3. 🔐 Environment Variables

Create a .env.local file in the root directory and add the following keys:

   OPENAI_API_KEY=your_openai_key
   NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
   NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
   SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key
   ASSEMBLYAI_API_KEY=your_assemblyai_key
   NEXT_PUBLIC_ASSEMBLY_AI_API_KEY=your_assemblyai_key
   NEXT_PUBLIC_HUME_API_KEY=your_hume_api_key

4. ⚙️ Build the Application

For production setup, build the app with:

   npm run build

Then start the production server:

   npm start

5. 🧪 Run in Development Mode

For development and testing purposes:

   npm run dev

6. 🧪 Python Test Suite

A suite of Python-based GUI and functional tests lives in the tests/ directory. These use Playwright and requests to exercise the running application and generate HTML reports. This is independent of the TypeScript code and is useful for continuous-integration or local regression testing.

Setup

# create and activate a virtual environment
python3 -m venv .venv
source .venv/bin/activate

# install dependencies
pip install playwright pytest pytest-html requests
playwright install

Running tests

Start the Next.js server in a separate terminal, then run:

# run GUI tests only
pytest tests/test_gui.py --html=tests/reports/gui_report.html

# run API/functional tests only
pytest tests/test_api.py --html=tests/reports/api_report.html

# run all tests together
pytest tests --html=tests/reports/full_report.html

Reports will be generated under tests/reports/.

🙌 Contributing

If you'd like to contribute, feel free to fork the repository and submit a pull request. We welcome improvements in UI/UX, API integration, and documentation.