AI Nutrition Tracker

Transform your nutrition tracking with AI-powered food analysis. No more tedious forms or manual calculations - just describe what you ate or snap a photo, and let AI handle the rest.

✨ What It Does

Smart Food Logging: Describe your meals in natural language or upload photos, and AI automatically extracts nutrition data and creates beautiful food logs in your Obsidian vault.

📝 Text Input

"2 slices whole wheat toast with avocado and a cup of coffee"
"Large Caesar salad with grilled chicken"
"Homemade chocolate chip cookies, about 3 medium ones"

📷 Image Input

Upload photos of your meals for visual analysis - perfect for complex dishes or when you want extra accuracy.

🍽️ Saved Meals

Save your favorite meals for quick reuse! Perfect for:

• Daily breakfast routines
• Regular lunch orders
• Frequent snacks
• Meal prep portions

Create a meal once, then add it to future logs with a single click.

🤖 AI Analysis

Choose from powerful models like Gemini, Claude 4.5 Sonnet, GPT-5 to analyze your food and extract:

• 🔥 Calories
• 💪 Protein
• 🌾 Carbohydrates
• 🥑 Fat

🎨 Beautiful Food Logs

Light Theme

Dark Theme

🚀 Getting Started

1. Install: Add to your Obsidian plugins folder and enable
2. Configure: Set your OpenRouter API key and nutrition goals
3. Track: Use the nutrition tracker icon or command palette
4. Describe: Type what you ate or upload a photo
5. Done: AI creates your food log automatically

⚙️ Quick Setup

Required

• OpenRouter API key (get one at openrouter.ai)
• Choose your AI model or choose a custom one from https://openrouter.ai/models

Optional

• Set daily nutrition goals
• Pick progress bar style (Emoji dots, Modern bars, or Percentage)

💡 Usage Tips

Text Input Works Best With:

• Specific portions: "2 slices", "1 cup", "large bowl"
• Cooking methods: "grilled", "baked", "fried"
• Brand names: "Cheerios", "Starbucks latte"

Image Input Perfect For:

• Restaurant meals
• Complex homemade dishes
• Packaged foods with labels
• When you want extra accuracy

Saved Meals Save Time:

• Save meals you eat regularly
• Edit saved meals to adjust portions
• Quickly log repeated meals without re-describing them
• Perfect for meal prep and routine eating

🗄️ How Data Is Stored

Your data lives in your vault, in plain JSON — the rendered notes are a view, not the source of truth:

• Saved meals: {meal folder}/meals.json
• Daily food logs: {log folder}/.data/{YYYY-MM-DD}.json
• Rendered notes: {log folder}/{YYYY-MM-DD}.md and one note per saved meal. Both are regenerated from the JSON above whenever you add, edit, or delete something. The generated cards and progress summary live between %% ntr:begin %% / %% ntr:end %% markers — any text you write above or below that region is preserved across edits.

⚠️ Since 3.0.0: editing the food cards or description in a meal note by hand no longer syncs back — meal notes are a one-way render of meals.json. Renaming a meal note in the file explorer still updates the meal's name. See CHANGELOG.md for the full list of breaking changes and how upgrading from 2.x works (it's automatic — the plugin migrates your existing food log notes into the JSON store the first time it loads, and backs up each note's original content to {log folder}/.data/backup-{date}.md before rewriting it).

🎯 Features

• 🤖 Multiple AI models (Claude, GPT, Gemini)
• 📝 Natural language food descriptions
• 📷 Photo analysis for meals
• 🍽️ Save and edit meals for quick reuse
• 🎨 Beautiful card or simple layouts
• 🌙 Light and dark themes
• 📊 Visual progress tracking
• 📁 Automatic file organization

Transform your nutrition tracking experience - no more tedious logging, just natural descriptions and beautiful results.

For issues, questions, or feature requests, please create an issue on GitHub.