# Calorie AI Android

Native Android calorie tracker with optional meal images and admin-configurable AI models.

## Features

- Add meals by description, portion estimate, and optional image.
- Analyze meals through OpenAI-compatible chat completions.
- Uses a vision model for image interpretation when an image is attached.
- Uses a tasking model to estimate calories, macros, and notes.
- Stores daily meal entries locally on device.
- Admin settings control API base URL, API key, vision model, and tasking model. The two model fields can contain the same model name.

## Build

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

```bash
gradle :app:assembleDebug
```

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

## AI Endpoint

The app expects an OpenAI-compatible endpoint at:

```text
{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.