Your open-source DeFi desk.
Inspect an Aave position, track a Lido withdrawal, size a Uniswap range, check Aerodrome gauge custody or screen DefiLlama yields. Boomkin installs protocol-specific procedures and local helpers into the native Hermes Agent, with reviewed source pins and file-integrity checks.
Each workflow names the reads to make, the accounting that matters and the evidence needed to finish. Official provider tools do the protocol work; Hermes handles the agent loop.
Website · Strategy lab · Documentation · Contribute
Use macOS or Linux, Bun, Git and a terminal. For Windows, use WSL2 or install Hermes with its official Windows flow first. Optional Coinbase tooling requires Node.js 22+; Agentic Wallet's current guide requires Node.js 24+.
bun install -g boomkin@0.8.1
boomkin onboard
boomkin doctor --live
boomkin startBun and Git are prerequisites. Keep Bun's global bin directory on your path. For a source checkout:
git clone https://github.com/galleonlabs/boomkin.git
cd boomkin
bun install --frozen-lockfile
bun run boomkin onboard
bun run boomkin doctor --live
bun run boomkin startonboard prepares ~/.boomkin/hermes, installs the reviewed official Hermes runtime if none is available, installs all packs in the reviewed catalog on a fresh profile, creates Boomkin's SOUL and instructions, configures public CoinGecko MCP, and opens native Hermes model setup. Choose your provider and sign in there. start launches the native Hermes chat in that same profile.
Hermes remains the runtime: its tools, sessions, memory, model adapters, MCP support and scheduling are not forked. A new runtime installation uses reviewed Hermes v0.21.5 source (upstream tag v2026.9.24); the native installer also manages the user-level hermes command and dependencies. Browser/computer-use dependencies are skipped initially and can be added through native Hermes setup. An existing working Hermes installation at 0.21.0 or newer is reused, not downgraded.
Model authentication requires your account or local model configuration. Optional providers can require subscriptions, OAuth or scoped credentials. Onboarding makes no model call, pays for no data, creates or funds no wallet, and starts no background service.
Useful options:
bun run boomkin onboard --directory "$HOME/defi-agent" --dry-run
bun run boomkin onboard --directory "$HOME/defi-agent" --skip-model-setup
bun run boomkin onboard --directory "$HOME/defi-agent" --no-install
bun run boomkin model --directory "$HOME/defi-agent"Use the same --directory for subsequent commands. --skip-model-setup is for preparing a profile before interactive login; it does not mark the model authenticated. Existing SOUL, instructions and unrelated settings are preserved. A conflicting named MCP configuration is reported for review instead of overwritten.
Save a research question as a project, preview its brief and run it through native Hermes. Each run keeps its own report, raw sources, observation hashes and reviewable unsigned plan. A model response stays in review until its artifact checks pass. Project commands and output contract.
boomkin project create --name stablecoin-yields \
--workflow yield-screen --input-file ./inputs.json
boomkin project run --name stablecoin-yields --dry-run
boomkin project run --name stablecoin-yields
boomkin project check --name stablecoin-yieldsPublic market snapshots compare fresh CoinGecko and DefiLlama observations while keeping unavailable, stale and disagreeing sources visible. The strategy pack runs local daily spot simulations with next-observation decisions, fixed fees and adverse slippage, flow-neutral returns, drawdown and a same-flow buy-and-hold benchmark. Try the same engine in the browser with a dated Bitcoin capture, synthetic fixtures or your own dataset.
bun run boomkin workflows
bun run boomkin workflows --protocol Uniswap
bun run boomkin workflows --workflow aave-health --json
bun run boomkin onboard --workflow aave-healthworkflows works before setup and makes no network calls. It shows the required inputs, deliverable and provider access. --workflow installs that task's independent pack. On an existing profile it selects that pack for future updates, just like --pack; already copied files and custom instructions are preserved. Use a separate --directory for a dedicated task profile.
| Task | What you get |
|---|---|
market-snapshot |
Source timestamps, raw-response hashes and public price comparison |
strategy-backtest |
Reproducible daily spot tests, costs and a same-flow benchmark |
thesis-review |
Saved thesis, invalidation conditions and fresh evidence for review |
aave-health |
V3 position reads, stressed health factor and reserve constraints |
morpho-market / compound-borrow |
Protocol-specific collateral, debt and liquidity analysis |
uniswap-position / aerodrome-position |
Position accounting, range checks and gauge/exit requirements |
uniswap-quote / bridge-status |
Route review, permissions and settlement evidence |
lido-exit |
Withdrawal NFT ownership, finalization and claimability |
pendle-maturity / vault-exit |
Maturity accounting and what can actually be redeemed |
token-research / yield-screen |
Contract-based identity and reproducible yield screening |
coinbase-readiness |
CDP/AgentKit capabilities and policy gaps |
hyperliquid-risk |
Venue/account-mode, margin and funding analysis |
The reviewed catalog contains 15 independent packs and 41 skills. Install all of them or choose the workflows you need; the agent loads relevant instructions on demand.
| Pack | What it covers |
|---|---|
| Infrastructure | RPC, Alchemy, Coinbase, wallet policies and readiness |
| Data | CoinGecko, DefiLlama and AIXBT research, identity, freshness and source-hashed market captures |
| Strategy | Daily spot simulations, cash flows, costs, drawdown and reproducible benchmarks |
| Liquidity provision | Uniswap, Aerodrome, Revert and VFAT position workflows |
| Hyperliquid | Venue-specific analysis, planning, execution, monitoring and review |
| Lending | Collateral, borrowing, interest, repayment and liquidation risk |
| Staking | Staking, restaking, receipts and withdrawal queues |
| Yield | Vault diligence, share accounting and yield sources |
| Tokenized assets | Asset claims, eligibility, restrictions and redemption |
| Routing | Swap and bridge quotes, route limits and settlement |
| Derivatives | Exposure, margin, funding and venue-specific constraints |
| Portfolio | Assets, debt, cash flows, performance and rebalance plans |
| Security | Token diligence, evidence comparisons, transaction effects and permissions |
| Payments | Agent payments, x402 challenges and settlement evidence |
| Governance | Proposals, voting, delegation and execution stages |
Start with the protocol workflow matching your task. Use infrastructure and cross-protocol skills when the task needs them. The broader primitive skills use the galleon-defi- prefix to avoid upstream name collisions. Read workflow examples for useful combinations.
Each pack is independently versioned and published from crypto-defi-skills. Boomkin's catalog records the npm identity, version, immutable source commit, package directory and expected skills. Downloads, installed metadata and every copied supporting file are checked before a successful sync is recorded. Local file digests let check and doctor detect missing references and changed scripts afterward.
Fresh onboarding includes every pack in the checked-out catalog. Select fewer with repeated --pack options:
bun run boomkin onboard --pack defi-infra-skills --pack defi-data-skillsUpdates preserve your selection. Future packs are opt-in. To expand an existing installation deliberately:
bun run boomkin onboard --directory "$HOME/your-existing-hermes-profile" --all-packsOther harnesses can still install the portable skills through advanced compatibility setup. Boomkin's end-to-end product flow is Hermes-first.
bun run boomkin providers
bun run boomkin connect --provider aixbt
bun run boomkin connect --provider alchemy
bun run boomkin connect --provider defillama
bun run boomkin connect --provider coinbase
bun run boomkin connect --provider tenderly| Connection | Setup and scope |
|---|---|
| CoinGecko | Public, keyless MCP configured during onboarding. Its reviewed tools are execute and search_docs; hosted execution is restricted to the provider's data SDK. |
| Alchemy | Native Hermes OAuth and explicit tool selection. Select the intended Alchemy app; data/RPC access and wallet/admin actions have different scopes. |
| AIXBT | Optional crypto intelligence through native Hermes MCP; the key stays in AIXBT_API_KEY. Discovery is public; protected research reads require account access. |
| DeFiLlama | Native Hermes OAuth with an API subscription. Queries consume credits; connecting another client can disconnect the previous client. |
| Tenderly | Optional paid-plan OAuth with explicit tool selection. Simulations and inspection require the intended project; results persist there. |
| Coinbase account | Official local MCP through a pinned CLI, with six read tools and a profile-specific configuration/keychain environment. Account credentials remain a separate step. |
| Agentic Wallet | Separate official awal CLI flow for managed wallet and x402 use. Login, wallet creation, funding and spend limits require your choices; see the connection guide. |
For Coinbase, supply a scoped key file to the native CLI through Boomkin:
bun run boomkin connect --provider coinbase --key-file /absolute/path/to/scoped-key.jsonThe command uses the OS keychain and does not opt into plaintext secret storage. It configures credentials; it does not check balances, trade or approve payments. Coinbase's remote account MCP currently restricts custom harnesses, so Boomkin uses its supported local server. Coinbase for Agents and Agentic Wallet have different custody and payment capabilities.
Read the connection guide for exact prerequisites, diagnostics and limits. Restart Hermes after changing MCP settings. MCP tool selection controls that connection; it is not a sandbox around Hermes's terminal or a substitute for provider-enforced account and spending limits.
Use galleon-aave-position to inspect my wallet on this Aave V3 market: [chain, market and address]. Show current health factor and the effect of a 20% collateral-price fall. Identify missing reads and keep any repayment or borrow plan unsigned.
Boomkin loads only the relevant skills and provider references. It separates infrastructure readiness, data evidence, protocol workflows, portfolio reporting and transaction review from execution. It uses Hermes's native memory and scheduling when appropriate; a scheduled task retains the same authorization and freshness requirements as an interactive task.
doctor reports configuration, installed versions and file integrity. Older installations can run update once to record file digests; preserve any local skill edits first. doctor --live additionally verifies keyless CoinGecko MCP initialization and tool discovery, plus credential-free AIXBT discovery when connected. Neither is proof of a successful model response, authenticated paid data, wallet authority or an executed transaction. Use the data pack's public diagnostic for a first market observation, and the infrastructure pack's RPC diagnostic for a configured chain.
bun run boomkin check --directory "$HOME/.boomkin/hermes"
bun run boomkin update --directory "$HOME/.boomkin/hermes"
bun run boomkin doctor --live
bun run boomkin startPull this repo and run bun install --frozen-lockfile when updating Boomkin itself. update refreshes the reviewed skill catalog, not the Hermes runtime. Use native Hermes updates separately and rerun the readiness checks afterward. The reviewed runtime pin and installer checksum are in src/hermes.ts.
Onboarding can be rerun after a failed install or interrupted login. Completed skill installs and existing instructions remain intact. Review any reported operation lock before removing it. Provider failure does not change the approved route or cause an automatic retry of a financial action.
See updates and recovery for pack selection, backups and troubleshooting. Keep credentials, private evidence and generated profiles outside this repository.
Bug reports, clearer guides, new workflows and focused pull requests are welcome. Start with CONTRIBUTING.md for setup and the checks relevant to your change. Report a reproducible problem in GitHub Issues; use private reporting for security concerns.
bun install --frozen-lockfile
bun run check
bun run build
bun run smokeThe compatibility smoke checks fresh setup/update and independent pack selection. Native Hermes smoke additionally checks the actual runtime's profile, SOUL, MCP configuration and tool filtering in a temporary home, using a local mock MCP. --public adds a keyless CoinGecko discovery check. No model or wallet action is part of these checks.
MIT licensed, with the copyright and permission notice retained when reusing copies or substantial portions. Created by Andrew Wilkinson and Galleon Labs.
See reuse and attribution for a ready-to-copy credit line. If Boomkin helps your work, a star on the original repository is appreciated and entirely optional.
The documentation copy controls were inspired by Rare UI and implemented independently.
Use bun run boomkin chatgpt --action login for native Hermes ChatGPT OAuth, --action status to inspect it, and --action model for catalog-supported selection including GPT-6.1 Sol when available. ChatGPT onboarding and verification distinguishes native OAuth from partner plan consent and attributed usage. No tokens are copied into Boomkin and the runtime pin is unchanged.