release: merge develop into main for v0.20.1

Author: DavidsonGomes

CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.20.1] - 2026-04-13
+
+### Added
+
+- **Image generation cost estimates** — each image in the Costs page now shows an estimated USD cost based on model pricing (Gemini Flash $0.039/img, FLUX.2 $0.03/img, GPT-5 Image $0.04/img, etc.). Total image cost shown in section header and included in the "Total (All)" KPI card
+
 ## [0.20.0] - 2026-04-13
 
 ### Added

cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evoapi/evo-nexus",
-  "version": "0.20.0",
+  "version": "0.20.1",
   "description": "Unofficial open source toolkit for Claude Code — AI-powered business operating system",
   "keywords": [
     "claude-code",

dashboard/backend/routes/routines.py

@@ -84,9 +84,45 @@ def list_adws():
     return jsonify(scripts)
 
 
+# Pricing per model for image generation (USD)
+# Format: { model_substring: { per_image: float, input_per_1m: float, output_per_1m: float } }
+IMAGE_MODEL_PRICING = {
+    "gemini-3.1-flash-image-preview": {"per_image": 0.039, "input_per_1m": 0.075, "output_per_1m": 0.30},
+    "gemini-2.0-flash": {"per_image": 0.039, "input_per_1m": 0.10, "output_per_1m": 0.40},
+    "flux-2": {"per_image": 0.03, "input_per_1m": 0, "output_per_1m": 0},
+    "flux.2": {"per_image": 0.03, "input_per_1m": 0, "output_per_1m": 0},
+    "gpt-5-image": {"per_image": 0.04, "input_per_1m": 0.005, "output_per_1m": 0.015},
+    "seedream": {"per_image": 0.02, "input_per_1m": 0, "output_per_1m": 0},
+    "riverflow": {"per_image": 0.02, "input_per_1m": 0, "output_per_1m": 0},
+}
+
+
+def _estimate_image_cost(entry: dict) -> float:
+    """Estimate USD cost for a single image generation entry."""
+    model = entry.get("model", "").lower()
+    tokens = entry.get("token_usage", {})
+    total_tokens = tokens.get("total_tokens", 0)
+
+    # Find matching pricing by model substring
+    pricing = None
+    for key, p in IMAGE_MODEL_PRICING.items():
+        if key in model:
+            pricing = p
+            break
+
+    if not pricing:
+        # Fallback: assume $0.03/image for unknown models
+        return 0.03
+
+    cost = pricing["per_image"]
+    if total_tokens > 0 and pricing["input_per_1m"] > 0:
+        cost += (total_tokens / 1_000_000) * pricing["input_per_1m"]
+    return round(cost, 6)
+
+
 @bp.route("/api/routines/image-costs")
 def get_image_costs():
-    """Return AI image generation cost entries."""
+    """Return AI image generation cost entries with estimated costs."""
     costs_path = LOGS_DIR / "ai-image-creator-costs.json"
     content = safe_read(costs_path)
     if not content:
@@ -99,11 +135,15 @@ def get_image_costs():
     total_tokens = 0
     total_seconds = 0.0
     total_bytes = 0
+    total_cost = 0.0
     for e in entries:
         tokens = e.get("token_usage", {})
         total_tokens += tokens.get("total_tokens", 0)
         total_seconds += e.get("elapsed_seconds", 0)
         total_bytes += e.get("size_bytes", 0)
+        est = _estimate_image_cost(e)
+        e["estimated_cost_usd"] = est
+        total_cost += est
 
     return jsonify({
         "entries": entries,
@@ -112,5 +152,6 @@ def get_image_costs():
             "total_tokens": total_tokens,
             "total_seconds": round(total_seconds, 1),
             "total_bytes": total_bytes,
+            "total_cost_usd": round(total_cost, 4),
         },
     })

dashboard/frontend/src/pages/Costs.tsx

@@ -100,11 +100,12 @@ interface ImageCostEntry {
   size_bytes: number
   elapsed_seconds: number
   token_usage: { prompt_tokens: number; completion_tokens: number; total_tokens: number }
+  estimated_cost_usd?: number
 }
 
 interface ImageCosts {
   entries: ImageCostEntry[]
-  totals: { count: number; total_tokens: number; total_seconds: number; total_bytes: number }
+  totals: { count: number; total_tokens: number; total_seconds: number; total_bytes: number; total_cost_usd?: number }
 }
 
 function relativeTime(ts: string): string {
@@ -174,6 +175,8 @@ export default function Costs() {
   }
 
   const totalRuns = (data.by_routine || []).reduce((sum, r) => sum + Number(r.runs || 0), 0)
+  const imageTotalCost = imageCosts?.totals?.total_cost_usd || 0
+  const grandTotal = Number(data.total_cost || 0) + imageTotalCost
   const avgCostPerRun = totalRuns > 0 ? data.total_cost / totalRuns : 0
 
   return (
@@ -199,9 +202,9 @@ export default function Costs() {
           icon={Activity}
         />
         <StatCard
-          label="Month Estimate"
-          value={`$${Number(data.month_estimate || data.total_cost || 0).toFixed(2)}`}
-          subtitle="Projected total"
+          label="Total (All)"
+          value={`$${grandTotal.toFixed(2)}`}
+          subtitle={imageTotalCost > 0 ? `Routines + ${imageCosts?.totals?.count || 0} images` : 'Routines total'}
           icon={Zap}
         />
         <StatCard
@@ -324,6 +327,9 @@ export default function Costs() {
               <span>{imageCosts.totals.total_tokens.toLocaleString()} tokens</span>
               <span>{formatBytes(imageCosts.totals.total_bytes)}</span>
               <span>{imageCosts.totals.total_seconds}s total</span>
+              {imageCosts.totals.total_cost_usd !== undefined && (
+                <span className="text-[#00FFA7] font-medium">${imageCosts.totals.total_cost_usd.toFixed(2)}</span>
+              )}
             </div>
           </div>
           <div className="overflow-x-auto">
@@ -336,6 +342,7 @@ export default function Costs() {
                   <th className="text-right p-4 pb-3">Tokens</th>
                   <th className="text-right p-4 pb-3">Size</th>
                   <th className="text-right p-4 pb-3">Time</th>
+                  <th className="text-right p-4 pb-3">Est. Cost</th>
                   <th className="text-right p-4 pb-3">When</th>
                 </tr>
               </thead>
@@ -354,6 +361,9 @@ export default function Costs() {
                     <td className="p-4 text-right text-[#8b949e] tabular-nums text-[13px]">{e.token_usage.total_tokens.toLocaleString()}</td>
                     <td className="p-4 text-right text-[#8b949e] tabular-nums text-[13px]">{formatBytes(e.size_bytes)}</td>
                     <td className="p-4 text-right text-[#667085] tabular-nums text-[13px]">{e.elapsed_seconds.toFixed(1)}s</td>
+                    <td className="p-4 text-right tabular-nums text-[13px] text-[#00FFA7]">
+                      {e.estimated_cost_usd !== undefined ? `$${e.estimated_cost_usd.toFixed(4)}` : '—'}
+                    </td>
                     <td className="p-4 text-right text-[#667085] text-[13px] whitespace-nowrap">{relativeTime(e.timestamp)}</td>
                   </tr>
                 ))}

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "evo-nexus"
-version = "0.20.0"
+version = "0.20.1"
 description = "Unofficial open source toolkit for Claude Code — AI-powered business operating system"
 requires-python = ">=3.10"
 dependencies = [