Balance Whale Cloud Billing & Budget Telemetry Widget

Balance Whale Cloud Billing & Budget Telemetry Widget

@meteornox/balance-whale-widget·v1.0.4·protocols

A lightweight cloud billing and token expenditure monitor for DeepSeek Harness. Features multi-provider balance tracking, burn-rate telemetry, and automated low-balance safeguards.

Billing-Monitor · Budget-Widget · Cost-Control · Burn-Rate

GitHubNPM
Installation & Integration
bash
manager:
$ pnpm add @meteornox/balance-whale-widget

Architecture

Balance Whale eliminates cloud billing anxiety for AI engineers. Running unattended agent evaluations or data synthesis pipelines overnight often results in shocking bills or sudden API service cuts due to account exhaustion. This plugin integrates lightweight billing telemetry directly into DeepSeek Harness. Querying real-time balance endpoints across DeepSeek, Anthropic, and OpenRouter, it calculates live burn rates (dollars per hour) and projects monthly costs. When balances cross critical thresholds, it dispatches proactive warnings or halts non-essential workers automatically.

Core Features

01

Unified Multi-Vendor Balance Hub: Consolidates balances across DeepSeek, Claude, and OpenAI

02

Real-Time Hourly Burn Rates: Pinpoints exactly how much cash active test jobs are consuming per hour

03

Custom Low-Balance Warning Gates: Dispatches notifications before unexpected service freezes hit

04

Minimal Footprint: Lightweight polling routines consuming <5MB memory with zero CPU overhead

Core Workflow

01

Multi-Provider Balance Probe

Silently polls official account balance APIs across configured LLM providers.

02

Burn-Rate Projection

Combines active token burn rates to linearly project end-of-month expenditure.

03

Micro-Widget Rendering

Renders non-intrusive live telemetry badges on web workbenches and terminal headers.

04

Low-Balance Safety Trip

Dispatches urgent threshold alerts and cleanly halts non-essential test batches.

Configuration Parameters Reference (YAML / JSON)

ParameterTypeDefaultDescription
warningThresholdUsdnumber10.0Low balance warning threshold in USD
pollIntervalMinutesnumber15Balance polling interval in minutes
haltOnDepletionbooleantrueAuto-halt non-critical jobs on low balance