Ai Bulletin
A fully autonomous, AI-powered weekly tech newsletter that summarizes the top stories, dives deep into trends, and delivers beautifully formatted content straight to your inbox.
Tech Stack :
Let the AI read the news — You read the bulletin.
🚀 Overview
AI Bulletin is a self-operating newsletter system designed to:
- 🧠 Use CrewAI agents to generate insightful, structured content
- 📨 Deliver formatted newsletters via SendGrid
- ⚡ Run on a lightweight FastAPI backend
- 🗓️ Schedule and automate weekly generation and delivery using APScheduler
Built for AI-curious hackers who want to stay informed.
📊 Ai Bulletin - Week 2025-W23
🎯 Project Goal
To automate every part of a newsletter workflow:
- ✍️ Curate and plan relevant content
- 🔍 Summarize and analyze top stories
- 🖋️ Format a professional-grade newsletter
- 📤 Email it to all subscribers
Without any human in the loop. Just subscribe and enjoy.
🧠 Agents & Responsibilities
| Agent | Responsibility |
|---|---|
| TopicPlannerAgent | Plans weekly theme and outlines subtopics |
| TopStoriesAgent | Summarizes the top 3 tech/AI stories |
| DeepDiveAgent | Provides in-depth analysis on a major topic |
| ToolOfTheWeekAgent | Recommends trending AI tool with summary |
| QuoteAgent | Picks a relevant quote or tweet |
| AIInTheWildAgent | Highlights a real-world AI use case |
| HotTakesAgent | Adds quick, opinionated commentary |
| EditorsNoteAgent | Writes a personalized closing note |
| NewsletterEditorAgent | Edits and compiles all section drafts |
| HTMLFormatterAgent | Styles and formats final HTML for email delivery |
🧱 Architecture
🔁 System Flow
- ← Done by TopicPlannerAgent
- TopStoriesTask, DeepDiveTask, ToolTask, QuoteTask, AIWildTask, HotTakesTask, EditorsNoteTask
- ← NewsletterEditorAgent
- ← HTMLFormatterAgent
- 🚀 Email is sent via SendGrid
📊 Architectural Diagram (Textual)
🧩 Tech Stack
- Language: Python 3.12+
- Framework: FastAPI + Jinja2 templates
- Task Automation: APScheduler
- Agents & LLM: CrewAI (GPT-4 or Deepseek)
- Database: SQLite (via SQLAlchemy ORM)
- Email Services: SendGrid or any other service (configurable)
📁 Folder Structure
⚙️ Getting Started
📦 Prerequisites
🛠️ Setup & Installation
🚀 Run Locally
🌐 Test Email Subscription
📬 API Endpoints
| Method | Route | Description |
|---|---|---|
| POST | Subscribe a new email | |
| GET | Check API health status | |
| GET | Show unsubscribe form | |
| POST | Unsubscribe from list |
🗓️ Automation with APScheduler
- The is triggered every Sunday at 10 AM:
- You can change the schedule in
🧹 How It Works for Subscribers
- ✉️ When a new user subscribes, they instantly receive the latest edition of the newsletter.
- 📫 We recommend checking your spam or junk folder if you don't see the email.
- 🗓️ After that, new editions are delivered to all subscribers automatically every week.
🎁 Sponsors
AI Bulletin is currently looking for sponsors!
If you're a company or individual who believes in the power of open-source, agentic AI systems, and automated media — let's collaborate.
Want to sponsor AI Bulletin?
➡️ ahmadbilal.3491@gmail.com
➡️ ahmadbilal.3491@gmail.com
☕ Support Ahmad
If you enjoy AI Bulletin, consider buying me a coffee:
📄 License
This project is licensed under the MIT License
🤝 Contributing
Feel free to fork and submit PRs for enhancements, fixes, or new agent ideas.
🙌 Acknowledgements
- Shoutout to Ed Donner for an amazing Agentic ai course.
- CrewAI by Vercel & LangChain community
- APScheduler for painless job scheduling
- SendGrid for simple transactional email delivery