# Hypnos 🌙

*A simple tool, named after the Greek god of sleep, to track your polyphasic sleep.*

---

## Overview

**Hypnos** is a minimalist sleep tracker for logging and visualizing your sleep blocks.
Designed with polyphasic sleep schedules in mind, it provides a clean UI and a polar "donut" chart to show your sleep patterns.

---

## ✨ Features

* Log sleep blocks (start time, end time)
* Automatic duration calculation
* Persistent local storage (JSON)
* Polar chart visualization of sleep blocks

---

## 📥 Installation (Packaged App)

Download the latest release for your operating system from the
[**Releases** page](https://github.com/armaan-pb/hypnos/releases).

---

## 🛠 Run from Source (Developers)

```bash
# Clone the repo
git clone https://github.com/armaan-pb/hypnos.git
cd hypnos

# Create and activate virtual environment
python3 -m venv venv
source venv/bin/activate   # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run the app
python Hypnos/app/main.py
```

---

## 📜 License

MIT License — see `LICENSE` file for details.