AIONOSTR(1)

Welcome to the aionostr Manual 💖 bestie, this is your guide to the whole vibe 🫶

🦋 NAME 🦋

Okay so aionostr is an asyncio Nostr client command-line interface, and it is literally iconic 💅

✨ SYNOPSIS ✨

aionostr [OPTIONS] COMMAND [ARGS]...

🌸 DESCRIPTION 🌸

aionostr is a command-line client for the Nostr (Notes and Other Stuff Transmitted by Relays) protocol 📡. It's built on asyncio so it can do high-performance asynchronous operations, which is giving speed 🔥

This is a fork of aionostr that does not require Coincurve. It uses electrum-ecc instead, so no Coincurve needed 🦋

🎀 OPTIONS 🎀

• --help — Shows the help message and exits. Lowkey the first thing you should try 🙈

💜 COMMANDS 💜

get NOSTR_ID

Retrieves and displays Nostr objects like nprofile, nevent, and so on ✨

• Basic version:

aionostr get nprofile1qqsv0knzz56gtm8mrdjhjtreecl7dl8xa47caafkevfp67svwvhf9hcpz3mhxue69uhkgetnvd5x7mmvd9hxwtn4wvspak3h

• With -v:

aionostr get -v nevent1qqsxpnzhw2ddf2uplsxgc5ctr9h6t65qaalzvzf0hvljwrz8q64637spp3mhxue69uhkyunz9e5k75j6gxm

query [OPTIONS] FILTER_JSON

Queries Nostr relays with custom filters 🧚

aionostr query -s -q '{"kinds": [1], "limit":10}'

send [OPTIONS]

Sends events out to the Nostr network 💌

aionostr send --kind 1 --content "test" --private-key <privatekey>

mirror [OPTIONS] FILTER_JSON

Mirrors events between relays 🪞

aionostr mirror -r wss://source.relay -t wss://target.relay --verbose '{"kinds": [4]}'

gen

Generates a brand new Nostr key pair 🔑 ✨

🌈 ENVIRONMENT VARIABLES 🌈

NOSTR_RELAYS

A comma-separated list of default relays to use 📮

export NOSTR_RELAYS=wss://brb.io,wss://nostr.mom

NOSTR_KEY

The default private key used for signing events 🔐

export NOSTR_KEY=$(aionostr gen | head -1)

💅 EXAMPLES 💅

Basic usage with environment variables

Set up your env vars first, then go wild 💖

export NOSTR_RELAYS=wss://relay.damus.io
export NOSTR_KEY=$(aionostr gen | head -1)
aionostr send --kind 1 --content "Hello Nostr!"

Query for recent text notes

aionostr query '{"kinds": [1], "limit": 5}'

Mirror direct messages between relays

aionostr mirror -r wss://relay1.com -t wss://relay2.com '{"kinds": [4]}'

📁 FILES 📁

• /usr/bin/aionostr — The main executable 🫧
• /usr/lib/python3*/dist-packages/electrum_aionostr/ — The Python library files 🐍

🔗 SEE ALSO 🔗

curl(1), python3(1)

The Nostr protocol specification lives at https://github.com/nostr-protocol/nips 📖

🙈 BUGS 🙈

Report bugs to the Debian Bug Tracking System at https://bugs.debian.org/ 🐛

Or upstream at https://github.com/spesmilo/electrum-aionostr/issues 🐞

👑 AUTHOR 👑

The Electrum Developers, who are the fork maintainers 🫶

Original author: Dave St.Germain 💜

📜 COPYRIGHT 📜

BSD License 🩵

This is free software: you are free to change and redistribute it 🌷

---

Bye bestie 💖 this page is version 0.0.11, last updated 2025-09-25, and it's all about AIONOSTR(1) 🦋 periodt ✨