sleep-calc

Calculate optimal wake-up or bedtime based on 90-minute sleep cycles to reduce grogginess

Features

• Calculate multiple wake-up times from a given bedtime (4-6 sleep cycles)
• Calculate multiple bedtimes from a desired wake-up time
• Account for configurable fall-asleep duration (default 15 minutes)
• Display results in 12-hour or 24-hour format based on user preference
• Show total sleep duration for each option
• Highlight recommended option (5 cycles / 7.5 hours)
• Support relative time input (e.g., 'now', 'in 30 minutes')
• Color-coded output for better readability
• Option to show only optimal cycles (5-6) or all cycles (4-6)
• Brief explanation of why 90-minute cycles matter

Installation

# Clone the repository
git clone https://github.com/KurtWeston/sleep-calc.git
cd sleep-calc

# Install dependencies
pip install -r requirements.txt

Usage

python main.py

Built With

• python

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

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