A desktop & web application dedicated to psychotherapy and personal development

Overview • About the Project • Key Features • How to Use • Download • Emailware • License • Contact

Overview

Serinity is a desktop & web application dedicated to psychotherapy and personal development, designed for both individual users and mental health professionals. The platform integrates Artificial Intelligence to provide personalized emotional analysis, recommendations, and professional therapeutic tools.

About the Project

• Theme: Psychotherapy & Personal Development
• Platforms: Desktop & Web
• Goal: Improve mental well-being through intelligent tracking, analysis, and guidance
• Approach: Modular architecture with AI integration

Key Features

User Management

• Authentication & authorization
• Role-based access (Client, Therapist, Admin)
• Secure sessions & audit logs

Sleep Tracking

• Sleep cycle analysis
• Dream logging & emotional impact

Mood & Journal

• Daily mood tracking
• Guided emotional questions
• Personal journal with NLP analysis

Support Network (Forum)

• Community posts & comments
• Secure peer support environment

Exercises & Resources

• Guided relaxation & meditation exercises
• Multimedia resources (audio, video, text)
• Favorites & progress tracking

Appointments & Consultations

• Therapist availability management
• Online consultations
• Smart appointment recommendations

Artificial Intelligence Integration

• Facial recognition for authentication
• NLP-based emotion detection from journals
• AI-assisted self-assessment
• Session summarization & topic extraction
• Intelligent appointment scheduling

How to Use

1. Clone the Repository and Navigate to the Project

git clone https://github.com/zouari-oss/serinity-web
cd serinity-web/project

2. Install Dependencies (Composer)

Make sure you have Composer installed, then run:

composer install

3. Configure Environment Variables

Use environment-specific files:

cp project/.env.example project/.env.local

For local development, update project/.env.local with your local database credentials.

For production, use project/.env.prod as a template and set the same variables in your hosting platform (Vercel Environment Variables).

Face authentication uses ONNX Runtime with the default local model:

FACE_AUTH_RECOGNITION_MODEL_PATH=public/antelopev2/glintr100.onnx
FACE_AUTH_ONNX_RUNTIME_LIBRARY_PATH=vendor/ankane/onnxruntime/lib/onnxruntime-linux-x64-1.24.3/lib/libonnxruntime.so.1.24.3
FACE_AUTH_PYTHON_COMMAND=.venv/bin/python
FACE_AUTH_PYTHON_SCRIPT_PATH=bin/face_embedding_infer.py
FACE_AUTH_SIMILARITY_THRESHOLD=0.30
FACE_AUTH_RATE_LIMIT_ATTEMPTS=5
FACE_AUTH_RATE_LIMIT_WINDOW_SECONDS=900

Note

Face login uses a 1:1 email + face check: users must enter their email on the sign-in form before triggering face authentication.

To install dependencies and download antelopev2 models automatically:

cd project
cp .env.example .env.local
bash bin/setup_face_recognition

If your web PHP blocks ffi.enable, install Python fallback deps once:

python3 -m venv .venv
.venv/bin/python -m pip install numpy onnxruntime

4. Create Database & Run Migrations

php bin/console doctrine:database:create
php bin/console doctrine:migrations:migrate

5. Start the Symfony Server

symfony server:start

Or using PHP:

php -S 127.0.0.1:8000 -t public

6. Access the Application

Open your browser and go to:

http://127.0.0.1:8000

Download

You can download the latest installable version of serinity-web for Windows, macOS and Linux.

Emailware

serinity-web is an emailware. Meaning, if you liked using this app or it has helped you in any way, would like you send as an email at zouariomar20@gmail.com or ghaithbensalah1999@gmail.com about anything you'd want to say about this software. I'd really appreciate it!

License

This repository is licensed under the GPL3.0 License. You are free to use, modify, and distribute the content. See the LICENSE file for details.

Contact

For questions or suggestions, feel free to reach out the AUTHORS

Happy Coding!