danvics/calorie-ai-android
1
0
Fork 0
Code Issues Pull requests Projects Releases 8 Packages Wiki Activity Actions
Android calorie tracker with AI meal analysis
11 commits 1 branch 13 tags 944 KiB
Kotlin 40.4%
Svelte 34.9%
JavaScript 23.3%
Java 0.5%
CSS 0.5%
Other 0.3%
Find a file
Daniel 5837b1c8dc
All checks were successful
Android CI / build (push) Successful in 28s
Details
Web CI / test (push) Successful in 48s
Details
Revamp web app with Svelte and Tailwind
2026-05-19 18:53:03 +02:00
.forgejo/workflows Add web auth and app navigation 2026-05-19 17:59:02 +02:00
app Add web calorie tracker and analytics 2026-05-19 17:13:41 +02:00
web Revamp web app with Svelte and Tailwind 2026-05-19 18:53:03 +02:00
.gitignore Add web auth and app navigation 2026-05-19 17:59:02 +02:00
build.gradle Add Calorie AI Android app 2026-05-17 17:43:16 +02:00
README.md Add web auth and app navigation 2026-05-19 17:59:02 +02:00
settings.gradle Add Calorie AI Android app 2026-05-17 17:43:16 +02:00

README.md

Calorie AI

Native Android and Dockerized web calorie tracker with uploaded meal images and admin-configurable AI models.

Features

  • Add meals by description, portion estimate, and uploaded image.
  • Analyze meals through OpenAI-compatible chat completions.
  • Uses a vision model for food image calorie and portion estimates.
  • Uses a tasking model to normalize calories, protein, carbs, fat, fruit servings, vegetable servings, food groups, and notes.
  • Stores daily meal entries locally on Android or in browser local storage.
  • Shows daily totals plus charts for macros, 7-day calories, and fruit/vegetable intake.
  • Admin settings control API base URL, API key, vision model, and tasking model. The two model fields can contain the same model name.

Android Build

Open this folder in Android Studio and run the app configuration, or build with Gradle if available:

gradle :app:assembleDebug

Forgejo Actions builds the debug APK on every push to main and uploads it as the calorie-ai-debug-apk artifact.

Tagged versions also build an installable APK named calorie-ai-vX.Y.Z.apk through the Android Release workflow.

Web Frontend

The web frontend lives in web/. It serves an authenticated browser UI and a tiny Node proxy at /api/chat so OpenAI-compatible endpoints are called server-side instead of directly from the browser.

Run it with Docker:

cd web
docker compose up -d --build

Then open:

http://127.0.0.1:8095

The Docker web server creates credentials on first boot in web/data/auth.json if CALORIE_AI_WEB_PASSWORD and CALORIE_AI_SESSION_SECRET are not supplied. To pin credentials, copy web/.env.example to web/.env and set strong values before starting Docker Compose.

AI Endpoint

The app expects an OpenAI-compatible endpoint at:

{API base URL}/chat/completions

Example base URLs:

  • https://api.openai.com/v1
  • An emulator host-loopback URL ending in :11434/v1 for a local OpenAI-compatible service

Default admin PIN is admin. Change it in the Admin AI Settings panel after first launch.

The web frontend stores AI settings in browser local storage after web login. The web login is separate from the Android admin PIN.