Sentio - team1

Table of Contents

• Description
• User Interface Examples
• Installation
• Usage
• Environment Settings
• Architecture Design
• Authors
• Project Planning
• License

Description

Sentio is a mental state analysis system that examines how interactions and content on social platforms impact users' mental health. Using natural language processing and sentiment analysis, the system evaluates the tone and emotional content of text from Reddit, Twitter etc., to detect stress, depression and suicidal tendencies and provide personalized mental health recommendations.

User Interface Examples

Click to expand

Entry page

Analysis Result

Analysis History

Admin Dashboard

Admin Training Center

Admin Model Versions

Admin Analytics

Installation

Click to expand

Prerequisits

Anaconda / Miniconda, although you can use venv or similar of your choice.

Python 3.13 has been used throughout the project and support for anything under 3.12 is not guaranteed.

Setup

1. Clone the repository:

git clone https://git.chalmers.se/courses/dit826/2025/team1.git
cd team1

2. Create and activate virtual environment:

# Using conda/mamba
conda env create -f environment.yml
conda activate ai-project

3. Apply database migrations:

python manage.py migrate

4. Create a superuser (for admin access):

python manage.py createsuperuser

Usage

Run application (in development mode)

python manage.py runserver

The application will be available at http://127.0.0.1:8000/

Running Tests

# Run all tests
python manage.py test

# Run tests for specific app
python manage.py test apps.predictions

Django Shell (for development)

python manage.py shell

Environment Settings

The project uses split settings for different environments:

• Development: sentio.settings.development (default)
• Production: sentio.settings.production
• Testing: sentio.settings.testing

To use a specific setting:

DJANGO_SETTINGS_MODULE=sentio.settings.production python manage.py runserver

Architecture Design

Click to expand

Database Schema

ML Pipeline Dataflow

Transformer Training Pipeline

Google Kubernetes Engine

Authors

• Marcus Berggren
• Lian Shi
• Julia McCall
• Claudia Sevilla Eslava
• Karl Byland

Project Planning

The project planning markdown file is located at team1/docs/project_planning.md.

License

This project is licensed under the MIT License. See the LICENSE file for details.