Free tools. Yours to run.

Onchain skills.In your Discord.

Turn a simple message into mint research, rarity rankings, and wallet intel. Set up your own Hermes agent, then let it do the legwork.

About 20 minutes Windows, Mac & Linux
Your Discord, upgradedExample
your-onchain-agent Just ask. It gets to work.
You Today at 10:42

@hermes rank this collection and show me the rare ones

Hermes APPToday at 10:42

Collection ranked. Here are the three rarest.

Rarity reportDemo collection
#0842Rank 1
#2106Rank 2
#0391Rank 3
Research only. No transactions sent.
The tools behind your agent
Hermes Discord OpenCode
Open source. No toolkit subscription.

A little setup. Then just chat.

Start here. Everything you need, in the order you need it.

~20 min setup

01What you need

You needCostWhat it is for
A computerFreeRuns the agent. Windows, Mac or Linux, anything from the last few years
A Discord or Telegram accountFreeHow you talk to the agent, from your phone or desktop
An OpenCode subscription~$10/monthThe agent's brain. The only thing you actually have to pay for
A Vercel account (optional)FreeOnly if you want to put a page or a small site online
A small server (optional)~$5/monthOnly if you want the agent running while your computer is off
A Nous Portal account (optional)Pricing on the PortalNous can host the agent for you, so you never touch a server

Start with the first three. Vercel and the server come later and you can skip either of them.

02Set up Hermes

Hermes is the agent. You paste one line into a terminal window and it installs itself. That is the most technical thing in this whole guide.

Windows

Open the Start menu, type PowerShell, open it, and paste this in:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Mac

Press Command + Space, type Terminal, press Enter, and paste:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Linux

Open your terminal and paste:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
It downloads everything it needs on its own and takes a few minutes. Let the text scroll past, you do not need to read it.

Check it worked

Close the window, open a new one, and type:

hermes doctor

This prints a checklist. Green means fine. If anything is missing it tells you the exact command to fix it.

Give it a brain

The agent needs a model to think with, and that is the $10 subscription. Sign up here: opencode.ai.

Then add the key it gives you to the settings file.

Windows
notepad $env:USERPROFILE\.hermes\.env

Add this line at the bottom, replacing YOUR_KEY_HERE with your key, then save and close:

OPENCODE_GO_API_KEY=YOUR_KEY_HERE
Mac and Linux
printf 'OPENCODE_GO_API_KEY=%s\n' 'YOUR_KEY_HERE' >> ~/.hermes/.env

Now tell it to use the subscription and say hello:

hermes model
hermes chat -q "hello, what model are you?"

If it answers, the agent works. Everything after this is adding things to it.

03Set up Discord or Telegram

This is the part that makes it useful. After this you never need the terminal again. You just message it.

Pick whichever app you already use. Both take a few minutes and work the same afterwards.

Discord

Discord changes its own menus now and then, so if a button has moved, look for the closest match.

  1. Go to discord.com/developers/applications and click New Application. Give it any name.
  2. In the left menu click Bot. Scroll to Privileged Gateway Intents and switch Message Content Intent to ON. This one matters most: skip it and your bot looks totally broken.
  3. Still on that page, click Reset Token and copy what appears. It is shown once. Treat it like a password.
  4. In the left menu click Installation. Turn on Guild Install, and make sure the scopes include bot and applications.commands. Copy the install link it shows you.
  5. Open that link in your browser and add the bot to your server. You need to own or manage that server.
  6. Find your own user ID. In Discord go to Settings → Advanced, turn on Developer Mode, then right-click your own name and choose Copy User ID. It is a long number.
  7. Run the setup and paste in the token and the user ID:
hermes gateway setup

Pick Discord when it asks. Then start it and test it:

hermes gateway run

Leave that window open and send the bot a direct message in Discord. It should answer. Once it does, press Ctrl + C to stop it and run these two lines so it starts on its own from then on:

