Hypersnap Lite

Local Farcaster write relay. No full-state sync. QR once. Post from localhost.

  1. Install Hypersnap Lite.
  2. Let the command run. It writes files to ~/.hypersnap-lite, starts Hypersnap Lite, starts the local command center, and prints the localhost URL.
  3. Leave the CLI. Open the URL it gives you: http://127.0.0.1:8890.
  4. Scan once as the host account. In the local command center, create a host signer and scan the QR with the Farcaster account that will host/run this client.
  5. Post through your node. After approval, write a cast in the local command center. The signer stays encrypted on your machine. The signed message goes through your local Hypersnap Lite relay.
  6. Hack it. Read install.sh, copy AGENTS.md, or fork the source.
The hosted endpoint at /api/signer-requests only creates Farcaster signer requests. It does not receive the local signer private key.

Canonical signer page

/connect is the public approval surface. A local client can generate a signer key, send the public key to this page, and any Farcaster account can approve it.

Local files

~/.hypersnap-lite/app
~/.hypersnap-lite/env
~/.hypersnap-lite/data/signers.json
~/.hypersnap-lite/rocks-lite
~/.hypersnap-lite/logs/server.log

Old rule: run your own thing, keep your keys close, inspect the code.