hummingbot-heartbeat — Claude Code skill: setup and usage
Gathers hourly Hummingbot status metrics and portfolio balances for automated chat alerts. Useful for tracking trading controllers and active executors remotely.
npx skills add hummingbot/skills --skill hummingbot-heartbeat -a claude-codeWhat hummingbot-heartbeat does
The skill runs scripts/bot_status.py to inspect a local Hummingbot deployment. It queries endpoints for the API version, active bot controllers, open trade executors, and recent portfolio valuations. When Docker is present on the machine, the script also checks the status of the Gateway container using docker ps.
Configuration values come from environment variables or a local .env file. By default, the script connects to http://localhost:8000 with standard admin credentials.
Without an accessible Hummingbot API instance, the script fails immediately upon execution. The host environment requires Python 3.9 or higher.
What it helps with
- Track Hummingbot API health and version updates automatically
- Inspect active bot controllers without terminal access
- Filter out terminated or failed trade executors to monitor active runs
- Report token balances and total portfolio value directly to chat
Example prompts for the agent
- Set up the hummingbot-heartbeat cron task for hourly notifications
- Run
python3 scripts/bot_status.pyto check the current bot status - Execute
python3 scripts/bot_status.py --jsonto generate raw JSON metrics
How to install hummingbot-heartbeat
1Skills CLI (Vercel)
npx skills add hummingbot/skills --skill hummingbot-heartbeat -a claude-code2Manually: put the files in place
~/.claude/skills/hummingbot-heartbeat/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/hummingbot-heartbeat/
1Skills CLI (Vercel)
npx skills add hummingbot/skills --skill hummingbot-heartbeat -a codex2Manually: put the files in place
.agents/skills/hummingbot-heartbeat/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hummingbot/skills --skill hummingbot-heartbeat -a cursor2Manually: put the files in place
.cursor/skills/hummingbot-heartbeat/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hummingbot/skills hummingbot-heartbeat2Manually: put the files in place
.github/skills/hummingbot-heartbeat/SKILL.md1Skills CLI (Vercel)
npx skills add hummingbot/skills --skill hummingbot-heartbeat -a gemini-cli2Platform CLI
gemini skills install https://github.com/hummingbot/skills --path skills/hummingbot-heartbeatManually: put the files in place
.devin/skills/hummingbot-heartbeat/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add hummingbot/skills --skill hummingbot-heartbeat -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about hummingbot-heartbeat
How to install hummingbot-heartbeat in Claude Code?
Run npx skills add hummingbot/skills --skill hummingbot-heartbeat -a claude-code. The skill file will be stored at ~/.claude/skills/hummingbot-heartbeat/SKILL.md.
What components does hummingbot-heartbeat check?
It queries the API for version data, controller configs, active execution tasks, and asset balances. If Docker is running, it also checks the Gateway container.
What dependencies are required to run this skill?
You need Python 3.9 or newer and a running Hummingbot API instance. Docker is optional and will be bypassed if unavailable.