hermes gateway install
hermes gateway start
In direct messages it answers everything. In a server channel it only answers when you @mention it, so it never spams your friends.
If it never replies, it is almost always one of two things: Message Content Intent is still off, or the user ID was copied wrong. Redo steps 2 and 6.

Telegram

Telegram is the quicker one. Hermes creates the bot for you: you scan a code with your phone and tap one button.

  1. Run the setup:
hermes gateway setup
  1. Pick Telegram when it asks, then choose Automatic. A square code appears in the window, with a link under it.
  2. Point your phone's camera at the code, or open the link. Telegram opens and asks you to confirm. Tap Create Bot. You can change its name first if you like.
  3. Back in the window it says it detected your Telegram account and asks whether to allow it. Say yes, and yes to the couple of questions after that. Only you can talk to the bot.

Then start it and test it:

hermes gateway run

Leave that window open, find your new bot in Telegram, and send it a message. It should answer. Once it does, press Ctrl + C to stop it and run these two lines so it starts on its own from then on:

hermes gateway install
hermes gateway start
Prefer to make the bot yourself? In Telegram, message @BotFather, send /newbot, and answer its two questions. The username has to end in bot. It hands you a token: shown once, treat it like a password. Then message @userinfobot to get your user ID, which is a number. Choose Manual in the setup and paste in both.
In a private chat it answers everything. In a group it only answers when you @mention it or reply to it, so it never spams your friends. Every prompt later in this guide works the same here.
If it replies with a pairing code instead of an answer, it does not know your account yet. Run hermes pairing approve telegram <code> in the terminal and message it again.

04Download the skills

Three lines. This downloads the skills and installs them into your agent:

git clone https://github.com/andyemad/nft-mint-rarity-toolkit.git
cd nft-mint-rarity-toolkit
./install.sh

Check them any time with hermes skills list. Running the installer again later is safe, it will not break anything.

No git installed, or not sure? Download the ZIP from this link, unzip it, open a terminal inside that folder and run bash install.sh.

Last thing, three small helpers that the wallet and trading skills need:

pip install eth-account coincurve pycryptodome

05The onchain skill library

You do not have to memorise these. The agent picks the right one on its own. This is so you know what you can ask for.

Minting

nft-mint-recon

Works out what a mint really is

Finds the real contract, the real price, whether the mint is actually open, and which network it is on. The one that stops you getting scammed by a fake price.

View playbook for nft-mint-recon
seadrop-rapid-mint

Mints from many wallets at once

For drops that sell out in seconds. Creates the wallets, tells you exactly how much to put in each, and fires them the moment the mint opens.

View playbook for seadrop-rapid-mint
nft-floor-sweep

Prices up buying a whole floor

Adds up every cheap listing in a collection and gives you the real total before you buy them all.

View playbook for nft-floor-sweep

Rarity and buying

nft-rarity-engine

Ranks a collection by rarity

Scores every NFT and puts them in order using the same maths OpenSea uses, so the ranks match. It can catch a reveal before OpenSea updates itself.

View playbook for nft-rarity-engine
nft-secondary-buy

Buys a listed NFT for you

Buys from the resale market, always testing the purchase first so a broken order never costs you a fee.

View playbook for nft-secondary-buy

Is this thing real?

Wallets

Making your own collection

Tools and research

mint-control-room

The mint control room

A local dashboard for minting: plan a mint, rehearse it, manage a set of wallets, watch the floor, and see what happened afterwards.

View playbook for mint-control-room
pow-mint-mining

Handles solved mints

Hashcats, FAB4200 and others like them give you the item for finding a lucky number instead of paying. This runs that search for you.

View playbook for pow-mint-mining

06Mint Hashcats (and drops like it)

Some drops do not have a price. Instead of paying, you have to find a lucky number, and whoever finds one first gets the cat. That is what people mean when they say a mint is solved rather than bought.

Your laptop can do it, but it would take days, and people with big rented computers find them in minutes. So you rent one for a few minutes. That is the only reason for any of this.

Rent a computer for a few minutes (free to start)

