📊 Streak Calculator is a Python script that connects to Notion database tables to calculate and track streaks based on given criteria. It helps users monitor their consistency in various activities logged in Notion.
- 🔗 Notion Integration: Connects seamlessly with Notion database tables.
- 📅 Streak Calculation: Automatically determines streaks based on user-defined criteria.
- ⚡ Automation Friendly: Can be run manually or scheduled via cron jobs or task schedulers.
- 📤 Customizable Output: Provides streak results that can be used in dashboards or reports.
Ensure you have the following installed:
- 🐍 Python 3.8+
- 🔑 A Notion API token
- 📂 A Notion database set up with relevant entries
-
📥 Clone the repository:
git clone https://github.com/Lakendary/Streak-Calculator.git cd Streak-Calculator -
🛠 Create and activate a virtual environment (optional but recommended):
python -m venv venv source venv/bin/activate # On Windows use: venv\Scripts\activate
-
📦 Install dependencies:
pip install -r requirements.txt
-
⚙️ Configure environment variables:
- Create a
.envfile in the project directory and add:NOTION_API_KEY=your_notion_api_key_here NOTION_DATABASE_ID=your_notion_database_id_here
- Create a
-
🚀 Run the script:
python streak_calculator.py
- 📊 Track Streaks: Run the script to calculate and display your streaks.
- 🕒 Automate: Schedule the script using cron jobs (Linux/macOS) or Task Scheduler (Windows).
- 🔄 Customize: Modify the script to fit your Notion setup and tracking needs.
Contributions are welcome! If you’d like to add new features or fix bugs:
- 🍴 Fork the repository.
- 🌿 Create a new branch (
git checkout -b feature-branch). - 📝 Commit your changes (
git commit -m "Add new feature"). - 📤 Push to your branch (
git push origin feature-branch). - 🔄 Open a pull request.
This project is licensed under the MIT License. See LICENSE for details.
For issues or feature requests, open an issue on GitHub: Streak Calculator