Ruby gem for ingesting ATProto repo data from a Tap service (extension of Skyfall gem)
mackuba.eu
Compare changes
Choose any two refs to compare.
+6
-1
README.md
+6
-1
README.md
···
33
33
34
34
## Installation
35
35
36
-
Add this to your `Gemfile`:
36
+
Tapfall should run on any somewhat recent version of Ruby (3.x/4.x), although it's recommended to use one that's still getting maintenance updates, ideally the latest one. In production, it's also recommended to install it with [YJIT support](https://shopify.engineering/ruby-yjit-is-production-ready) and with [jemalloc](https://scalingo.com/blog/improve-ruby-application-memory-jemalloc). A compatible version should be available on most Linux systems, otherwise you can install one using tools such as [RVM](https://rvm.io), [asdf](https://asdf-vm.com), [ruby-install](https://github.com/postmodern/ruby-install) or [ruby-build](https://github.com/rbenv/ruby-build), or `rpm` or `apt-get` on Linux (see more installation options on [ruby-lang.org](https://www.ruby-lang.org/en/downloads/)).
37
+
38
+
To use it in your app, add this to your `Gemfile`:
37
39
38
40
gem 'tapfall'
39
41
···
147
149
end
148
150
end
149
151
```
152
+
153
+
> [!NOTE]
154
+
> If you're doing a full network backfill of some app.bsky.* lexicons, that's going to be a *lot* of events that Tap will be sending to you, on localhost (so not limited by network bandwidth), likely in large bursts. In that case it's [recommended](https://bsky.app/profile/did:plc:ragtjsm2j2vknwkz3zp4oxrd/post/3mawmnwukws2w) to try to do as little processing as possible in the event handling loop, and especially avoid any sync network requests there. If you're working with a limited number of repos and/or with non-Bluesky lexicons only, this is probably much less of an issue.
150
155
151
156
152
157
### Note on custom lexicons