Modal rents computers by the second. You do not buy anything. You sign up and it comes with $30 of free computing every month, which is about seven hours of their fast machines at roughly $4 an hour. For occasional attempts you will probably never pay anything.

  1. Sign up free at modal.com. The $30 is already included.
  2. Then run these two commands once:
pip install modal
modal setup

The second one opens a browser and links your account. That is the whole setup.

What to type in Discord

This is the entire operation. Mention your bot and paste this:

@yourbot use pow-mint-mining on hashcats. show me the round, the difficulty, and my odds before spending anything
@yourbot run the current round. stop on a hit or at 15 minutes, and tell me the cost either way
@yourbot did we get one? show me the transaction, then tell me whether another attempt is worth the money

It reports the round back to you. When you want to actually go for it:

@yourbot go ahead and mine the current round. stop when you find one, or after 15 minutes

And to see how it went:

@yourbot did we get one? show me the transaction

What it handles for you

  • It checks the whole setup first, so a run never starts out broken
  • It does the searching on the rented computer, not yours
  • It checks every answer before spending anything, so one that arrived too late never costs you a fee
  • It sends the transaction from your wallet and gives you the link

The two things only you can do

  • Put a little ETH in your wallet. Winning still costs a few cents in fees. Nothing can do that part for you.
  • Keep attempts short. Rounds move on constantly, and work done for a round that has already ended is wasted. Short and frequent beats one long run.
Be honest about the odds. You are racing everyone else trying the same drop, and you pay for the computing whether you win or lose. That is what the free credit is for. Use it, keep your attempts short, and do not top up expecting a guaranteed cat.

Other drops this works on

Same idea and the same kind of prompt. You just name the one you want instead:

@yourbot use pow-mint-mining on FAB4200. what would a full attempt cost me, and is it worth it at today's difficulty?

07Things to ask it

There is no special wording, but sharper questions get sharper answers. Paste a link and say what you want. Give it the contract, not the name. Tell it your budget. Tell it when to stop. Ask for the number that decides it.

Paste an OpenSea link

@yourbot <collection link> rank it by rarity, then tell me which of the top 50 are listed below floor, the price, and how long each has been sitting
@yourbot what is the cheapest way into the top 1% of this right now? give me token ids, prices and links
@yourbot is this floor real? show me the last 20 sales and flag any that look like wash trading
@yourbot who holds the top 100? if ten wallets own a third of it, say so plainly
@yourbot i have 0.1 ETH and i want exposure here. what is the best set to buy?
@yourbot what would make this a bad buy at today's floor? give me three numbers to watch

Paste a tweet that says "mint this"

This is the useful one. Drop the tweet in and it works out what the mint is, what it really costs, whether it is still open, and whether the project looks real, before anything touches your wallet.

@yourbot <tweet link> before i touch this: real mint price, supply, how many wallets have minted, and whether this deployer has walked away from a mint before
@yourbot <tweet link> is the contract a copy of an existing collection? show me what is identical
@yourbot <tweet link> what does minting 3 cost me all in, gas included?
@yourbot <tweet link> who is behind it? any public wallet, any linked project
@yourbot <tweet link> is this still open or already sold out?
@yourbot <tweet link> watch it and ping me the second it goes live
It will not just fire off a transaction. It reads the tweet, finds the contract, checks the price and the supply on-chain, shows you what it found, and waits for you to say go.

Paste a mint website, or just a contract address

@yourbot <link> the page says free. simulate the mint and tell me what it actually costs
@yourbot <address> is this a honeypot? simulate a mint and a transfer, then tell me what breaks
@yourbot <address> what does this contract actually do? plain english, no code
@yourbot how many wallets have minted, and do the first twenty look like one cluster?
@yourbot <address> has this deployer shipped other collections? how did those end?
@yourbot <address> is there an owner switch, a pause, or a supply cap that can change after i mint?

Paste a wallet address

