Skip to content
Sparths
AnyHabit
Public

About

A universal habit and tracking dashboard tailored for Raspberry Pi and Docker.

sparths.github.io/anyhabit-demo/

Topics

dockerfastapihabit-trackerraspberry-pireactself-hosted

Resources

Readme
GPL-3.0 license

Code of conduct

Code of conduct

Contributing

Contributing
Activity

Stars

18 stars

Watchers

1 watching

Forks

5 forks
Report repository
BranchesTags

Repository files navigation

AnyHabit

FastAPI React Tailwind CSS SQLite Docker Discord Live Demo

AnyHabit is a streamlined, universal habit-tracking dashboard designed for Raspberry Pi, home servers, and Docker enthusiasts. It provides a minimalist interface to track positive growth or systematically reduce harmful routines.

📺 Preview & Updates

Important

Try it now: Explore the Live Demo Site
Join the Community: AnyHabit Discord Server — Get support, showcase your work, and chat with fellow devs!

AnyHabit Demo

🚀 Click to see Recent Updates (Changelog)

[1.5.0] - MCP / AI Integration

  • Added: Model Context Protocol (MCP) server for connecting compatible AI assistants and agents to AnyHabit
  • Added: MCP tools for trackers, logs, journals, analytics, dashboards, groups and user preferences
  • Added: Support for both local stdio clients and deployable Streamable HTTP MCP connections
  • Added: Dedicated ANYHABIT_MCP_* settings in the root .env configuration
  • Added: Safety gate for irreversible MCP actions with ANYHABIT_MCP_ALLOW_DESTRUCTIVE=false by default
  • Added: MCP client configuration, Docker example and setup documentation under mcp/

[v1.4.0] - Latest Release

  • Added: Nine more dashboard widgets — Tracker Spotlight, Quick Log, Heatmap, Recent Activity, Journal Feed, Mood Trend, Notes, API Explorer and Embed
  • Added: Personal API tokens for scripts and integrations (Settings → Developer)
  • Added: Webhooks with HMAC-signed payloads — log entries, journals, relapses and streak milestones
  • Added: Prometheus metrics endpoint for Grafana
  • Added: GET /dashboard/activity for recent entries across all trackers
  • Fixed: Typing in any dialog stole focus onto the close button after every keystroke
  • Fixed: The widget settings and Add Widget dialogs ignored Escape
  • Fixed: The /developer API was not proxied, making it unreachable in production
  • Full Changelog

[v1.3.0] - Timezones, Backups and Archiving

  • Added: Your own time zone — streaks and daily targets now reset at your midnight, not UTC midnight
  • Added: Restore from a backup with a preview of exactly what will change, in Settings → Data
  • Added: Automatic database snapshot before every upgrade, kept in data/backups/
  • Added: Archive trackers instead of deleting them, keeping all history
  • Added: Search everything with Ctrl/⌘ + K
  • Added: Tracker descriptions, colours, back-dated start dates and per-log notes
  • Added: Consistency rate, weekday breakdown and mood-over-time charts
  • Added: Group renaming, member removal, leaving, deleting and join-code rotation
  • Added: Change your password, edit your display name, delete your account
  • Added: Journal search, and relapse entries clearly marked
  • Fixed: Logging a relapse now actually resets a quit tracker's totals, as documented
  • Fixed: Export dialog could never open
  • Fixed: Sign-in page ignored dark mode
  • Fixed: ANYHABIT_SECRET_KEY and the other documented settings were never passed to the backend
  • Fixed: Signing in failed over plain HTTP on a LAN address (Secure-cookie default)
  • Fixed: Errors were swallowed silently instead of being shown
  • Full Changelog

[v1.2.0] - Data Export

[v1.0.0] - Multi User

[v0.10.0] - Stand Alone API

[v0.9.0] - Widgets

[v0.8.0] - Habit Scheduling

[v0.7.0] - Refactor App Structure

