37 lines
1.2 KiB
Markdown
37 lines
1.2 KiB
Markdown
# 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.
|