Self-Hostable Habit Tracker

A habit tracker you actually own.

Turn protocols into daily habits. Customize everything. Track it yourself, or let your AI assistant manage it through the API. Run it on our servers — or on yours.

The System

Protocols become habits. Habits become data. Data becomes insight.

One loop, four steps — and every step works by hand or through your AI assistant.

Protocols
Customize
Track
Review
Review what works → adjust the protocol → the loop continues

Across All Six Pillars

Cognition
Recovery
Fueling
Mental
Physicality
Finance
How You Use It

Manual when you want control. AI when you want ease.

The tracker doesn't care who's driving — you, your assistant, or both.

Protocols, Your Way

A protocol is a structured routine — a set of steps with a schedule. Start from the library or write your own from scratch. Nothing is prescribed; everything is editable.

What You Get

  • Browse the protocol library or create your own
  • Every protocol breaks down into concrete daily steps
  • Edit steps, schedules, and targets to fit your life
  • Organize across the six pillars
  • Set duration and difficulty at your own pace
  • Your customizations stay yours

Example

"Adopt the Morning Light protocol, but I wake up at 6am"

✅ Morning Light — customized

Your version:
• 06:10 — 10 min outdoor light
• Sunset — dim indoor lights
• 21:30 — screens off
• 22:30 — lights out

3 steps became daily habits.
Edit any of them, any time.

Honest Tracking

Check habits off as you go. Streaks, completion rates, and progress over time — measured against your own baseline, not someone else's ideal.

What You Get

  • One-tap daily completions
  • Streaks — current and personal best
  • 7-day and 30-day completion rates
  • Progress per habit, per protocol, per pillar
  • Pause or reschedule without losing history
  • Your history is exportable — it belongs to you

Example

"Morning meditation — done"

✅ Logged: Morning Meditation

🔥 Streak: 12 days (best: 18)
📊 This week: 6/7 (86%)
📈 This month: 24/28 (86%)

6 more days to beat your record.

AI-Managed, If You Want

Every action you can take, an AI assistant can take for you — through one API endpoint, with a key you issue and can revoke. Tell your assistant what you did; it keeps the tracker honest.

What You Get

  • Full tracker control over a simple REST API
  • Works with any assistant that can call an API
  • Create protocols and habits from conversation
  • Log completions when you mention them in chat
  • Ask for progress reports in plain language
  • Scoped API keys — grant access, revoke any time

Example

"I did my cold shower and skipped the evening walk"

Logged via API:

✅ Cold Shower — completed
⏭️ Evening Walk — skipped (noted)

POST /api/tracker/habits/cold-shower/log
POST /api/tracker/habits/evening-walk/skip

Walk skips are up this week —
want me to move it to mornings?
Share

Good protocols deserve to travel.

What works for you might work for someone you know. Share it with a link, let them make it theirs — no extra accounts, no special apps.

Morning Light Protocol

Morning sunlight exposure + evening light reduction. 4 steps, ~15 min a day.

4.3Rating
23People adopted it
9Remixed versions
@

A friend who tried it ★★★★★

"60 days in. Sleep latency dropped from 45min to 10min. Morning light is the game changer."

Share with a link

Send a protocol to a friend. They adopt it, tweak the schedule, and it's theirs.

Remix, don't copy

Adopted protocols stay editable. Everyone runs their own version.

The marketplace

Browse protocols the community published, rate what you tried, publish your own.

The API

One endpoint surface. Any assistant.

Everything the tracker does is reachable over REST with a scoped API key. If your AI can make an HTTP request, it can manage your habits.

GET /api/tracker/habits

List habits with streaks and completion stats

POST /api/tracker/habits

Create a habit — standalone or from a protocol step

POST /api/tracker/habits/:id/log

Log a completion (or a skip, honestly)

GET /api/tracker/protocols

List protocols and their steps

POST /api/tracker/protocols/:id/adopt

Turn a protocol's steps into tracked habits

GET /api/tracker/progress

Progress summary — per habit, protocol, or pillar

your assistant, behind the scenes
curl -X POST https://your-instance/api/tracker/habits/meditation/log \
  -H "Authorization: Bearer $LIBERTURE_API_KEY"

You issue the key. You scope it. You revoke it. The assistant works for you — not the other way around.

Self-Hostable

Our servers, or yours. Same code either way.

Liberture runs anywhere Node and Postgres run. Use liberture.com for convenience — or host it yourself and answer to no one.

Clone

Grab the repo — the same code that runs liberture.com

Configure

Point it at your Postgres, set your secrets in .env

Run

Build and start. One Node process, one database

Own it

Your habits, your API keys, your data — on your machine

terminal
git clone https://github.com/Liberture/liberture
cd liberture && cp .env.example .env
pnpm install && pnpm build && pnpm start

Your database

Habits and history live in your Postgres, not a third-party silo.

Your instance

A VPS, a home server, a Raspberry Pi in the closet — your call.

Your exit

Export everything, any time. Leaving should always be easy.

View on GitHub

Build habits on your own terms.

Pick a protocol, make it yours, and start tracking — by hand or with your assistant doing the bookkeeping.

Get Started FreeBrowse Protocols