ruby.sdk.blue #

This repo is the source code of the documentation website ruby.sdk.blue about the collection of gems called the Ruby SDK for ATProto.

Links to specific repos #

• skyfall (firehose client)
• minisky (XRPC API client)
• didkit (DID/handle resolution utils, PLC directory)
• blue_factory (feed service builder)
• tapfall (tap client)

And some sample projects using these:

• bluesky-feeds-rb – template of a full feed service project
• Lycan – search engine for your likes
• Tootify – Cross-poster to Mastodon
• RatProto – command-line tool for accessing ATProto

Examples #

You can also find a lot of simple examples for the above gems in the examples directory in this repo.

To run the examples, first install the dependencies:

bundle install

Then run any example like this:

./examples/find_missing_follows.rb

All of the examples except the Tapfall one (list_labellers.rb) should run on Ruby 2.6 and above, including the default ones shipped in macOS 11+ (if anything doesn't work, let me know!).

Credits #

Copyright © 2026 Kuba Suder (@mackuba.eu).

The code of the gems described here is available under the terms of the zlib license (permissive, similar to MIT).

The examples in the examples folder are under the WTFPL license – feel free to take any fragments of those and use them in your code without any strings attached.