runfcx

Run a Farcaster node
with your agent

Half the disk of the official setup. No API keys. Free with Vultr credit. Paste this line into Claude Code or Codex:

Set up my Farcaster node with https://antonpecherkin.github.io/runfcx/agent.md

No API keys · prefer to type it yourself?

Set up my Farcaster node with antonpecherkin.github.io/runfcx/agent.md
The server costs $0.26/h. Start?
go
$ runfcx status
Phase:  downloading
Shard:  1  chunk 1156/2672  ETA 0h56m
Disk:   108 GB used, 790 GB free
RAM:    0 GB used
Your turn · sign in with your wallet

Measured on our mainnet runs

What we found running it

Snags we hit, so you don't
  • Upstream's installer can quit before the node starts. runfcx starts it
  • The server's own firewall can block gossip. runfcx opens the port
  • A shard can quietly sync from block 1 for weeks. runfcx status warns you
  • Finding your account on a real node takes ~22 s. runfcx waits for it

The server

Run it for $0

The node runs on a rented server. New Vultr accounts get $300 of credit, which covers many runs.

Get $300 in server credit
vultr.com/?ref=9929634-9J code 9929634-9J

Our referral link: the code applies when you sign up through it, and we get a small bonus too. Set up the server in 10 minutes

THE WHOLE BILL
Server$0.12/h
Disk$0.14/h
API keys$0
Gas$0
24 h of node$6.24
Vultr credit−$300
YOU PAY$0
MEASURED ON OUR RUN · OCT 2026

You do three things

The agent does everything else and tells you when it's your turn.

  1. Paste the lineinto Claude Code or Codex
  2. Say yes to the priceit asks before renting anything
  3. Sign in with your wallettwo clicks, see how
What the agent does meanwhile
  • Rents and secures the server
  • Installs the node and waits for it to sync, with progress updates
  • Checks your sign-in worked and shows you your feed
  • Never sees your seed phrase, and posts nothing without asking

Ready? Paste this into your agent

Set up my Farcaster node with https://antonpecherkin.github.io/runfcx/agent.md

Signing in

Your wallet signs twice
Your keys stay safe in MetaMask or Rabby

  • A key with limitsIt can cast, like and follow. Nothing else
  • On your computer onlyThe sign-in page runs on your laptop, behind a one-time link
  • Undo anytimerunfcx logout removes it
  1. $ runfcx login --walletrunfcx opens a page on your laptop
  2. Signature requestApprove runfcx as the app asking for a keyApproveYour wallet asks once
  3. Signature requestAdd a key that can cast, like and follow · 30 daysApproveand once more
  4. Logged in as @you · try: runfcx feedDone. No gas spent

The most useful thing you can do

Got it running? Vouch for it

runfcx qualifies for the bounty when someone else sets up a node and client with this guide and says so publicly. That someone can be you.

  1. Finish the setupyour node is synced and runfcx whoami shows your account
  2. Post a public cast in your own wordsdid it work, how long it took, what you'd change
  3. Tag @aap or send us the linkso we can add it to our entry

Posting it with runfcx cast from your new node is the strongest proof.

How to vouch