A Minimalist, Local-First, High-Precision Productivity & Habit Operating System
Built with React, Vite, TypeScript, Dexie IndexedDB, and Electron for Standalone Desktop GUI Applications.
Habit OS is an advanced, privacy-focused productivity workstation designed for professionals, engineers, and power users who demand high-density workflow management without slow cloud bloat or visual distraction.
Every surface follows a Minimal Ink & Monochromatic Precision visual language, storing 100% of user data locally inside your device using Dexie IndexedDB.
- Track daily, weekly, or custom scheduled habits with target values and metrics.
- Dedicated Modal Creation Dialogs (Add Habit Modal with category, time of day, difficulty, and start/end dates).
- 30-day streak heatmaps, completion consistency percentages, and best-performing day metrics.
- Flexible streak skip rules (Pause, Reset, Forgive, Break).
- Workload management supporting backlog, todo, in-progress, and critical priority items.
- Dedicated Modal Task Dialogs (Add Task Modal with priority, due date, due time, estimated minutes, and tags).
- Interactive Task Scheduling Calendar: Month & week grid highlighting task deadlines, scheduled habits, and historical date inspection.
- Multi-mode focus timers (Guided Verification Mode, Continuous Mode, Goal-Based Focus).
- Anti-gaming verification checkpoints: periodic verification prompts separate verified deep work from idle time.
- Interruption logging and session efficiency analytics.
- Multi-line 30-day trend graphs tracking habit completion % and verified focus curves.
- Task priority distribution donut/pie charts.
- 7-day focus minutes breakdown bar charts.
- Top-Corner Dynamic Flame Indicator: Red glow (100% completion), Orange (50%), Yellow (25%), White/Dim (10%), with ticking & burst animation on login if 0% progress.
- Streak Freeze Shield: Earn 1 Streak Freeze after 5 consecutive days of 100% activity. Protects your streak for 24 hours if a day is missed, featuring an animated melting ice sequence.
- Integrates Ollama Local Base AI (
http://localhost:11434), NVIDIA NIM, OpenAI (GPT-4o), Anthropic Claude 3.5, Google Gemini, and 100% Offline Engine. - Master App Password: Password-protected Clear Entire Database and JSON data backup extraction in Settings.
Habit OS can be installed either as a Direct Standalone Desktop App or via Automated Python CLI Setup.
Run Habit OS directly as a standalone desktop application with a GUI icon:
- Navigate to the latest Releases section on GitHub.
- Download the pre-packaged executable for your operating system:
- Windows:
Habit.OS.Setup.1.0.0.exe(Installer) orHabit.OS.1.0.0.Portable.exe(Standalone) - Linux:
Habit_OS-1.0.0.AppImage(Executable) orhabit-os_1.0.0_amd64.deb(Debian Package) - macOS:
Habit_OS-1.0.0.dmg(Disk Image Installer)
- Windows:
- Launch the application directly via your desktop icon or start menu shortcut.
Follow these steps to set up the development environment, clone the repository, and perform the initial build.
Ensure Python (3.8+), Node.js (v18+ LTS), and Git are installed.
# Ubuntu / Debian / Kali
sudo apt update
sudo apt install -y python3 python3-pip python3-venv nodejs npm git build-essential
# Arch Linux
sudo pacman -S python python-pip nodejs npm git base-devel# Verify Python, Node.js, and Git installation
python --version
node -v
npm -v
git --version
# If Node.js or Python are missing:
winget install Python.Python.3.11
winget install OpenJS.NodeJS.LTS# Install via Homebrew
brew install python node gitOpen your terminal or command line prompt and execute:
# Clone the repository
git clone https://github.com/project-hellhound-org/Habbit-Tracker.git
# Navigate into project directory
cd Habbit-Tracker
# Option A: Automated One-Line Setup (Recommended - Auto-bootstraps Pip & Ollama)
python3 setup.py
# Option B: Manual Pip & NPM Installation
python3 -m pip install -r requirements.txt
npm installTip
Troubleshooting Pip in Virtual Environments:
If running pip install -r requirements.txt returns ModuleNotFoundError: No module named 'pip', invoke pip via Python module flag:
python3 -m pip install -r requirements.txtOr run python3 setup.py, which automatically repairs and bootstraps pip using ensurepip.
# Start Vite local development server
npm run devOpen http://localhost:3000 in your web browser.
# Launch Habit OS inside an Electron desktop window
npm run electron:dev# Compile TypeScript & package cross-platform desktop executables
npm run build
npm run electron:buildThe output executables and installers will be generated inside the dist_electron/ directory:
- Linux Output:
dist_electron/Habit OS-1.0.0.AppImage&dist_electron/habit-os_1.0.0_amd64.deb - Windows Output:
dist_electron/Habit OS Setup 1.0.0.exe&dist_electron/Habit OS 1.0.0 Portable.exe - macOS Output:
dist_electron/Habit OS-1.0.0.dmg
- GUI Framework: Electron (Desktop Runtime) & React 18
- Build System: Vite & TypeScript
- State & Storage: Dexie.js (IndexedDB local-first database)
- Local AI Engine: Ollama (
http://localhost:11434) & Cloud LLMs - Styling: Modern Vanilla CSS Design Tokens (Monochromatic High-Contrast Palette)
- Icons: Lucide React
- Date Math: date-fns
- Zero Mandatory Cloud Dependencies: Your database lives exclusively inside your local device storage.
- Granular AI Privacy Controls: Control exactly which metrics (Habits, Tasks, Focus, Journal) are shared with AI providers.
- Master Password Security: Database wipes and exports require master password authorization.
Distributed under the MIT License. Developed by Project Hellhound.