← all repositories
MeteorNOX/DeepSeek-Balance-Whale-Widget

A bouncy whale that audits your DeepSeek spend

A DSH plugin that parks a draggable, squishy whale in your corner to track DeepSeek API balance, daily usage, and per-turn costs in real time.

558 stars JavaScript Coding AssistantsLLMOps · Eval
DeepSeek-Balance-Whale-Widget
Collecting fresh signals — velocity needs a few days of history.
collecting data…
star history

What it does

This is a standard DeepSeek Harness (DSH) bundle plugin that adds a floating whale widget to the bottom-right of the DSH web UI. It polls your DeepSeek API balance every 60 seconds, tracks today’s spending, and can surface the exact cost after each conversation turn. The widget snaps to screen edges, mirrors itself when docked to the left, and squishes like a stress toy when clicked.

The interesting bit

The clever part is its dual-mode accounting. By default it infers daily usage from balance deltas stored locally—no platform token required—so it works out of the box with just an API key. If you want precision, hand it a DeepSeek platform session token and it switches to real-time peak/valley pricing. It also hooks into local DSH session events to calculate per-turn costs from exact token usage rather than estimating.

Key highlights

  • Auto-refreshes balance every 60s with rolling number animations
  • Two usage-tracking modes: zero-config local bookkeeping or precise platform-token-based peak/valley pricing
  • Per-turn cost popups using actual model usage data from DSH session events
  • Drag-and-drop with quarter-screen edge snapping and horizontal flip on left-side dock
  • Configurable burger menu for size, sound effects, and feature toggles

Caveats

  • Requires DeepSeek Harness (DSH) to function; not a standalone tool
  • The real-time usage mode needs a DeepSeek platform session token, which expires when you re-login to the platform
  • Sound effects and GIF reactions are optional assets; missing files silently degrade instead of breaking

Verdict

Worth installing if you run DeepSeek Harness and want at-a-glance spend tracking with personality. Skip it if you don’t use DSH or if floating mascots make you irrationally angry.

Frequently asked

What is MeteorNOX/DeepSeek-Balance-Whale-Widget?
A DSH plugin that parks a draggable, squishy whale in your corner to track DeepSeek API balance, daily usage, and per-turn costs in real time.
Is DeepSeek-Balance-Whale-Widget open source?
Yes — MeteorNOX/DeepSeek-Balance-Whale-Widget is open source, released under the MIT license.
What language is DeepSeek-Balance-Whale-Widget written in?
MeteorNOX/DeepSeek-Balance-Whale-Widget is primarily written in JavaScript.
How popular is DeepSeek-Balance-Whale-Widget?
MeteorNOX/DeepSeek-Balance-Whale-Widget has 558 stars on GitHub.
Where can I find DeepSeek-Balance-Whale-Widget?
MeteorNOX/DeepSeek-Balance-Whale-Widget is on GitHub at https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.