awesome-nostr/README.md

"nostr" stands for "Notes and Other Stuff Transmitted by Relays" and is an open protocol for censorship-resistant global networks created by @fiatjaf.

Protocol

• nostr - overview and FAQ
• NIPs - the "Nostr Implementation Possibilities" describe the protocol in technical detail
• nostr, a basic tour - an intro to nostr
• Nostr: Solucionando la censura de una vez por todas
• UseNostr - A small guide for anyone who wants to learn more about how nostr works and what it can do.
• nostr.how - Quick-start to onboard desktop users with Alby & Astral

Relays

Relays are (so far) application agnostic. You can run your own or use any or all of the public instances.

Implementations

• NNostr - a C# relay
• nostr-rs-relay - a minimalistic relay written in Rust that saves data on SQLite
• Relayer Basic - a simple relay based on relayer backed by Postgres
• nodestr - a Node.js implementation
• sovereign-stack - a tool that helps you deploy nostr relays and create self-hosted (bitcoin-only) Value4Value websites.
• expensive relay- a relay that requires payment for registration
• me.untethr.nostr-relay - a relay written in Clojure
• Minds Nostr Relay - a relay for Minds, an open-source social network
  • Minds Engine - Nostr - relevant Minds API code for reading/writing Minds posts using Nostr
• NostrPostr Relay - a Kotlin Relay supporting both SQLite and Postgresql
• nostrpy - relay, client, and other tooling in python
• nostream - a nostr relay written in Typescript backed by PostgreSQL (renamed from nostr-ts-relay)
• nostr_relay – a nostr relay written in python, backed by SQLite
• søstr – a private nostr relay written in rust, saves all notes from one pubkey and publish them to anyone that requests them
• knostr – a nostr relay implemented in Kotlin with support for Postgres and metrics(micrometer).

Instances

Instances are plenty and their availability may vary but these projects track them:

• nostr relay registry - real-time checking of status of some known relays
• nostr.info - real-time checking of status of some known relays
• nostr.watch - real-time checking of status of some known relays

Clients

• branle - a Twitter-like client with chat. Some instances:
  • branle.netlify.app - by fiatjaf
  • nostr.rocks
  • branle.wlvs.space
  • branle tor - on tor
• astral - a branle fork with global feed and UI makeover
  • astral.ninja
  • client.nostr.guide
• damus - a twitter-like nostr client for iOS and MacOS
  • damus on testflight
• more-speech - desktop client for nostr written in Clojure
• futr - nostr client desktop app written in Haskell
• Minds - open source social network. Supports reading and creating posts using the Nostr protocol
• Jester - Chess over nostr
• Sendstr - shared clipboard between devices over nostr
• nosbin - pastebin over nostr
• noscl - a basic command-line client written in Go
• loquaz - a desktop app written in Rust for direct encrypted chat
• nostr console - a nostr command line client written in Dart. Binaries available for Windows, Linux, and MacOS
• ArcadeCity - Public group chats and P2P services (WIP) over nostr
• second exchange - an experiment to work out something of like medium, something of creator economy where users are rewarded for engaging in quality discussion and most importantly engaging in governance-related discussion
• scalastr - A barebones nostr client written in scala
• Nostros - A nostr mobile client for Android
• NostrEmitter - Simple E2E encrypted client and EventEmitter object
• Lightning.Pub - A nostr daemon for Lightning nodes
• shockwallet - A Lightning wallet that uses nostr and lnurl to connect to nodes
• coracle - A nostr web client
• nostrweb - another nostr web client in vanilla JS
  • nostr.ch - live instance
• Bija - A desktop client written in python. Currently Linux only
• Nosky - A native Android client for Nostr. Still in development
• Stackerstan - A decentralised organisation built on Bitcoin and Nostr, implemented as a replicated state machine in Golang
• nostr-java - A nostr client API written in java, for generating, signing and publishing events to relays
• bolt.fun - A bitcoin lightning makers community that supports reading and creating comments using Nostr
• iris - A nostr web client
• gossip - A desktop client in rust presented with egui
• Attached - Open-Source ReactNative Expo app for Nostr (iOS, Android). Currently under app stores review.
• Member - Progressive Web App Client. Works on desktop and mobile.
  • member.cash - live instance
• dispute - A cross-platform (Linux, Android, iOS, MacOs, Windows and Web) client for NOSTR
• Snort - Nostr UI written in react
  • snort.social
• Hamstr - A twitter-style web client based on astral
  • hamstr.to
• Nozzle - A Twitter-like native Android client written with Jetpack Compose
• electron-nostr - A bare-bones desktop nostr client using electron-react-boilerplate. Goal is to be an easy template for people to experiment with different ideas on decentralized ratings, reputation, and web of trust
• Nostrid - Multi-platform client currently offering binaries for Android and Windows.
  • Nostrid.Web - A preview version of Nostrid running completely on the browser. It can be installed locally as PWA.
• nostr-chat-widget-react - A React component that provides a live-chat widget over nostr that can be embedded into any website.
• Blockcore Notes - Progressive Web App that can be installed on mobile and desktop, organize following in circles and have both public and private following lists. Dynamic interface for different uses, such as optimized for photograph viewing.
  • notes.blockcore.net

Client reviews and/or comparisons

• Feature comparison list of Nostr clients

Libraries