@yourbot <address> trace it: first buys, biggest wins, what it is sitting on now, realised profit and loss
@yourbot <address> is this a bot? check mint timing, gas bids, and whether it ever sells at a loss
@yourbot which collections did this wallet get into in the first ten minutes, and what did it do next?
@yourbot find me ten wallets that were early on the last three collections that did well
@yourbot is <address> connected to the deployer of ? trace the funding
@yourbot <address> what is it about to do? any open listings or pending approvals

Ask it to watch something for you

@yourbot watch  and only ping me if the floor drops under 0.05, or three rare ones get listed under floor, or one wallet buys five in an hour
@yourbot alert me the second  reveals, then rank it before anyone else has seen it
@yourbot message me when gas is under 12 gwei and the mint i care about is still open
@yourbot ping me if the deployer moves funds or the supply changes
@yourbot check every ten minutes and only message me when something actually changes
@yourbot keep this running for 24 hours, then send me one summary

Ask it to buy or mint for you

Every one of these checks first and tells you the cost before it does anything. Nothing goes through until you say go.

@yourbot here is 0.2 ETH. buy up to 3 under 0.04 each, only if the rarity is top 500 and the seller is not the deployer. never spend more than 0.1 total, and show me each one before you send it
@yourbot mint 2 from <link> when it opens, but only if the real price is 0.01 or less and the contract is not a copy
@yourbot if a mint fails, retry twice at most and tell me why each time
@yourbot buy the cheapest rare one, under 0.01, then stop
@yourbot do not spend anything without asking me first
@yourbot what am i holding right now? <address>

Ask it to explain something

@yourbot why did this floor collapse after reveal? walk me through the wallets that sold
@yourbot this looks farmed by a syndicate. show me the evidence or drop it
@yourbot what would have to be true for this to be a good buy? give me three numbers
@yourbot explain proof of work minting like i am deciding whether to pay for it
@yourbot what did i get wrong on my last three buys?
@yourbot what is the difference between a mint and a buy, one line each
The general rule: if you can paste it, it can probably look at it. Links, screenshots, addresses, tweets, spreadsheets. If you are not sure how to ask, just describe what you are trying to do and let it work the rest out.
Want to change how a skill itself works? That is a separate page, because it is the most useful thing you can learn here: make the skills better by talking.

08Set up Vercel

Vercel puts a website or a page on the internet for free. You do not need it to run the agent. You need it if you want a public page of your own: a link you can share, a portfolio, a documentation page, this guide.

Make an account

Sign up at vercel.com/signup with GitHub, Google or email. The free plan is enough for everything here.

The easy way: connect a GitHub project

  1. In Vercel click Add New → Project.
  2. Connect your GitHub account and pick the repository you want online.
  3. If your web files live in a folder rather than the top level, set Root Directory to that folder. For this guide's page that folder is docs.
  4. Click Deploy. A minute later you have a live link.

From then on, every time you push to GitHub, Vercel rebuilds the site by itself. That is the whole workflow.

The terminal way

If you would rather deploy straight from your computer:

npm install -g vercel
vercel login

# then, from inside the folder you want online
vercel --prod

It asks a couple of questions the first time and then prints your live link.

Deploy this guide's page as a test run

git clone https://github.com/andyemad/nft-mint-rarity-toolkit.git
cd nft-mint-rarity-toolkit
npx vercel deploy docs --prod

Your own domain

Optional. In the project's Settings → Domains you can add a domain you own, or accept the free your-project.vercel.app address it gives you.

What Vercel cannot do: run your agent. Vercel only serves websites that are loaded on demand. Your agent is a program that has to stay switched on, so it lives on your computer or on a server. If you ever see a deploy fail with a 402 error, that account has gone past the free plan's transfer allowance. Make a new project, or use GitHub Pages or Cloudflare Pages, which serve the same files.

09Your computer, a server, or hosted?

Both work. The only real difference is what happens when you close your laptop.

FREE

On your own computer

  • Nothing to set up beyond the install you already did
  • Full speed, and it can use things only you have: your browser, your files, your wallets
  • Stops when you shut the lid or put it to sleep
  • Any scheduled job, alert or overnight watch misses its window
  • Good for: trying things out, daytime use, anything you are watching yourself
