An intelligent, agent-powered blog generator built with Python, LangChain, and OpenAI GPT-4o. Fully automated — from idea to published blog with zero manual effort.
- 🔍 Input any blog topic
- 🧠 Outliner Agent to structure posts before writing
- ✍️ Writer Agent + Proofreader Agent for high-quality content
- 📣 Auto-generated captions for Twitter, LinkedIn, Instagram
- 🔗 Citation Inserter Agent for credibility and references
- 🎯 SEO Agent for tags, meta descriptions, and summaries
- 🖼️ Share Banner Generator for social media branding
- 💾 Saves content as
.md,.txt,.json, and.html - 📤 Auto-push to GitHub Pages for hosting + RSS feed
- 📰 Auto-publish to Dev.to via RSS
- 🎛️ Streamlit UI with queue system, trending topics, outline editing
- ⏰ Optional Google Calendar sync for scheduled posts
- 📊 Built-in Analytics Dashboard (reading time, tags, calendar heatmap)
| Agent | Role |
|---|---|
Outliner Agent |
Creates blog structure before writing |
Writer Agent |
Generates content based on topic, tone, audience, outline |
Proofreader Agent |
Cleans and refines blog content |
Citation Agent |
Inserts credible references and links |
SEO Agent |
Suggests meta description and SEO tags |
Social Agent |
Generates captions and post templates for each platform |
Editor Agent |
Summarizes content in bullet points |
- ✅ Topic input, tone & audience selector
- 📋 Optional outline preview and editing
- ➕ Queue multiple topics for batch processing
- 🚀 One-click generation with live feedback
- 📦 Downloadable files and preview windows
- 📆 Analytics Dashboard with:
- Calendar heatmap
- Weekly/monthly trends
- Top tags
- Filterable blog archive
- CSV export
- 📁
blogs/→ Markdown blog posts - 📁
captions/→ Captions for each blog - 📁
metadata/→ Blog metadata (JSON: SEO, summary, links, etc.) - 📁
docs/→ GitHub Pages folder (.html files + rss.xml) - 📁
banners/→ Social share images - 📄
rss.xml→ Auto-updated RSS feed for Dev.to and Medium
- 🧵 Thread Composer Agent (Twitter carousel style)
- 📱 Mobile version using Streamlit Cloud / Flutter
- 🧠 Personalization agent for tone & voice calibration
- 🤖 Slack + Zapier integration for daily blog triggers
- 📨 Newsletter bot for Substack / Revue
- Python 3.11
- LangChain
- OpenAI GPT-4o
- Streamlit
- Matplotlib + Calplot
- GitHub Pages + RSS
- Copy
.env.exampleto.envand fill in your API keys. - Install the dependencies with
pip install -r requirements.txt. - To sync blog posts with Google Calendar, set
ENABLE_GOOGLE_CALENDAR=truein.envand provide your Google credentials (credentials.json).
- CLI:
python main.py - Streamlit UI:
streamlit run app.py - FastAPI API:
uvicorn api:app --reload - React UI:
cd ai-content-creator-ui npm install npm run dev
| Method | Endpoint | Description |
|---|---|---|
POST |
/generate |
Generate blog content from a topic |
GET |
/suggest-topics?category=tech |
Get trending topic ideas |
GET |
/check-topic |
Check if a blog slug exists and get a rewrite |
POST |
/save |
Save blog, captions, and citations |
GET |
/calendar |
Return calendar data of published blogs |
GET |
/analytics |
Aggregate metadata for dashboard |
Want to build your own AI-powered publishing assistant? Fork this repo and start generating!