Hannibal AI — User Guide

HANNIBAL AI

USER GUIDE · Run your AI automation suite from your phone

Hannibal AI is a set of intelligent bots that run 24/7 on a Mac Mini, doing real work while you go about your day. New business leads come in. Markets get monitored. Security research runs automatically. You stay in control from your phone — no laptop required, no terminal, no technical knowledge needed.

This guide covers everything from getting phone notifications to setting up brand-new bots. The whole system was built and configured from a phone while watching a Giants game.

What's Running Right Now

Bot	What It Does	Status
MSP Prospect Bot	Finds small businesses needing IT services. Sends push notifications with new leads.	● Online
Bug Bounty Bot	Runs automated security research and formats vulnerability findings.	● Online
BlackTide	ML-driven crypto swing trading on Kraken (BTC, ETH, SOL).	● Paper
Kraken Scalper	High-frequency crypto scalping using RSI and EMA crossovers.	● Paper
Kalshi Bot	Prediction market trading using Kelly Criterion sizing.	● Paper

💡

Use the sidebar to navigate between sections. Start with Your Two Apps if you're new, or jump straight to any bot for details on what it does and how to interact with it.

Your Two Apps

Everything is managed through two Claude interfaces. Download both and you have full control from anywhere.

📱

Claude — Dispatch Tab

Your mobile command center. Open the Claude app, tap the Dispatch tab, and talk to your bots in plain English. Ask what's happening, request reports, give instructions, or check status — all from your phone, anywhere.

💻

Claude — Cowork Mode

The desktop companion. Handles file management, bot configuration, report generation, and anything that needs direct access to your Mac. Runs in the background and takes direction from you or from Dispatch.

How They Work Together

Dispatch handles the conversation — you tell it what you want. Cowork handles the execution — it reads files, writes code, runs commands, and builds things on your Mac. The Mac Relay bridge connects Claude's cloud brain to your local machine so this all happens seamlessly.

ℹ️

You don't need to know which app does what. Just open Claude on your phone and ask. It routes to the right tool automatically.

Active Bots

All bots run under PM2 on the Mac Mini and restart automatically if anything stops. You don't need to babysit them.

Bot	What It Does for You	Alerts Via	Status
MSP Prospect Bot	Scans daily for small businesses that need managed IT. Scores leads and sends push notifications with the top prospects.	ntfy push	● Online
Bug Bounty Bot	Automated security research and vulnerability scanning. Drafts and submits findings to bug bounty programs.	Dispatch	● Online
BlackTide	ML ensemble swing trading — XGBoost + neural net. Trades BTC, ETH, SOL. Holds multi-day positions. Currently paper mode.	Dashboard	● Paper
Kraken Scalper	High-frequency scalping on 5-minute candles using RSI, Stochastic RSI, and volume spikes. Currently paper mode.	Dashboard	● Paper
Kalshi Bot	Prediction market trading on yes/no event contracts using Kelly Criterion for optimal bet sizing. Currently paper mode.	Dashboard	● Paper

⚠️

Trading bots are in paper mode — full strategy logic runs, signals are generated, positions are tracked, but no real money moves. Recommended: run paper for 30+ days and review dashboard performance before going live.

MSP Prospect Bot ● online

Finds small businesses in the Bay Area that need managed IT services. Runs weekly and sends push notifications when new leads are ready.

The bot searches Yelp and Perplexity AI for businesses in high-MSP-need industries — dental offices, law firms, insurance agencies, construction companies. Each lead is scored 0–100 for MSP fit and deduplicated against previous runs. Top prospects are saved to a SQLite database with 534 companies and growing.

What You Get

Output	Where It Goes
Push notification	Your phone via ntfy — lead count, top industries, company names
CSV report	Saved to the reports folder, auto-imported to database
Decision-maker contacts	Apollo.io enrichment (requires paid Apollo plan)

Ask Dispatch

"Any new MSP leads today?"

"Build me a report on the top 5 prospects"

"What were the top industries from this week's scan?"

"Run the leads bot now"

Last updated: 2026-05-15

Bug Bounty Bot ● online

Automated vulnerability research and bug bounty hunting. Runs on a schedule and formats findings for submission.

The bot scans target scopes for exposed services, misconfigured APIs, and known vulnerability patterns. When a finding is confirmed, it drafts a structured report and submits it to the appropriate bug bounty program — currently targeting Cloud Software Group (CSG) via HackerOne.

Recent Findings

Finding	Target	Status
Swagger UI exposure — 16 undocumented API endpoints visible publicly	CSG / HackerOne	Submitted

Ask Dispatch

"Did the bug bounty bot find anything?"

"Show me the latest security findings"

"Draft a submission for the latest finding"

Trading Platform ● paper mode

Three bots running across Kraken crypto markets and Kalshi prediction markets. All switched to paper mode May 2026 for performance review.

✅

All three bots have PAPER_TRADE = True. Full strategy logic runs — signals, position tracking, trade logging — but no real orders are placed. Safe to run 24/7.

Bot	Market	Strategy
BlackTide	Kraken (crypto)	ML ensemble — XGBoost + MLP, AUC 0.80/0.82. Multi-day swing positions.
Kraken Scalper	Kraken (crypto)	RSI, Stochastic RSI, EMA crossovers on 5-min candles.
Kalshi Bot	Kalshi (prediction markets)	Kelly Criterion sizing on binary yes/no event contracts.

Going Live Again

Recommendation: run paper mode for 30+ days and review dashboard performance before switching. When ready, ask Dispatch to update the config and restart the bots.

Ask Dispatch

"Show me this week's trading performance"

"How is BlackTide doing in paper mode?"

