Skill: wisediag/wisediag-calories (version 1.0.0)

--- name: wisediag-calories description: "Food Calorie Estimator — Identify food items and estimate calories from an image (via local file binary upload or image URL) with AI-powered recognition. Triggered when the user asks to estimate food calories and provides a local image file path or image URL. Can also be invoked explicitly: say 'Use WiseDiag Calories to analyze this'." registry: homepage: https://github.com/wisediag/WiseDiag-Calories author: wisediag env_vars: - WISEDIAG_API_KEY credentials: required: true --- ## When to Use This Skill Activate this skill when any of the following conditions are met: - The user provides **local image files** of food and asks to estimate calories - The user sends an **image URL** of food and asks to estimate calories - The user says things like "how many calories is this", "estimate calories", "analyze this food photo", or similar requests (in any language) **Note:** This skill supports both **local file uploads** (binary stream) and **image URLs**. The most common usage scenario is **uploading local files via binary stream** (`--file`), as users typically have food photos saved on their device rather than hosted at a public URL. **How to choose (mutually exclusive — pick one):** - If the user provides a **local file path** (e.g. `/home/user/food.jpg`, `C:\Users\...\meal.png`) → use `--file` (binary upload). **This is the primary and most common usage.** - If the user provides a **URL** (starts with `http://` or `https://`) → use `--image` - Do NOT use `--file` and `--image` together in one command --- # ⚠️ Privacy Notice **Please read before installing:** This tool transmits your food image files **to WiseDiag cloud servers** (via direct binary upload or image URL) for AI analysis. **Do not upload images containing sensitive or private content** unless: - You trust WiseDiag's data handling policy - You accept that the file content will be transmitted to and processed remotely **The output of this tool is for reference only and does not constitute professional nutritional or dietary advice. Please consult a qualified nutritionist for specific dietary needs.** --- # WiseDiag Food Calorie Estimator (OpenClaw Skill) Upload photos of food (meals, snacks, beverages, etc.) and let WiseDiag AI automatically identify food items, estimate calories and nutritional content per serving. ## Installation ```bash pip install -r requirements.txt ``` ## 🔑 API Key Configuration (Required) **Get your API Key:** 👉 [https://console.wisediag.com/apiKeyManage](https://s.wisediag.com/xsu9x0jq) The API key MUST be set as an environment variable. The script reads it automatically. ```bash export WISEDIAG_API_KEY=your_api_key ``` ## Usage (Step-by-Step) **Do not call any API or HTTP endpoints directly — use only the script below.** **⚠️ IMPORTANT: The script makes HTTP requests to an external API and may take 30-120 seconds to complete (especially for large images). Do NOT kill or interrupt a running command — wait for it to finish. The script prints streaming output so you can see it is working.** There are two ways to analyze food — pick one (mutually exclusive): --- **Option A: Upload local files (recommended)** — when user provides local file paths ```bash cd scripts # Single food image python3 calories.py -f "/path/to/food.jpg" # Multiple images (e.g. multiple dishes, max 5) python3 calories.py -f "/path/to/dish1.jpg" -f "/path/to/dish2.jpg" # Ask a specific question python3 calories.py -f "/path/to/food.jpg" --question "这顿饭大概多少卡路里？" # Specify output filename python3 calories.py -f "/path/to/food.jpg" -n "lunch_20260324" ``` --- **Option B: Submit via image URL** — when user provides a public HTTP/HTTPS link ```bash cd scripts # Single image URL python3 calories.py --image "https://example.com/food.jpg" # Multiple images python3 calories.py --image "https://example.com/dish1.jpg" --image "https://example.com/dish2.jpg" # Ask a specific question python3 calories.py --image "https://example.com/food.jpg" --question "How many calories is this meal?" ``` --- **How to choose (mutually exclusive — pick one):** - User gives a local file path (e.g. `/home/user/food.jpg`, `C:\Users\...\meal.png`) → use `-f` - User gives a URL (starts with `http://` or `https://`) → use `--image` - Do NOT use `-f` and `--image` together in one command Results are automatically saved to `~/.openclaw/workspace/WiseDiag-Calories/{name}.md` — no manual saving needed. ## Parameters | Parameter | Description | |-----------|-------------| | `-f, --file` | Local file path to upload as binary stream — image, repeatable up to 5 times (mutually exclusive with --image) | | `--image` | Public URL of the food image, repeatable up to 5 times (mutually exclusive with --file) | | `--question` | Question to ask (default: estimate calories of the food in the image) | | `-n, --name` | Output filename (without extension) | | `-o, --output` | Output directory (default: ~/.openclaw/workspace/WiseDiag-Calories) | ## FAQ **"WISEDIAG_API_KEY is not set" error:** Verify the environment variable is set correctly by running `echo $WISEDIAG_API_KEY`. **"Authentication failed" error:** Your API Key may be invalid or expired. Visit [console.wisediag.com](https://s.wisediag.com/xsu9x0jq) to check or regenerate it. **"File not found" error:** The local file path provided via `-f` does not exist. Check the path and try again. **Image not recognized:** Ensure the image is in JPG, JPEG, or PNG format. Photos should be clear and well-lit for best results. ## Data Privacy - **File upload mode (`-f`)**: Local files are uploaded as binary streams via multipart/form-data to WiseDiag's server for processing. - **URL mode (`--image`)**: Image URLs are transmitted to WiseDiag cloud servers; their server downloads and processes them. Image content is not permanently stored. Results are returned directly to you. ## ⚠️ Disclaimer The output of this tool is for reference only and does not constitute professional nutritional or dietary advice. Always consult a qualified nutritionist for specific dietary needs. ## License MIT


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal:  | SkillSpector: suspicious (MEDIUM)