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
• nostr.guide - A guide to all things nostr
• nostr address book - A directory of twitter users accounts and their NOSTR addresses
• tinkering with nostr without any client

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).
• PyRelay – a python implementation of a nostr relay, using asyncio.
• strfry – C++ implementation backed by LMDB with efficient syncing of events using merkle trees
• Astro– Elixir based implementation built to be performant and highly distributed.
• Nex - A powerful and scalable Nostr relay written in Elixir with Postgres DB.
• gnost-relay - nostr relay written in go backed by postgresql database.
• nostring - A Nostr relay written in Deno.
• Denostr - Deno based, cloud native nostr implemention support by ByteTrade and Revo.
• nostr-relay-nestjs - A Nostr relay implemented using the NestJS framework
• Ephemerelay - An in-memory Nostr relay that doesn't store data.
• Servus - A self-contained, single executable, CMS / blogging engine reminiscent of Jekyll which also acts as a personal Nostr relay for your blog posts. Written in Rust.

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

• Astral - a branle fork with global feed and UI makeover
  • astral.ninja
  • client.nostr.guide
  • Astral on TOR
• 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
  • Jester instance
• 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
• Nostrify.me - Nostr client built in SvelteKit.
  • Nostrify.me - Live instance.
• 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
  • iris.to - live instance
  • Android app
• 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 built with Vue.js
  • 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, Windows, MacOS and Linux.
  • Nostrid.Web - Web version 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
• Noteon - Yet another nostr client focused on private chat and group chat with a simple, elegant and secure interface.
  • nostr.noteon.io
• emon - Encrypted DMs over nostr with lightning payments integrated (WIP).
  • emon.chat
• notebin.org - Nostr UI created with NextJS, support for markdown and code highlighting
• Daisy - Mobile client for Android and iOS
  • testflight + android builds
• Flycat - A 2000s old-school style web client which support blogging on Nostr
• Amethyst - An Android client for nostr written in Kotlin
• MeShell - Web, iOS and Android blog type client destined to publish articles and researches for independent journalists.
  • MeShell.io - Landing page for more information
• Disgus - A comment widget like Disqus, but for Nostr.
• Tamga - An offline first nostr contact & profile manager for iOS!
• nostromat - A Twitter-style Nostr web client, written in Clojurescript/React
  • nostrom.at - live instance
• blogstack.io - Blogging site for nostr, supports markdown
• Votestr - Poll web app with nostr authentication and blind signature unlinkability
• gnost-deflate-client CLI nostr client written in go implementing permessage-deflate websocket compression.
• algia - A cli application for nostr.
• algia-web - A small resource consumption oriented Nostr web client.
• Blowater - A desktop Web client focusing on chat with delightful UX.
• Written Self hosted blog using nostr long-form content (NIP-23) and it shows only posts by selected authors.
  • Demo
• Nostr Nests - Nostr Nests is an audio space for chatting, brainstorming, debating, jamming, micro-conferences and more.
• nblog - a self-host nostr ghost blog
• Nostribe.com - Nostr client web app built with Next.js 13 and TypeScript.
  • Nostribe.com - Live instance.
• ourChan.org Anonymous imageboard on nostr, from a fork of 4Chan.org
• Nostrtium - Post to Nostr directly from within WordPress
• uBlog - A minimalist blog on nostr that allows anyone to easily create their own personal micro-blog.
  • u-blog.vercel.app
• Listr - A Nostr Web Client for Making Lists, built with Next.js 13 and TypeScript.
  • Listr-demo.vercel.app - Live instance.

Client reviews and/or comparisons

• Feature comparison list of Nostr clients

Libraries