~$5 / MONTH

On a small server

  • Never sleeps. Started once, it stays up
  • Watches, alerts and timed jobs actually fire at 4am
  • You reach it from your phone through Discord from anywhere
  • No screen, so you cannot see it working except through chat
  • Good for: scheduled jobs, overnight watches, anything you want running all the time
PRICING ON THE PORTAL

Or let Nous host it

  • Hermes Cloud runs the instance for you
  • No server to set up, patch or restart yourself
  • Start, stop and restart it from a web page, or by asking your own agent
  • Same Discord setup as everywhere else
  • Good for: people who do not want to run a server at all

Or let Nous host it for you

If running a server sounds like work you do not want, Nous Research hosts Hermes Cloud instances. You get an agent that is always on, without picking a provider, securing a box or keeping it updated.

  1. Make a Nous Portal account at portal.nousresearch.com.
  2. Open the Agents page and create an instance. Give it a name.
  3. Connect Discord or Telegram to it exactly as in step 03. Same commands, run on the instance.

From then on you manage it from that web page. Start, stop, restart, or delete it there. Pricing is listed on the Portal alongside the plans.

One subscription can cover both jobs. A Portal plan can also be the agent's brain instead of a separate model subscription: it includes a large catalogue of models plus managed web search, image generation and voice, all through one login. Run hermes setup --portal and it wires itself up. If you are already paying for OpenCode, you do not need both.
Already running an agent locally? You can manage your cloud instances by asking it, instead of clicking around the website. One command connects your local agent to the Portal:
hermes mcp add --url https://portal.nousresearch.com/mcp --auth oauth hermes-cloud

After that you can say "list my cloud agents", "what is that instance costing me", or "restart the stopped one".

Moving to a server

  1. Get one from Hetzner or DigitalOcean, about $5/month. Pick Ubuntu as the system. The smallest option is plenty.
  2. Follow the same Linux install line from step 02 on that server instead of your computer.
  3. Repeat the Discord and skills steps there. It is the same three commands.
  4. You can run both. Your computer and the server are separate agents, and each gets its own Discord bot token if you want.
Sensible way to do it: start on your own computer today, and only rent a server once you have something you want running while you sleep.

10What it costs

ThingCostNeeded?
Hermes agentFreeYes
The 31 skillsFreeYes
OpenCode subscription~$10/monthYes, this is the brain
VercelFreeOnly if you want a page online
Your own computerFreeFine, but it sleeps
Small server~$5/monthOnly for running around the clock
Modal, for solving drops like Hashcats (optional)Free, $30/month includedOnly if you want to go after those drops
Nous Portal, hosting included (optional)Listed on the PortalInstead of your own server, and it can be the brain too

Honest total: about $10 a month, or $15 if you also want it awake all night.

11If something goes wrong

What you seeWhat to do
hermes is not recognisedClose the terminal and open a new one. Still failing after that? Restart the computer and try again.
Bot online but never answersMessage Content Intent is off in the Discord developer page. This is the number one cause.
Answers in DMs, silent in a serverNormal. In servers it only answers when you @mention it.
It says you are not allowedYour Discord user ID is wrong. Copy it again with Developer Mode turned on.
Telegram replies with a pairing codeIt does not know your account yet. Run hermes pairing approve telegram <code> in the terminal, then message it again.
Vercel deploy fails with 402That account went past the free transfer allowance. New project, or use GitHub Pages or Cloudflare Pages.
The agent stopped overnightIt was on your computer. That is expected. Move it to a server if you need it always on.
It asks you for more moneyCheck your OpenCode usage page. Long jobs use more than chatting does.
Skills do not show uphermes skills list to confirm they installed, then /reload-skills in a chat.
You are lostRun hermes chat and just describe what you are trying to do.

Your agent is one setup away.

The guide and all 31 skills are free. Connect a model subscription, follow the steps, and make it yours.

The OpenCode link is a referral link. Signing up through it supports this project.