⚠️ Beta Software: Lyrebird is currently in beta. Features and APIs are subject to change.
A distributed microservices platform for real-time sentiment analysis of Bluesky content.
Lyrebird ingests data from Bluesky (AT Protocol), performs sentiment analysis, and delivers insights through a REST API. Built with NestJS, RabbitMQ, and PostgreSQL/TimescaleDB.
# Clone and install
git clone https://github.com/0-sayed/lyrebird.git
cd lyrebird
pnpm install
# Start infrastructure
docker compose up -d
# Run services
pnpm start:all| Service | Port | Description |
|---|---|---|
| Gateway | 3000 | REST API & Swagger docs |
| Ingestion | 3001 | Bluesky scraper |
| Analysis | 3002 | Sentiment analysis engine |
pnpm start:dev # Start with hot-reload
pnpm test # Run tests
pnpm lint # Lint code
pnpm db:studio # Drizzle Studio- Runtime: Node.js 22+, TypeScript 5.7
- Framework: NestJS 11
- Database: PostgreSQL 16 + TimescaleDB
- Queue: RabbitMQ 4.0
- ORM: Drizzle
See CONTRIBUTING.md for guidelines.
MIT - Sayed Ashraf