FreeHarmony
Measure your facial proportions with real geometry — private, free, and fully in your browser

How to install FreeHarmony
Every step written out, for people who have never opened a terminal. Pick the setup you have.
README
Open in GitHubFreeHarmony
Free, open-source facial harmony analysis. Every metric. No paywall. Ever.
FreeHarmony measures your facial proportions — canthal tilt, midface ratio, jaw-to-cheekbone width, symmetry, and a dozen more — using real landmark geometry that runs entirely in your browser. It exists because the app it replaces charges $4.99/week to show you numbers your own webcam already computed, teases you with a flattering fake score, and then reveals a lower "real" one when you decline to pay.
We think that's garbage. So:
- Everything is free. Every metric, every sub-score, the full report, side profile, scan history. There is no Pro tier because there is no tier.
- The score is math, and only math. Deterministic geometry from MediaPipe face
landmarks. Same photo in, same score out — auditable in
packages/engine, which has no dependencies and 100% reproducible tests. - Your face never leaves your device. Landmarking and scoring are fully client-side. The only thing that can ever leave your browser: an AI second-opinion call to a provider you configure (your local Ollama, or your own Claude key). Off by default.
- No dark patterns. One honest score, shown once. If your photo is too blurry or turned too far, we tell you to retake it instead of guessing.
How scoring works
- MediaPipe Face Landmarker (WASM, in-browser) finds 478 facial landmarks.
packages/enginenormalizes them (de-mirror, pixel-space, roll-correction) and refuses photos it can't measure honestly (excessive yaw/pitch, blur, occlusion, closed eyes).- Seventeen metrics are computed from published facial-aesthetics conventions, each scored against an ideal band with a smooth falloff curve, then rolled up into four area scores and one Harmony %.
- Optionally, a vision model you control cross-examines the landmarks ("did the jaw point land on an ear?") and can flag a scan as unreliable — it can never change the score.
Scores are photo-based estimates for entertainment and self-improvement, not clinical measurements — lighting, lens distance, and pose all move the numbers. The app says this in-product, and the advice engine hard-refuses surgical/medication coaching and actively discourages dangerous community practices.
License
AGPL-3.0. Use it, fork it, ship it — but if you serve a modified version to users, you must publish your source. Paywalling a fork of the anti-paywall app should at least be embarrassing in public.