Skip to content

Repository files navigation

Chompass icon

Chompass

Ad-free AI calorie tracker: Android app and browser PWA

Bring your own cloud AI key on either client. On the Android app you can also run Gemma 4 on-device. Fork of Fud AI with no ads and no analytics.

Website · Download · Web app · Privacy

Latest release PWA Android License: MIT Privacy

Log food with a photo, voice, barcode, share intent, or typed note. Use your own cloud AI key, or download Gemma 4 once for on-device analysis in the Android app. No ads, no account, no analytics. Open diary and body-metrics exports on both clients; Health Connect for scales and wearables in the Android app.

Use the installable PWA in any modern browser (Chromium-based browsers work best for install, camera barcode, and speech) or the Android APK. Both use the same diary and body-metrics JSON contracts; there is no cloud sync between clients. Health Connect, widgets, notifications, on-device AI, and full i18n are Android-app features. Project home: codeberg.org/fitguy/chompass.

Install

Web app (PWA)

Open chompass.app/app/ in any modern browser (phone, tablet, or desktop). It is a progressive web app you can install to the home screen or dock. Diary logging, progress, BYOK AI entry and Coach, and shared JSON export/import with the Android app.

Works in Firefox, Safari, and other engines; Chromium-based browsers (Chrome, Edge, Brave, Cromite, etc.) generally have the smoothest install prompt, camera barcode, and Web Speech support.

Step-by-step install for iOS, Android, and desktop browsers: Download → How to install (also Settings → Install app inside the PWA).

Android app

Not on the Play Store. F-Droid metadata is submitted; until the package shows up in the F-Droid client, install from Obtainium or Codeberg Releases.

Get it on Obtainium

Codeberg Releases

  • Obtainium (recommended): tap the badge above, then confirm in Obtainium. Or paste https://codeberg.org/fitguy/chompass into Add App.
  • Direct APK: download from Codeberg Releases. Prefer arm64-v8a on modern phones; use armeabi-v7a for older 32-bit devices, x86_64 for emulators/Chromebooks, or universal only when unsure.
  • F-Droid: package app.chompass (expected listing once indexed).

Release package ID: app.chompass. Debug (from source): app.chompass.debug.

Screenshots

Material 3 dark theme (light theme also available). Images are in docs/screenshots/.

Home screen in dark theme
Home: calorie ring, macros, meals
Progress screen in dark theme
Progress: weight, steps, goals
Add food sheet in dark theme
Add food: photo, voice, barcode, AI
AI Coach in dark theme
Coach: chat with your provider key
Settings screen in dark theme
Settings: diet modes, Health Connect
Home screen in light theme
Home (light): same dashboard, light theme

Features