✨ Key Features

  • Three Tracking Modes: Quit something, build something, or simply tick a box each period.
  • Your Time Zone: Days roll over at your midnight, not the server's.
  • Categories & Archive: Organize with custom categories, and archive finished trackers without losing their history.
  • Accounts & Groups: Private accounts, plus family/friend groups for shared trackers.
  • Shared Trackers: Assign group members to one tracker and compare progress per participant.
  • Dual Streaks: Individual streaks alongside a collective group streak.
  • Real Insight: Streaks, consistency rate, weekday breakdown, heatmap and mood-over-time charts.
  • Impact Units: Money saved, Calories, CO₂ avoided, hours reclaimed — you pick the unit.
  • Daily Journal: Log your mood and thoughts, then search back through them.
  • Safe Upgrades: The database is snapshotted automatically before any schema change.
  • Fast Navigation: Ctrl/⌘ + K searches trackers, categories and actions.
  • A Dashboard You Build: 15 widget types — spotlight a tracker, one-tap logging, heatmaps, feeds, notes, even an embedded Grafana panel.
  • Built to Integrate: API tokens, signed webhooks and a Prometheus endpoint, because self-hosted should mean it plugs into everything else you run.
  • AI / MCP Integration: Connect compatible AI assistants and agents through the Model Context Protocol to inspect analytics and manage trackers, logs, journals, dashboards and groups.
  • Dark Mode: Light, dark, or follow your system.
  • Full Data Ownership: Export trackers and journals as CSV for analysis, or a complete JSON backup you can restore here or on another server.
  • Self-Hosted & Private: Complete control over your data with SQLite and Docker.

🚀 One-Command Quick Start

AnyHabit is designed to be "up and running" in seconds. You do not need Node.js or Python installed locally.

Requirements: Docker with the Compose plugin.

# 1. Clone the repository
git clone https://github.com/Sparths/AnyHabit.git
cd AnyHabit

# 2. Build and start everything
docker compose up -d --build

Open http://localhost (or your device's IP) in your browser.

Sign in with the first-run account — username owner, password anyhabit — then change the password under Settings → Account.

Tip

Your data lives in a Docker volume (db_data) and survives stopping, rebuilding and upgrading the containers. See Upgrading.

⬆️ Upgrading

cd AnyHabit
git pull
docker compose up -d --build

That is all. Your data lives in a Docker volume, not in the container, and AnyHabit takes a snapshot of the database into data/backups/ before applying any schema change. Migrations are additive and idempotent, so an interrupted upgrade is safe to retry, and upgrading from any 0.1–0.6 release works the same way.

Tip

Want your own copy first? Settings → Data → Export data gives you a JSON backup you can restore from Settings → Data → Restore data at any time.

See UPGRADING.md for what changed in 0.7.0, how to verify the upgrade, and how to roll back if you need to.

⚙️ Configuration

All settings are optional — AnyHabit runs with sensible defaults. To change any of them:

cp .env.example .env   # edit it, then:
docker compose up -d --build
Variable Description Default
APP_PORT Port the app is served on 80
ANYHABIT_SECRET_KEY Signs login sessions. Set this before exposing AnyHabit beyond your own machine (openssl rand -hex 32). Changing it only signs everyone out; it never touches data. built-in dev key
ANYHABIT_COOKIE_SECURE auto marks the auth cookie Secure only when the request arrived over HTTPS. true/false force it. auto
ANYHABIT_COOKIE_SAMESITE SameSite policy for the auth cookie lax
ANYHABIT_COOKIE_DOMAIN Optional domain scope, e.g. .example.com unset
ANYHABIT_TOKEN_TTL_SECONDS Session lifetime 604800 (7 days)
ANYHABIT_BOOTSTRAP_USERNAME First-run account username owner
ANYHABIT_BOOTSTRAP_EMAIL First-run account email owner@anyhabit.local
ANYHABIT_BOOTSTRAP_PASSWORD First-run account password anyhabit
ANYHABIT_AUTO_BACKUP Snapshot the database before applying migrations true
ANYHABIT_BACKUP_RETENTION How many snapshots to keep 10
ANYHABIT_CORS_ORIGINS Extra browser origins allowed to call the API dev server ports
ANYHABIT_LOG_LEVEL DEBUG, INFO, WARNING or ERROR INFO
VITE_API_URL Backend URL when running the frontend separately unset
ANYHABIT_MCP_URL AnyHabit API base URL used by the MCP server unset
ANYHABIT_MCP_TOKEN Personal API token used by MCP unset
ANYHABIT_MCP_TIMEOUT_SECONDS MCP → AnyHabit API timeout 10
ANYHABIT_MCP_ALLOW_DESTRUCTIVE Allow irreversible MCP delete/remove tools false
ANYHABIT_MCP_TRANSPORT MCP transport: stdio or streamable-http stdio
ANYHABIT_MCP_HOST Bind address for Streamable HTTP 127.0.0.1
ANYHABIT_MCP_PORT Port for Streamable HTTP 8001
ANYHABIT_MCP_PATH Streamable HTTP MCP endpoint path /mcp
ANYHABIT_MCP_STATELESS_HTTP Run Streamable HTTP without MCP session state false

