Beginner guide
From install to
first meal log
Follow this once. After that you’ll mostly live on the Today tab — snap, review, save.
What is FitBuddy?
FitBuddy is a free, open-source Android app for tracking food and exercise. You describe a meal with a photo or plain text; an AI you configure estimates calories and macros. Region packs personalise prompts, staples, portion language, and log examples so estimates match how you actually eat — change your region anytime in Settings.
Install
Pick one channel and stick to it (signing keys differ):
- F-Droid
- OpenAPK
- GitHub APK (arm64)
Needs Android 10 or newer.
First-run setup
- Open FitBuddy → start fresh, or restore a backup if you have one.
- Optionally connect an AI provider (OpenRouter is the easiest free option).
- Set profile basics: sex, age, height, weight, activity, goal.
- On some builds you’ll see a short crash reporting opt-in (anonymous; off by default on F-Droid / debug).
- Choose your region pack — this personalises food examples and AI priors. You can change it later under Settings → Preferences.
- Land on Today — your daily calorie ring and log.
No AI key? The offline simulator still lets you explore the logging UI.
Need hand-holding for API keys (OpenRouter, Gemini, Ollama, OpenAI) with official links and videos? Use the dedicated onboarding guide — the same page the app opens from Open onboarding guide.
Adult calorie and macro targets are calculated on-device and do not require AI. See the calculation methodology for the formulas, activity factors, optional scale-trend rules, and safeguards.
Log food
- Tap the log / + action and choose food.
- Take a photo of the plate, type a freeform description (hints match your region pack), or scan a barcode for packaged foods.
- Wait for analysis, then open meal review.
- Fix the dish name, drag ingredient weights, confirm macros feel right.
- Save. Bookmark as a preset if you’ll eat it again.
Barcode lookups use Open Food Facts after on-device decode. If a product is missing, FitBuddy can walk you through contributing it so later scans succeed.
You can always edit a past entry from the day log.
Log workouts
Log a session with AI (e.g. “45 min walk”) or build a structured workout from the 1,500+ exercise catalog — demo GIFs, favourites, body-part and equipment filters, recent and frequent picks, and long-press to pin filter order.
Structured sessions estimate calorie burn offline with a MET formula (your body weight × intensity × duration). Simple AI logs can be upgraded into full editable sessions later; editing still shows the demo GIF when available.
Calorie & macro targets
Enter targets manually, or calculate adult candidates on-device from your profile, activity, and goal. Consistent body and nutrition trends may support one bounded adjustment; optional AI can only pick an exact local candidate.
When you change a goal, past days keep the targets they had — history charts stay honest. Full formulas: health target methodology.
Progress
The Progress tab shows weekly or rolling 30-day calorie intake vs target, body charts toward your target weight, and a compact six-month calorie-burn heatmap — all drawn on-device. Optional Progress Coach can summarize patterns using your AI provider.
AI providers
Configure under Settings:
| Provider | Notes |
|---|---|
| OpenRouter | Free vision models; optional account sign-in |
| Gemini | Google AI Studio key |
| Ollama | Local LAN or Ollama Cloud |
| OpenAI-compatible | Official OpenAI, LM Studio, vLLM, LocalAI, Together, Groq, etc. |
Keys stay in on-device DataStore. They are only sent to the provider you selected when you run an analysis.
Backups
Export an encrypted JSON backup anytime. Optional cloud backup uses your Support ID and AES-256-GCM — details on the encryption page.
Support the developer
Optional donations route by region — Razorpay (UPI/cards) in India, GitHub Sponsors internationally. Named supporters appear on flip thank-you cards in the app and on the Supporters page. An occasional support reminder turns off automatically when your Support ID is on the public supporter list.
For release notes, questions, and chat with the developer, join the public Telegram group.
Tips
- Well-lit photos of the whole plate work better than close-ups of one bowl.
- Presets beat re-analyzing the same breakfast every day.
- Favourite exercises and pin filters once — the workout picker gets out of the way.
- Pick the region pack that matches your usual meals for better priors and portion language.
- F-Droid installs can check for updates from inside the app; GitHub APKs use the release checker.
- Turn on reminders in Settings if you forget to log.
- Crash reports are optional and anonymous — opt out anytime.