firehose
A JavaScript SDK for Bluesky and AT Protocol by skyware-js
A dead simple client for subscribing to an ATProto Relay ("firehose").
GitHub Stats
39stars
3forks
2contributors
1open issues
Dates
Created:February 23, 2024
Last updated:October 13, 2025
README
The following content is from firehose's GitHub repository. All rights reserved by the original author.
@skyware/firehose
A simple client for consuming data from an AT Protocol Relay.
Installation
npm install @skyware/firehose
Example Usage
import { Firehose } from "@skyware/firehose";
const firehose = new Firehose();
firehose.on("commit", (commit) => {
for (const op of commit.ops) {
console.log(op);
}
});
firehose.start();
Events
| Event | Description |
|---|---|
commit | Represents a commit to a user's repository. |
identity | Represents a change to an account's identity. Could be an updated handle, signing key, or PDS hosting endpoint. |
handle | Represents an update of an account's handle, or transition to/from invalid state (may be deprecated in favor of identity). |
tombstone | Indicates that an account has been deleted (may be deprecated in favor of identity or a future account event). |
info | An informational message from the relay. |
open | Emitted when the websocket connection is opened. |
close | Emitted when the websocket connection is closed. |
error | Emitted when an error occurs while handling a message. |
websocketError | Emitted when an error occurs with the websocket connection. |
Related SDKs
interactive-feedA Twitter, Mastodon, and BlueSky bot that shares new interactive, graphic, and data vis stories from newsrooms around the world
58•JavaScript
atprotoAT Protocol Reference Implementation (TypeScript)
8870•JavaScript
twitter-to-blueskyImport all tweets exported from X/Twitter to a Bluesky account.
627•JavaScript
FxEmbedFix X/Twitter and Bluesky embeds! Use multiple images, videos, polls, translations and more on Discord, Telegram and others
3671•JavaScript
atproto-scrapingGit scraping of AT Protocol/Bluesky instances
152•JavaScript
bluesky-labeler-scrapingGit scraping of Bluesky labelers/label providers
68•JavaScript
Resources
Our Sponsors
Your Brand Here!
50K+ engaged viewers every month
Limited spots available!
📧 Contact us via email🦋 Contact us on Bluesky