• arduino-nostr(https://img.shields.io/github/stars/lnbits/arduino-nostr.svg?style=social) - An Arduino nostr library.
• nostr-ruby - a Ruby implementation of the nostr protocol
• nostr - a Ruby Nostr gem for use by clients
• 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:
  • nostr: Rust implementation of Nostr protocol.
  • nostr-sdk: High level client library.
  • bindings: UniFFI (Kotlin, Swift, Python, Ruby) bindings
• 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 - 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
• nostr-connect - Nostr Connect SDK for TypeScript is a library that allows you to easily integrate Nostr Connect into your web application
• pynostr - a python library for nostr
• nostr-php - a PHP library for nostr

Bridges and Gateways

• rsslay - fork of the rsslay by @fiatjaf. a bridge that puts RSS feeds into Nostr optimized, more funcionalities and UI improvements. Live at rsslay.nostr.moe
• 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
• Mostr - a bridge between Nostr and the Fediverse (Mastodon, ActivityPub, etc.)

Tools

• nostrich.fun - A feature-rich directory of nostr projects. A fork of LightningNetworkStores.com
• 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
• 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
• frostr - Create joint nostr identities and require t-of-n signatures to post
• 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.
• rss.nostr.band - Create custom RSS feeds with posts matching your keywords and consume using your favorite RSS reader.
• nostrview - A nostr search engine. Search by content, tags, events or pub keys.
• nostr-bulk-dms - A tool that allows you to send DMs over nostr to many recipients in bulk.
• nostrify - A Core Lightning plugin that sends events (forwards, connect, disconnect, etc.) to nostr.
• nip06-web - a website to generate or restore NIP-06 seed phrases
  • nip06.jaonoct.us - by jaonoctus
• nip06-cli - a Node.js CLI to generate or restore NIP-06 seed phrases
• nostr-broadcast This tool lets you take your events from some relays and broadcast them to another relay. Could be helpful for backing up your notes to a private relay.
• nostr-follow-bundler This tool lets you create lists of profiles that other users can then see and follow themselves.
• nostr-proxy - Push and get events to your Proxy, get results from multiple Nostr relays.
• nostrends - Trending on Nostr, like Twitter trends. Live at nostrends.vercel.app.
• homebrew-nostr - Homebrew tap for Nostr software.
• heyxynip5 - A CLI helper for converting nostr npub/nsec to their hex format for NIP-05 verification.
• http-nostr-publisher - A Cloudflare worker to publish Nostr events to relays through a non-blocking HTTP interface .
• blastr - A nostr cloudflare workers proxy relay that publishes to all known relays.
• keystr-rs - An application for managing Nostr keys. Written in Rust, with simple UI (Iced).
• nostr_simple_publish- Drupal module to publish content to Nostr.
• nostr-spam-detection - An experiment in building a machine learning model to label Nostr spam content for filtering and relay rejection.
• blogsync - Self-host blog articles from long-form notes e.g. via Caddy server.
• NostrFlu - A tool to collect and resend following lists from relays. You can also check badges.
• nkcli - A CLI tool for nostr key manage and serve NIP-46.
• git-nostr - A tool to enhance git cli with nostr communications. Publish patch content, prs, repo name, issues, etc to nostr relay.
• nostr-wtf - A set of nostr tools available and deployed on a web app including a pubkey converter and relay query tool.
• strfry policies - A collection of moderation & antispam policies for the strfry relay developed in TypeScript/Deno.
• powrelay.xyz - A proof of work based nostr explorer.

NIP-05 identity services

• nostrcheck.me - A NIP-05 ID registration service.
• nostrplebs - A NIP-05 ID registration service.
• plebs.place - A NIP-05 ID registration service (in portuguese).
• nanostr A NIP-05 name server written in Deno.
• nostr.industries - A free and open source NIP-05 ID registration service. Run your own.
• younostr.com - A NIP-05 ID registration service (in portuguese).
• nostrprotocol.net - A free NIP-05 identifier service.
• nostr.ly/easyNostr - NIP-05 ID provider: Use your own domain, or one of ours: nostr.ly, mynostr.io, easyNostr.com. Free (for now).
• getalby.com - Lightning wallet with NIP-05 ID registration service.
• iris.to — A Nostr client that provides a free NIP-05 ID
• bitcoiner.chat - A free NIP-05 ID registration service.
• pleroma2nip05 - A Python based service to link pleroma ID's to nostr keys.
• nip05.social - A free and anonymous NIP-05 ID registration service
• nostr-relay.org - A NIP-05 ID registration service

Offline signer

• keechain - Bitcoin application to transform your offline computer in an AirGap Signing Device (aka Hardware Wallet) with support to NIP-06 and NIP-26.
• nostrum - Nostrum it's a mobile app that allows you to sign transactions and messages with your Nostr keys. Nostrum is the reference implementation for a remote signer app (ie. Wallet) of the Nostr Connect protocol.
• nostr-signing-device - Signing device for Nostr built on ESP32

Vanity pubkey mining

• nostr-pubminer - A simple tool to mine nostr vanity pubkeys
• rana - Vanity pubkey miner based on nip13
• glasnostr - CLI tool to mine a vanity prefix for your nostr npub
• nostrogen - simple web based nostr vanity address generator
• nostr-vanity-address-generator - Cross-platform nostr vanity address generator
• go-pubmine - Multithreading nostr keypair generator which gives pretty (vanity) public keys. Both cli and web app are available.
• key-generator - A simple tool to generate nostr keypair.

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
• Flamingo - Nostr browser extension with a focus on UX
• nos2x - Nostr Signer Extension
• wen - browser extension for website enhancer with nostr
• Blockcore - Multi wallet browser extension with nostr support
• Nostore - Nostr Signer Extension for iOS/macOS Safari
• nostr-keyx - A NIP-07 browser extension that uses the OS's keychain or YubiKey to protect your private keys.
• TokenPocket - Multi wallet browser extension with nostr support. https://tokenpocket.pro

Community

Outside of nostr itself, you find the community on:

• nostr telegram group - a telegram group for nostr protocol discussion

• nostr español/spanish telegram group - a spanish telegram group for nostr

• nostr france/french telegram group - a french telegram group for nostr

• nostr reddit - a subreddit for nostr related discussion

• nostr discord - a discord server for nostr enthusiasts and developers

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
• How to: Run your own nostr relay (nostr-rs-relay, Caddy, no Docker)
• How to set up a paid nostr relay
• strfry personal relay - 10 minute setup of a personal nostr relay on a vanilla Linux VPS. Adds support for NIP-65.

Deprecated

• branle - a Twitter-like client that was discontinued but lives on in its fork "Astral".
• 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.
• rsslay - a bridge that puts RSS feeds into Nostr

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
• inosta api - Expensive Image Hosting Service
  • api.inosta.cc - Backend live instance
  • inosta.cc- Demonstrator live instance
• 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
• Media caching server for Nostr - caches resized profile pictures and banners to save bandwidth for clients
• nostr icons - Purple, white, and black icons in various formats designed for nostr.

Data for this list is contributed by the community and curated by @aaaljaz ( npub1aljazgxlpnpfp7n5sunlk3dvfp72456x6nezjw4sd850q879rxqsthg9jp)

Contributors