Feed generators are services that provide custom algorithms to users through the AT Protocol.

They work very simply: the server receives a request from a user's server and returns a list of post URIs with some optional metadata attached. Those posts are then hydrated into full views by the requesting server and sent back to the client. Read more...

Running Locally

uv venv
source .venv/bin/active
flask --debug run

Publishing

To update the feed's display data (name, avatar, description, etc.), just update the relevant variables in .env and run python publish_feed.py.

Endpoints

• /.well-known/did.json
• /xrpc/app.bsky.feed.getFeedSkeleton
• /xrpc/app.bsky.feed.describeFeedGenerator