Bluesky Feed Generator
A Go-based feed generator service for Bluesky social platform that includes components for streaming and processing posts, generating feeds, and exposing them via an API.
Overview
This project is a custom feed generator for Bluesky (ATProto), implementing the "AzPulse" feed. The application consists of several components working together:
- API: Serves feed data to Bluesky clients
- Consumer: Streams and processes posts from the Bluesky firehose
- FeedGen: Processes posts and generates the feed content
- Manager: CLI tool for managing feed generator records on Bluesky
Architecture
The system follows a microservices architecture with the following components:
- MongoDB for data storage
- Multiple services communicating through the database
- Each service deployed as a separate container
Pre-Built docker images
- API:
git.aykhans.me/bsky/feedgen-api:latest - Consumer:
git.aykhans.me/bsky/feedgen-consumer:latest - FeedGen Az:
git.aykhans.me/bsky/feedgen-generator-az:latest - Manager:
git.aykhans.me/bsky/feedgen-manager:latest
Getting Started
Prerequisites
- Docker and Docker Compose
- Go 1.24+
Running with Docker Compose
docker compose up
This will start all necessary services:
- MongoDB database
- Consumer service (streams posts from Bluesky)
- FeedGen service (generates the AZ feed)
- API service (serves feed data to clients)
Development
For local development without Docker you can checkout the Taskfile and Makefile for development tasks.
Configuration
All services are configured via environment variables. See the docker-compose.yml file for examples and default values.
License
This project is licensed under the AGPL-3.0 License, please see the LICENSE file for details.