relay-agent v0.2.0 · MIT · In production

Complete infrastructure for Nostr relay operators

From strfry CLI to visual dashboard — five modules, one ecosystem.

Five modules, one pipeline

Data flows from your relay daemon to the panel. SDKs integrate signers and your own apps with the same API surface.

relay-agent

MIT

npm · strfry

REST API over strfry CLI — runs on your server.

GitHub

relay-api

Private

Vercel · Supabase

Central hub, proxy, and session store.

relay-panel

BSL 1.1

Vercel

Visual web dashboard for operators.

Open panel
relay-connect → relay-agent relay-connect-web → relay-api

@bitmacro/relay-connect

MIT

npm SDK

NIP-46 / NIP-07 client for apps and bots.

GitHub

relay-connect-web

MIT

Vercel

Reference NIP-46 UI for testing and forks.

GitHub

Architecture — network flow

Browser → relay-panel → relay-api → relay-agent → strfry Browser → relay-connect-web → relay-api → Supabase (NIP-46 sessions)

The panel never communicates directly with agents or Supabase. All logic goes through relay-api.

Developer guide

setup.shbash
1
2
3
4
5
6
7
8
9
10
# Install relay-agent on your server
npx @bitmacro/relay-agent

# Configure multi-relay (example)
export RELAY_INSTANCES='[
  {"id":"public","token":"your-token","strfryConfig":"/etc/strfry.conf"}
]'

# Sign in at relay-panel — Add relay → paste agent URL + token
# https://relay-panel.bitmacro.io

Licenses

ModuleLicenseCan use?
relay-agentMITYes — install, fork, contribute freely.
relay-connect SDKMITYes — use in any project.
relay-connect-webMITYes — self-host or fork.
relay-panelBSL 1.1View source, personal fork; commercial SaaS needs a license.
relay-apiPrivateBitMacro internal use.

Ship your relay with confidence

Start from the hosted panel or deploy agents yourself — same architecture either way.

← Back to BitMacro