"What's the current Kalshi position?"

Phone Notifications

Get alerts from your bots the moment something happens — directly to your lock screen via ntfy.sh.

Setup (2 minutes)

1
Download the ntfy app on your iPhone or Android phone.
2
Open the app and tap + to add a new subscription.
3
Enter your topic: hannibal-bb-maxmoore — then tap Subscribe.
4
Done. Alerts arrive automatically when bots find leads or hit thresholds.

What Triggers a Notification

Bot	Notifies you when…
MSP Prospect Bot	New business leads are found. Message includes count, top industries, and company names.
Kalshi Bot	A trade is executed or a position threshold is hit.

ℹ️

You don't need to check the dashboard or open any app. The notification arrives on your lock screen with the key details. Open Dispatch if you want to dig deeper.

Managing from Your Phone

Open the Claude app → Dispatch tab. Type what you want in plain English. No commands, no syntax, no technical knowledge required.

Dispatch routes your message to the right bot or agent and returns the answer. You can check status, pull reports, give new instructions, or kick off tasks — all from wherever you are.

Things You Can Ask Right Now

"What's the bot status right now?"

"Any new MSP leads today?"

"Show me this week's trading performance"

"Did the bug bounty bot find anything?"

"Run the leads bot now"

"Build me a report on the top 5 prospects"

"What were the top industries in today's leads scan?"

"How many leads do we have in the database?"

💡

The whole MSP prospect bot, the SQLite database, and the Apollo integration were set up through Dispatch during a Giants game. If you can describe what you want, Dispatch can build it.

Setting Up a New Bot

Adding a new automation is a conversation, not a coding project.

Describe what you want automated — what should trigger it, what it should do, what output you want. Cowork builds it, wires up notifications, registers it with PM2, and it starts running. You get notified when it's done something worth seeing.

1
Open Claude and describe what you want automated. Be specific about the trigger (schedule, event, threshold) and the output (notification, report, file).
2
Cowork builds the bot, sets up the files, and configures any API keys needed.
3
The bot registers with PM2 and starts running on its schedule — automatically, in the background.
4
You get a push notification or Dispatch message when it has something to report.

Ideas for New Bots

Bot Idea	What It Would Do
Competitor monitor	Watch a competitor's pricing or job listings page and alert you to changes
Weekly digest	Summarize top trading signals and leads into a Sunday morning email
Outreach tracker	Monitor your MSP prospect follow-up pipeline and flag stale leads
Job board scanner	Watch target boards for roles matching your criteria and alert instantly
Social listener	Track mentions of keywords on X/Reddit and surface relevant threads

Connected Apps & APIs

Every API connection transforms Claude from an assistant that can talk about your data into one that can act on it.

The more connected your stack is, the more autonomous and useful the whole system becomes. Below is what changes when each service is connected vs. when it isn't.

App	Used For	Without the API	With the API
Perplexity AI	Lead discovery	Claude guesses at what companies exist	Bot queries real-time web with AI reasoning — 500+ targeted leads per scan
Apollo.io	Contact enrichment	Company name and website, nothing more	Decision-maker name, email, and phone auto-populated for every lead
Kraken	Crypto trading	Claude can discuss trading strategies	Bot monitors live markets, executes orders, tracks positions in real time
Kalshi	Prediction markets	Claude discusses event probabilities conceptually	Bot places sized bets on live binary event contracts
Gmail	Outreach	Claude writes a draft — you copy, paste, send	Claude sends follow-ups, manages threads, and logs responses automatically
Google Drive	File sync	Files stay on your Mac only	Reports sync to Drive instantly — accessible anywhere, shareable with one link
ntfy.sh	Notifications	You have to open an app to check what happened	Bots push alerts to your lock screen the moment something happens
HackerOne	Bug bounty	You manually format and submit every finding	Bot drafts the report and submits it to the right program automatically

🔌

The goal is a fully connected stack where Claude can act across every tool you use — from finding a lead to sending the follow-up email to logging the result — all from a single instruction on your phone.

Mac Software Stack

The Mac Mini runs 24/7 as the brain of the operation. These tools run silently in the background — you don't interact with any of them directly.

Software	Category	What It Does for the System
PM2	Process Manager	Keeps every bot running 24/7. Auto-restarts anything that crashes. Survives Mac reboots. Without this, bots would stop whenever anything went wrong.
Python 3	Bot Runtime	The language all bots are written in. Handles web scraping, trading logic, database writes, and API calls. Fast, readable, and has a library for everything.
Mac Relay	Command Bridge	Custom-built bridge that lets Claude (running in the cloud) send commands to your Mac and read the results. This is what makes phone-to-Mac control possible without SSH or VPN.
SQLite	Database	Stores all 534 MSP prospects locally on the Mac. Zero configuration — it's just a file, but behaves like a full database. Fast, reliable, and requires no server.
Flask	Web Server	Serves the internal trading dashboard on port 5050. Shows live P&L, bot status, lead counts, and bug bounty findings. Accessible from any browser on your network.
Node.js	JS Runtime	Powers report generation and the dashboard frontend. Used to produce professional Word and PDF documents automatically.
Homebrew	Package Manager	Installs and manages every other tool on this list. Think of it as the App Store for the Mac's command line — one command installs anything.
LibreOffice	Document Engine	Converts between file formats in the background — Word to PDF, HTML to PDF. Claude uses this to produce polished deliverables without ever opening an app.

⚙️

All of this runs on a Mac Mini that sits on your desk. The hardware is a one-time cost. The software is free and open source. The result is a personal AI operations center that most companies would need an engineering team to maintain.

Last updated: 2026-05-15