Important

The first-run account is created only when the database has no users at all. Changing these values later never modifies an existing account — use Settings → Account to change your password.

Warning

Leave ANYHABIT_COOKIE_SECURE on auto unless you always reach AnyHabit over HTTPS. Forcing true on a plain-HTTP LAN address makes the browser discard the session cookie, which looks exactly like signing in not working.

🔌 Backend API

AnyHabit is API-first. Everything the web UI does is a documented HTTP call, so you can build your own client, script your data, or wire it into another tool.

Resource Description
📚 API Documentation Complete reference with examples
⚡ Quick Reference One-page cheat sheet
🔧 Frontend Integration Guide Building a custom frontend
🗂️ Documentation Index Navigation hub for backend docs
💻 Development Guide Running and contributing to the backend
🤖 MCP Integration Connect compatible AI assistants and agents through MCP 
# Sign in and keep the session cookie
curl -c cookies.txt -X POST http://localhost/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"identifier":"owner@anyhabit.local","password":"anyhabit"}'

# List your trackers
curl -b cookies.txt http://localhost/trackers/

# Everything about one tracker in a single call
curl -b cookies.txt http://localhost/trackers/1/bundle

# Version, schema version and what the last boot migrated
curl http://localhost/health

Integrations

AnyHabit is built to plug into the rest of your setup:

  • API tokens — create one under Settings → Developer, then Authorization: Bearer ahb_… on any request. Revocable, optionally expiring.
  • MCP / AI assistants — the mcp/ server exposes safe, structured tools for trackers, logs, journals, analytics, dashboards and groups over stdio or Streamable HTTP.
  • Webhooks — signed with HMAC-SHA256, fired on logs, journals, relapses and streak milestones. Point them at Home Assistant, Discord, n8n or a shell script.
  • Prometheus — scrape /developer/metrics for streaks, progress and impact, scoped to the token's owner.
# Log 30 pages from a cron job
curl -X POST http://localhost/trackers/1/logs/ \
  -H "Authorization: Bearer $ANYHABIT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"amount": 30, "note": "morning reading"}'

See the Quick Reference for the full surface.

Interactive docs are served by the app itself — Swagger UI · ReDoc — or browse them on the hosted demo: Swagger UI · ReDoc

🛠️ Tech Stack

🤝 Community & Contributing

AnyHabit is an open-source, community-driven project!

Join our Discord Server to:

  • 🛠️ Get help with your setup or projects.
  • 🚀 Showcase what you've built.
  • 💬 Chat with other programmers and contributors.

Other ways to help:

👥 Contributors

AnyHabit contributors

About

A universal habit and tracking dashboard tailored for Raspberry Pi and Docker.

sparths.github.io/anyhabit-demo/

Topics

dockerfastapihabit-trackerraspberry-pireactself-hosted

Resources

Readme
GPL-3.0 license

Code of conduct

Code of conduct

Contributing

Contributing
Activity

Stars

18 stars

Watchers

1 watching

Forks

5 forks
Report repository

Releases

Sponsor this project

Contributors

Languages