Skip to content

SereniFi Guide is a personalized relaxation app offering meditations, breathing exercises, and calming music to help users achieve mental tranquility.

License

Notifications You must be signed in to change notification settings

tannuiscoding/Serenity-Guide

 
 

Repository files navigation

SereniFi

Feel Calm, Centered, and Peaceful

Prototype Video

GitHub Repository Stats

🌟 Stars 🍴 Forks 🐛 Issues 🔔 Open PRs 🔕 Closed PRs
GitHub stars GitHub forks GitHub issues Open PRs Closed PRs

🏆 Featured in Open Source Programs

Event Logo Event Name Event Description
GSSoC 24 GirlScript Summer of Code Extd 2024 GirlScript Summer of Code Extd is a 1-month long Open Source program by GirlScript Foundation.It is an initiative to bring more beginners to Open-Source Software Development.

Overview

📜 SereniFi Guide is a comprehensive mind-relaxing application designed to help users achieve mental tranquility and enhance well-being. Through guided meditations, breathing exercises, and soothing music, SereniFi offers a serene experience tailored to individual needs. Perfect for those seeking to unwind, focus, or find inner peace amidst the daily grind.


🌟 Features

  • Guided Meditations 🧘‍♂️: Choose from quick 5-minute sessions to extended deep relaxation.
  • Breathing Exercises 🌬️: Techniques to reduce stress and improve focus through controlled breathing.
  • Relaxation Music 🎶: Calming background music and nature sounds to create a peaceful atmosphere.
  • Daily Tips 🌱: Receive mindfulness tips and inspirational quotes every day to stay positive.
  • Progress Tracking 📊: Monitor your relaxation journey with insightful metrics and achievements.

🛠️ Installation

To set up SereniFi on your local machine, follow these steps:

  1. Clone the Repository

    git clone https://github.com/Amna-Hassan04/serenity-guide.git
  2. Navigate to the Project Directory

    cd serenity-guide
  3. Install Dependencies

    pip install -r requirements.txt
    
  4. Start the Application

    streamlit run app.py


🌟 Contributors

🏆 Acknowledgments

A heartfelt thanks to all contributors, testers, and supporters. Special thanks to OSS Codess Cafe Cohort 5 for their unwavering support and encouragement. This project was initially made as a hackathon submission and secured 3rd place in that hackathon.


Contribution Guidelines

We welcome contributions! Please read our Code of Conduct to participate in this project. By contributing, you agree to abide by its terms.

License

This project is licensed under the GPL-3.0 License

About

SereniFi Guide is a personalized relaxation app offering meditations, breathing exercises, and calming music to help users achieve mental tranquility.

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%