Shared on the PWA and Android app unless noted:

  • Food logging: multi-photo (up to 10), share into the app (Android), voice, barcode (FOSS zxing-cpp on Android; browser / Open Food Facts on web), text, manual entry, saved meals, draft recovery
  • AI: cloud BYOK (a free Google AI Studio key is enough for casual use). On Android: opt-in On-Device (Private) Gemma 4 via LiteRT-LM, optional fallback provider. AI Coach chat on both clients.
  • Progress: weight, body fat, measurements, forecast. Health Connect (Android): steps, exercise, wellness; two-way sync with Gadgetbridge, openScale, and other Health Connect apps
  • Diet & extras: keto and other diet modes, water tracking. Android: home-screen widgets, 15 languages (web is EN-first)
  • Open data: diary export (JSON / Markdown / CSV), weight and body-metrics import/export, bulk JSON import, meal share links (chompass:// on Android; hash URL on web)
  • Size (Android): ~15 MiB arm64 / ~27 MiB universal; no ads, analytics, or workout library (releases)

Why Chompass

Chompass forked Fud AI in July 2026 when upstream briefly shipped AdMob banners (removed again in 3.0.3). This fork stays ad-free, ships an Android app and a browser PWA, keeps a smaller APK, and adds open export/import plus Health Connect. It does not try to match upstream feature for feature.

Priorities: privacy (PRIVACY.md), FOSS barcode scanning, open data, wearables via Health Connect, lean F-Droid / Codeberg distribution (Play flavor disabled; see docs/DISTRIBUTION.md), and a data-compatible PWA for any modern browser.

See CHANGELOG.md for release notes.

On-device AI (private)

Android app. Settings → AI Provider → On-Device (Private) runs food logging AI on your phone. No API key, no account, and nothing sent to a cloud provider for text or photo analysis.

Models Gemma 4 Edge (E2B ~2.4 GB or E4B ~3.4 GB), downloaded once from Hugging Face
What stays local Food text and photo analysis when logging meals
Requirements arm64 or x86_64, 6 GB+ RAM (hidden on unsupported devices)
Accuracy On-device models are much smaller than cloud AI and often misread portions, brands, and photos. Cloud AI is still the better default.
Fallback Enable Fallback Provider so a cloud model retries when on-device inference fails

Coach chat still needs a cloud provider. Added in v1.14.0.

Health Connect

Android app. Chompass uses Android Health Connect. No vendor SDKs, no accounts. Anything that syncs into Health Connect works with Chompass:

Companion What it brings Notes
Gadgetbridge Steps, exercise, weight from wearables FOSS; enable Settings → External Integrations → Health Connect
openScale Weight and body composition from Bluetooth scales FOSS, on F-Droid
Samsung Health, Fitbit, Withings, etc. Weight, activity, energy burn Via each app's Health Connect sync
Direction Data
In Weight and body fat (live), meals from other apps, steps and exercise, sleep / resting HR / hydration, active/total energy burn
Out Every meal as a full NutritionRecord, plus weight, body fat, and height

Optional background sync (Settings → Health & Data, off by default) checks Health Connect every few hours when Chompass is closed.

Huawei Health users: pair your wearable with Gadgetbridge instead. Huawei Health Kit requires an HMS account and is not supported.

Migrate from Fud AI

Path Steps
A: File export In Fud AI, export your food diary as JSON. In Chompass (Android or web), open Settings → Import Food Diary JSON
B: Health Connect Enable Health Connect in both apps and grant read permissions (Android)

Settings → Import Weight & Body Data also accepts Chompass JSON/CSV, openScale CSV, and common weight CSVs. Body-circumference sites have no Health Connect record type, so use file transfer for those.

Fud AI vs Chompass Android vs Chompass PWA

Feature Fud AI Chompass Android Chompass PWA
Banner ads Brief AdMob; removed in 3.0.3 Never shipped Never shipped
On-device AI (Gemma 4) No Yes (opt-in) No (BYOK cloud)
Barcode ML Kit FOSS zxing-cpp Browser / OFF
Workouts library Yes (~120 MB APK) Omitted (~15 MiB arm64) Omitted
Keto / diet modes No Yes Yes
Health Connect Partial Steps, exercise, sleep, HR, hydration No
Widgets / notifications Upstream set Yes No (installable PWA)
Languages Upstream 15 EN-first
Distribution Play-focused Codeberg / Obtainium / F-Droid PWA in any modern browser (/app/)
Open diary / body JSON Upstream formats Yes Same contracts as Android

Sources: Fud AI releases, Chompass releases. Capability matrix for maintainers: docs/PARITY.md.

How accurate is the AI?

Chompass is BYOK, so accuracy depends on the model you pick. The app does not claim a single number. We benchmark against labeled datasets and publish the results. Typed entry is close to solved (5.7% WMAPE, 90% within ±20% of true calories). Photo estimation is hard for every vision model tested (best paid model: 32.3% WMAPE, 50% within ±20%), which is why a portion-clarification feature is in progress. Full numbers and methodology: docs/ACCURACY.md.

Performance

  • Install size: no workouts bundle or ad SDK; arm64 ~15 MiB, universal ~27 MiB
  • Food log I/O: monthly diary buckets for large histories
  • UI: off-main-thread entry thumbnails; Progress screen worst-frame latency cut from ~1.1s to ~0.5s in our debug baseline
  • AI uploads: image downscaling before provider requests

Docs & privacy

Guides, changelog, F-Droid draft metadata, and food-accuracy benchmarks live under docs/. Accuracy stats: docs/ACCURACY.md.

No ads, analytics, or tracking SDKs. Food logs, body metrics, and Coach chat stay on-device unless you export them or sync through Health Connect. Cloud AI requests go only to the provider you configure (BYOK). API keys are encrypted at rest (Android Keystore / EncryptedSharedPreferences on Android; Web Crypto AES-GCM in the PWA) and are not sent to a Chompass server. On-Device (Private) keeps food analysis on the device. See PRIVACY.md.

Attribution & license

Chompass is based on Fud AI.

  • Copyright (c) 2026 Apoorv Darshan - MIT License
  • Modifications Copyright (c) 2026 fitguy - MIT License

See also NOTICE and ASSET_CREDITS.md.

About

<Mirror> Ad-free AI calorie tracker — mirror of the canonical repo, hosted on Codeberg.

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages