Calorie Visualizer for Openclaw

A local-first nutrition tracking skill that logs meals and automatically generates visual progress reports.

vintlin
v1.0.0
Feb 17, 2026
2
1.5k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install calorie-visualizer

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install calorie-visualizer using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Calorie Visualizer?

Calorie Visualizer is a specialized utility for Openclaw Skills designed to simplify nutritional tracking without compromising privacy. It enables users and AI agents to log food intake, track macronutrients, and generate high-quality visual summaries locally. By leveraging a local SQLite database and an image rendering engine, it provides a seamless feedback loop for health monitoring directly within a developer-centric workflow.

The skill is built to be flexible, supporting manual calorie entry, local food database lookups, and optional online API fallbacks. Its primary goal is to turn raw meal data into actionable visual insights while keeping all sensitive health information on the user's local machine.

Calorie Visualizer Use Cases

  • Tracking daily caloric and protein intake through simple CLI commands or AI interactions.
  • Generating visual nutrition reports to monitor fitness progress over time.
  • Managing nutritional goals based on Total Daily Energy Expenditure (TDEE) derived from user profiles.
  • Logging meals with photo attachments for a more comprehensive food diary.

How Calorie Visualizer Works

  1. The user provides meal details or a photo to the agent, which extracts calories and protein values.
  2. The skill invokes the add or add-food command to write the data into a local SQLite database.
  3. Upon every successful log, the visual_renderer.py script is triggered to generate an updated report image using html2image.
  4. The CLI returns the path to the generated image, enabling the interface to display a visual summary of the day's nutrition.

Calorie Visualizer Setup

To get started with this component of your Openclaw Skills library, follow these steps:

# Navigate to the skill directory
cd skills/calorie-visualizer

# Install the necessary Python dependencies
python3 -m pip install -r requirements.txt

# Ensure Chromium or Chrome is installed on your system for the renderer

Note: For online food lookups, you can optionally configure a USDA_API_KEY in your environment.

Calorie Visualizer Data Schema & Taxonomy

The skill manages data locally using a structured approach to ensure portability and privacy:

Component Format Description
calorie_data.db SQLite The primary storage for meal logs, timestamps, and nutritional values.
config Key-Value Stores daily goals and user preferences regarding profile data usage.
USER.md Markdown Optional source for deriving TDEE and personalized health targets.
Report Images PNG/JPG Transient visual files generated by the renderer for UI display.

Calorie Visualizer Advanced Features

  • Automatic TDEE calculation by sourcing user profile data from local markdown files.
  • Multi-mode food lookup supporting local-first queries with optional online fallbacks.
  • Automated visual refresh cycles that trigger immediately after data entry.
  • Configurable privacy settings to allow or restrict the use of personal profile data for goal setting.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*