Download

Two ways to use Chompass: the installable browser PWA, or the Android app. Same diary and body-metrics JSON contracts; no cloud sync between clients.

Web app (PWA)

Open the Chompass web app in any modern browser on phone, tablet, or desktop. Install it to the home screen or dock for quicker access. Diary logging, progress charts, AI food entry and Coach with your own key, and shared JSON export/import with the Android app.

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

Android-app features not on the PWA: Health Connect, home-screen widgets, notifications, and on-device Gemma 4.

How to install

iPhone / iPad (Safari)

1. Open Chompass in Safari (required for a true home-screen app).
2. Tap Share (square with an upward arrow).
3. Choose Add to Home Screen, then Add.
4. Open from the home-screen icon (not a Safari tab) for the full-screen app.

Chrome or Firefox on iOS still use Safari’s share sheet for home-screen install. Diary and body-metrics exports use the system Share sheet when available (Save to Files / AirDrop).

Android (Chrome, Edge, Brave)

1. Open the browser menu (⋮).
2. Tap Install app or Add to Home screen.
3. Confirm, then open Chompass from the new icon.

Many Chromium browsers do not show an automatic install popup. Use the menu. In the PWA itself you may also see an Install banner when the browser allows it.

Desktop (Chrome / Edge)

1. Look for the install icon in the address bar, or open the browser menu.
2. Choose Install Chompass (or Install app).
3. Launch from your dock, taskbar, or app launcher.

Firefox (Android)

1. Tap the Firefox menu (⋮).
2. Tap Add to Home screen or Add app to Home screen.
3. Confirm, then open from the new icon.

Firefox has no in-page install popup. If the menu item does nothing, set a Home app under Android Settings → Apps → Default apps (it must not be “None”). Desktop Firefox: bookmark the page; full PWA install is limited.

DuckDuckGo (Android)

DuckDuckGo does not fully support PWA install. Menu → Add to Home may create a shortcut only, and on some launchers it does nothing. For a full-screen installed app, open the web app in Chrome, Edge, or Brave instead.

Already installed? Open Chompass from the home-screen or dock icon (not a normal browser tab) for the full-screen shell. In the app: Settings → Install app.

Android: F-Droid (recommended)

Package app.chompass (listing). Install from the F-Droid client; updates arrive through F-Droid automatically. Not on the Play Store.

Android: Obtainium (auto-updates)

That confirms the Codeberg app source, then keeps you updated from releases.

Or paste https://codeberg.org/fitguy/chompass into Obtainium’s Add App screen.

Android: Direct APK

Latest arm64 (most phones): Chompass-fdroid-4.7.0-arm64-v8a.apk (~17 MiB).

All builds, checksums, and release notes: Codeberg Releases (v4.7.0).

Package ID: app.chompass

After install

1. Complete onboarding (profile and goals).
2. For cloud AI: add a provider key under Settings → AI & Speech (a free Google AI Studio key works for casual use).
3. On the Android app, for private on-device analysis: Settings → AI & Speech, then On-Device (Private), and download Gemma 4 once.
4. Skim the settings guide to tune trackers, reminders, and AI.

Migrate from Fud AI

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

Weight and body data also import via Settings → Import Weight & Body Data (Chompass JSON/CSV, openScale CSV, and common weight CSVs).

Support the project

Chompass is free, ad-free, and open source. If it helps you reach your goals, you can buy fitguy a yogurt on Ko-fi. Every yogurt keeps the project going.

Source and issues: codeberg.org/fitguy/chompass.