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-reconTurn a simple message into mint research, rarity rankings, and wallet intel. Set up your own Hermes agent, then let it do the legwork.
Start here. Everything you need, in the order you need it.
| You need | Cost | What it is for |
|---|---|---|
| A computer | Free | Runs the agent. Windows, Mac or Linux, anything from the last few years |
| A Discord or Telegram account | Free | How you talk to the agent, from your phone or desktop |
| An OpenCode subscription | ~$10/month | The agent's brain. The only thing you actually have to pay for |
| A Vercel account (optional) | Free | Only if you want to put a page or a small site online |
| A small server (optional) | ~$5/month | Only if you want the agent running while your computer is off |
| A Nous Portal account (optional) | Pricing on the Portal | Nous 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.
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.
Open the Start menu, type PowerShell, open it, and paste this in:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Press Command + Space, type Terminal, press Enter, and paste:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Open your terminal and paste:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
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.
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.
Windowsnotepad $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.
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 changes its own menus now and then, so if a button has moved, look for the closest match.
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
Telegram is the quicker one. Hermes creates the bot for you: you scan a code with your phone and tap one button.
hermes gateway setup
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
hermes pairing approve telegram <code> in
the terminal and message it again.
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.
bash install.sh.
Last thing, three small helpers that the wallet and trading skills need:
pip install eth-account coincurve pycryptodome
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.
31 skills to put to work
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-reconFor 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-mintAdds up every cheap listing in a collection and gives you the real total before you buy them all.
View playbook for nft-floor-sweepFor pages offering a free mint, a refund or an airdrop. It figures out what the site is really doing before you connect a wallet.
View playbook for onchain-claim-reverse-engineeringScores 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-engineAfter a reveal, finds the rarest items listed at normal floor prices and buys them before anyone notices.
View playbook for rh-chain-rarity-snipingBuys from the resale market, always testing the purchase first so a broken order never costs you a fee.
View playbook for nft-secondary-buyLooks at who minted and tells you whether they were real people or a few wallets faking interest to look popular.
View playbook for nft-minter-legitimacy-auditWhen a project says "we did X", this checks the blockchain to see if it is true.
View playbook for web3-claim-verificationFloors, sales, holders, how fast things flip. What the numbers actually say.
View playbook for nft-market-analysisWhat it is worth, what can go wrong after you buy, and whether the price makes sense for the risk.
View playbook for nft-collection-price-analysisRules for taking profit instead of holding forever. The boring one that saves the most money.
View playbook for nft-exit-disciplineMakes new wallets, backs the keys up properly, and moves tokens without ever exposing them.
View playbook for ethereum-wallet-operationsFollows specific wallets and pings you when they buy something.
View playbook for wallet-watcher-operationsTakes a list of wallets and hands you a clean, shareable spreadsheet.
View playbook for public-wallet-xlsx-deliveryLinks anonymous handles and wallets that belong to the same person.
View playbook for pseudonym-identity-researchThe art plan, the traits, the pricing, the mint page and the contract mechanics, all in one place.
View playbook for nft-collection-productionKeeps every attribute consistent and grouped so your metadata does not turn into a mess.
View playbook for nft-trait-taxonomyAudits each trait for duplicates and anything that looks wrong before you launch.
View playbook for nft-trait-curationPulls on-chain data without paying for an API. The engine under a lot of the others.
View playbook for ethereum-data-pipelinesA 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-roomA read-only screen of upcoming mints and market movement, noting where every number came from.
View playbook for mint-market-dashboardHashcats, 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-miningRuns that search on your machine or on rented hardware, with checking so it never wastes a transaction.
View playbook for onchain-puzzle-miningRiddles and hidden clues that gate some drops, found by reading the game's own code.
View playbook for onchain-puzzle-solvingTakes an on-chain game apart to show where value comes from.
View playbook for onchain-game-economy-analysisChecks what the betting markets are pricing for an event.
View playbook for polymarketBackground research on Proof of Play and Pirate Nation.
View playbook for proof-of-play-archiveLets an agent prove who it is when it posts online, so a real one can be told from a fake.
View playbook for agent-protocol-identityHow to give an agent its own account and have it post without leaking anything private.
View playbook for agent-public-identity-opsNotes for a different blockchain, the Internet Computer.
View playbook for internet-computer-developmentNo matching skills. Try a different term or category.
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.
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.
pip install modal
modal setup
The second one opens a browser and links your account. That is the whole setup.
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
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?
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.
@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
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
@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?
@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
@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
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>
@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
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.
Sign up at vercel.com/signup with GitHub, Google or email. The free plan is enough for everything here.
docs.From then on, every time you push to GitHub, Vercel rebuilds the site by itself. That is the whole workflow.
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.
git clone https://github.com/andyemad/nft-mint-rarity-toolkit.git
cd nft-mint-rarity-toolkit
npx vercel deploy docs --prod
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.
Both work. The only real difference is what happens when you close your laptop.
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.
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.
hermes setup --portal and it wires itself
up. If you are already paying for OpenCode, you do not need both.
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".
| Thing | Cost | Needed? |
|---|---|---|
| Hermes agent | Free | Yes |
| The 31 skills | Free | Yes |
| OpenCode subscription | ~$10/month | Yes, this is the brain |
| Vercel | Free | Only if you want a page online |
| Your own computer | Free | Fine, but it sleeps |
| Small server | ~$5/month | Only for running around the clock |
| Modal, for solving drops like Hashcats (optional) | Free, $30/month included | Only if you want to go after those drops |
| Nous Portal, hosting included (optional) | Listed on the Portal | Instead 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.
| What you see | What to do |
|---|---|
hermes is not recognised | Close the terminal and open a new one. Still failing after that? Restart the computer and try again. |
| Bot online but never answers | Message Content Intent is off in the Discord developer page. This is the number one cause. |
| Answers in DMs, silent in a server | Normal. In servers it only answers when you @mention it. |
| It says you are not allowed | Your Discord user ID is wrong. Copy it again with Developer Mode turned on. |
| Telegram replies with a pairing code | It does not know your account yet. Run hermes pairing approve telegram <code> in the terminal, then message it again. |
| Vercel deploy fails with 402 | That account went past the free transfer allowance. New project, or use GitHub Pages or Cloudflare Pages. |
| The agent stopped overnight | It was on your computer. That is expected. Move it to a server if you need it always on. |
| It asks you for more money | Check your OpenCode usage page. Long jobs use more than chatting does. |
| Skills do not show up | hermes skills list to confirm they installed, then /reload-skills in a chat. |
| You are lost | Run hermes chat and just describe what you are trying to do. |
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.