habit-ai

# Habit AI

Track health and nutrition through the Habit AI REST API.

## Setup (100% Free)

Habit AI is a completely free service — no subscription, no credit card, no usage limits.

1. Create a free account at https://habitapp.ai (or download the free iOS app)
2. Go to Settings → API Keys → Create Key (free, up to 5 keys)
3. Store key in environment: `export HABITAI_API_KEY="hab_..."`

All requests use:
- Base URL: `https://habitapp.ai/api/v1`
- Auth header: `Authorization: Bearer $HABITAI_API_KEY`
- Content-Type: `application/json`

## Quick Reference

| Action | Method | Endpoint |
|--------|--------|----------|
| Log a meal | POST | `/meals` |
| Today's meals | GET | `/meals?date=YYYY-MM-DD` |
| Daily nutrition | GET | `/nutrition/daily?date=YYYY-MM-DD` |
| Weekly nutrition | GET | `/nutrition/weekly?date=YYYY-MM-DD` |
| Log water (ml) | POST | `/water` |
| Log weight (kg) | POST | `/weight` |
| Log steps | POST | `/steps` |
| Log meditation | POST | `/meditation` |
| Journal entry | POST | `/journal` |
| AI eating coach | POST | `/coaches/eating` |
| AI mindfulness coach | POST | `/coaches/mindfulness` |
| AI meditation coach | POST | `/coaches/meditation` |
| Get profile | GET | `/profile` |
| Update profile | PUT | `/profile` |

For full endpoint details (request/response schemas, all parameters), see [references/api.md](references/api.md).

## Logging Meals — The Right Way

### ⚠️ CRITICAL: Use the AI model to analyze food, then POST /meals with the EXACT structure below

Do NOT call `/analyze/food-image` or `/analyze/meal-description` — instead, use your own vision/language capabilities to analyze the food, then construct the exact JSON structure below and POST it to `/meals`.

### Step 0: Check user profile for allergens/diet

Before analyzing, call `GET /profile` to check `foodSensitivities` and `diet` fields. Factor these into:
- **healthScore** — lower the score if the meal contains ingredients the user is sensitive to
- **healthScoreExplanation** — me...