git404hub

what is fettle fr?

deekshith-dade/fettle — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 4/5Setup · hard

tl;dr

A self hosted dashboard that syncs your own Fitbit or Pixel health data locally and adds a transparent readiness engine plus a free AI health coach.

vibe map

mindmap
  root((fettle))
    What it does
      Syncs Fitbit and Pixel health data
      Computes readiness and sleep scores
      Runs an AI coach over your data
    Tech stack
      Python
      FastAPI
      Next.js
      Google Health API
    Use cases
      Track your own readiness and sleep
      Chat with an AI coach about workouts
      Review weekly health trends
    Audience
      Quantified-self enthusiasts
      Developers with Fitbit or Pixel devices

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Sync your own Fitbit or Pixel health data locally instead of using a paid cloud service.

VIBE 2

See transparent, explainable readiness, sleep, and training load scores instead of a black box number.

VIBE 3

Chat with an AI coach that answers questions about your synced health data using real charts.

VIBE 4

Get a daily briefing and weekly retrospective summarizing changes in your health metrics.

what's the stack?

PythonFastAPINext.jsSQLiteMCP

how it stacks up fr

deekshith-dade/fettle0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultyhardhardhard
Complexity4/54/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Requires a Google Health API OAuth setup, a Fitbit or Pixel device, and a logged-in opencode CLI for free AI model access.

The explanation does not mention a license, so terms of reuse are unclear.

in plain english

Fettle is a personal health dashboard that lets you own and explore your Fitbit or Pixel watch health data instead of relying on a paid subscription service. It connects to Google's Health API, pulls your data down into a local database file on your own machine, and then calculates its own transparent versions of readiness, sleep, and training load scores, showing exactly how each number is calculated rather than hiding the formula. The dashboard covers an overview page with a daily readiness score and your goals, plus deeper sections for sleep analysis, workouts, comparisons against general population benchmarks, and a drill down view for every type of metric it syncs, from daily step counts to minute by minute heart rate during workouts. It also runs an insights engine that looks for trends, unusual spikes, training load imbalances, sleep debt building up over two weeks, and links between different metrics, always describing these as associations rather than claiming one thing causes another. A notable feature is a built in AI coach you can chat with about your own data. It can pull up charts, compare stats, and explain your recent workouts or sleep, and it remembers ongoing details you mention, like an injury or an upcoming event, bringing them into later conversations. After each sync it also writes a short daily summary of what changed, and on Sundays a weekly review. Notably, the coach does not do any of its own math. It calls a fixed set of tools that read from the same deterministic engine used elsewhere in the app, so the numbers it discusses are always the same ones computed by the dashboard itself. The project runs on a Next.js frontend and a FastAPI backend, using a command line AI tool the user is expected to already be logged into for free language model access, so no separate AI subscription cost is required. It is built for one person's personal use, syncing only your own account, and is not intended to be run as a shared or public service.

prompts (copy fr)

prompt 1
Explain how the AI coach avoids doing its own math when answering questions about my data.
prompt 2
Walk me through setting up the Google Health API sync for my Fitbit or Pixel device.
prompt 3
How are the readiness and sleep scores calculated, and where do the thresholds come from?
prompt 4
What happens during the weekly retrospective compared to the daily briefing?

Frequently asked questions

what is fettle fr?

A self hosted dashboard that syncs your own Fitbit or Pixel health data locally and adds a transparent readiness engine plus a free AI health coach.

What language is fettle written in?

Mainly Python. The stack also includes Python, FastAPI, Next.js.

What license does fettle use?

The explanation does not mention a license, so terms of reuse are unclear.

How hard is fettle to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is fettle for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.