ByteBrief is an AI-powered system that automatically discovers, summarizes, and archives trending tech topics into engaging Twitter threads. Stay ahead of the curve without lifting a finger!
- 🤖 AI Crew: A team of specialized AI agents working together
- 🔍 Trend Discovery: Automatically finds trending tech topics
- 📝 Smart Summarization: Converts complex news into digestible bullet points
- 🐦 Twitter-Ready Threads: Crafts engaging 2-tweet threads for social media
- 📚 Google Docs Archiving: Automatically saves all threads for future reference
- ⚡ Real-time Updates: Always stay current with the latest tech developments
Agent | Role | Specialization |
---|---|---|
Tech Trend Scraper | Researcher | Finds 3-5 trending tech topics daily |
Trend Summarizer | Editor | Converts findings into concise bullet points |
Tech Thread Writer | Copywriter | Crafts engaging Twitter threads |
Thread Publisher | Archivist | Saves threads to Google Docs |
- Python 3.13 or higher
- Google Cloud account with Docs API enabled
- API keys for Gemini and Serper
-
Clone the repository:
git clone https://github.com/yourusername/bytebrief.git cd bytebrief
-
Install dependencies:
pip install -r requirements.txt
-
Set up environment variables: Create a
.env
file with your API keys:GEMINI_API_KEY=your_gemini_api_key SERPER_API_KEY=your_serper_api_key GOOGLE_DOC_ID=your_google_doc_id # Optional
Run ByteBrief to generate and archive your first tech thread:
python bytebrief_crew.py
Watch as the AI crew:
- Discovers trending tech topics
- Summarizes them into concise points
- Crafts engaging Twitter threads
- Archives them in your Google Doc
Variable | Description | Required |
---|---|---|
GEMINI_API_KEY |
Gemini API key for LLM | ✅ |
SERPER_API_KEY |
Serper.dev API key for search | ✅ |
GOOGLE_DOC_ID |
Fixed Google Doc ID (optional) | ❌ |
bytebrief/
├── bytebrief_crew.py # Main AI crew orchestration
├── google_docs_tool.py # Google Docs integration tool
├── setup_google_docs.py # Google Docs setup wizard
├── main.py # Entry point
├── requirements.txt # Python dependencies
├── .env # API keys (not included)
└── credentials.json # Google OAuth credentials (not included)
- Discovery Phase: The Trend Scraper agent searches the web for trending tech topics
- Summarization Phase: The Trend Summarizer refines findings into tweet-friendly content
- Creation Phase: The Thread Writer crafts engaging 2-tweet threads
- Archiving Phase: The Thread Publisher saves threads to Google Docs with timestamps
Contributions are welcome! Feel free to:
- Report bugs
- Suggest new features
- Improve documentation
- Add new AI agents
This project is licensed under the MIT License - see the LICENSE file for details.
- CrewAI for the amazing multi-agent framework
- Google Docs API for seamless document integration
- Serper.dev for reliable search capabilities
Made with ❤️ and ☕ by tech enthusiasts