README file from
Github🍽️ AI Nutrition Tracker for Obsidian
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
- Install: Add to your Obsidian plugins folder and enable
- Configure: Set your OpenRouter API key and nutrition goals
- Track: Use the nutrition tracker icon or command palette
- Describe: Type what you ate or upload a photo
- 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}.mdand 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.