• nostr-ruby - a Ruby implementation of the nostr protocol
• NNostr.Client - a C# Nostr library for use by clients
• nostr-tools - a JavaScript client that abstracts the relay management code for use by clients
• nostr-relaypool-ts - a TypeScript relay pool library on top of nostr-tools that simplifies handling subscriptions to multiple servers
• nostr-react - React Hooks for Nostr
• go-nostr - a Go library that implements relay management, plus event encoding and signing utils
• nostr_rust - Functional Rust implementation of the nostr protocol
• nostr-js - a javascript implementation of the nostr protocol
• nostr-rs - a Rust implementation of the nostr protocol
• nostr-rs-sdk - Nostr protocol implementation, SDK, and FFI written in Rust
• relayer - a server framework for writing custom relays
• NostrPostr - a Kotlin Nostr library for clients or relays
• python-nostr - a python library for making clients
• nostr-bot - a Rust library for writing bots
• NostrKit - a Swift library for interacting with relays
• nostr-relay-inspector![stars](https://img.shields.io/github/stars/dskvr/nostr-relay-inspector.svg?style=social - A library that returns useful information about relays based on nostr-js
• schorr_snap - A snap plugin for Metamask Flask, supports nostr
• nostr-deno - a client library for Deno javascript runtime.
• nostr-types - a rust library defining types useful for the nostr protocol
• dart-nostr - a Dart library for Flutter

Bridges and Gateways

• rsslay - a bridge that puts RSS feeds into Nostr
• smtp nostr gateway - a bridge that forwards emails to pubkeys as encrypted direct messages
• matrix-nostr-bridge a simple Matrix-to-Nostr or Nostr-to-Matrix bridge

Tools

• git-nostr-tools - A cli tool for sending code patches over nostr
• nostr-cln-events - A CLN plugin to push clightning node events to nostr
• nostr registry - a database of known relays with their uptime and NIP support tables
• nostr-fzf - Nostr Directory; a tool for searching usernames and channels
• nostr-notify - desktop nostr notifications using libnotify
• nostr-launch - a tool for launching a bunch of relays and clients locally for development and testing
• nos2x - nostr signer extension - a browser extension for signing events on 3rd party site without sharing your private keys with them
• nostr GitHub Action - send events from GitHub Actions
• nostrefresh - simple refresh function for nostr web pages
• anonroom - anonymous chat room inside nostr
• nostril - C cli tool for creating nostr events
• nostr-rs-relay-compose - a Docker compose deployment for nostr-rs-relay with SSL support based on Traefik
• tostr - a twitter to nostr bot
• nostr.guru - a nostr web gateway for viewing events by their ID
• nostrandom.netlify.app - generate publish-able Nostr event with random keys
• nashboard - a Nostr network dashboard with network statistics, reachable here
• nostr army knife - nostr army knife by fiatjaf
• joinstr - coinjoin implementation using nostr
• ndxstr - nostr's layer 2 indexing nodes, with more advanced querying capability than currently supported by relays
• nostrillery - a tool for running performance tests against Nostr relays
• nostr-terminal - SSH-like access to your machine via web terminal, powered by Nostr.
• nostcat - cat-like nostr client for scripting and debugging written in Rust
• rana - Nostr mining pubkey with multi threading
• nostreq - Nostr relay event request generator
• nostr.io - network statistics with last published notes, top 50 publishers, and top 50 followed users
• nostr-commander - simple but convenient CLI-based Nostr app for following users, sending DMs, etc.
• nostr.directory - searchable database of nostr users and their other social media links.
• nostr-tool - Rust CLI tool to generate and publish events
• nostrplebs - A NIP-05 ID registration service.
• frostr - Create joint nostr identities and require t-of-n signatures to post
• plebs.place - A NIP-05 ID registration service (in portuguese).
• nostr.rest - Mine proof of work public keys with user specified prefixes
• lnpass - A key manager for Lightning and nostr.
• sb.nostr.band - Search bots that you can create and follow to receive new posts matching a keyword right into your feed.

Browser extensions

Allow you to sign Nostr events on web-apps without having to give them your keys

• Alby - Bitcoin Lightning app with nostr support
• nos2x - Nostr Signer Extension
• wen - browser extension for website enhancer with nostr
• Blockcore - Multi wallet browser extension with nostr support

Community

Outside of nostr itself, you find the community on:

• nostr telegram group - a telegram group for nostr protocol discussion
• nostr reddit - a subreddit for nostr related discussion

Tutorials

• Step-by-Step guide to set up a relay on your server (AWS, DigitalOcean, RaspBerry... )
• Set up a nostr relay server in under 5 minutes
• nostr workshop with super testnet
• Nostr Newcomers Most Common Questions and Answers

Deprecated

• anigma.io - has known xss attack vulnerabilities, which can put private key at risk, or risk signing events you may not want to send.
• nvote - it does server side processing, and even private key is handled server side, and as such is deprecated for normal use.
• alphaama.com - is under maintenance as of late 2022.

Other links

• nostr on YouTube
• vanilla-js-nostr - a demo of posting and viewing a feed in nostr using vanilla javascript
• nostr playground in Ruby
• search posts/profiles by keyword - posts from major relays indexed and searchable in real-time
• nostr.build - nostr image uploader
• wellorder nostr datasets - Public standardized nostr datasets for benchmarking, data science, or other analysis.
• Nostrovia Podcast - A Nostr podcast covering all the new projects, all the new cool stuff, all the new NIPs
• Summaries of all Nostr Improvements Proposals - ChatGPT generated summaries of all NIPs by k00b

Data for this list is contributed by the community and curated by @aaaljaz.