Skip to content

README.md

Latest commit

 

History

History
246 lines (178 loc) · 9.16 KB

README.md

File metadata and controls

246 lines (178 loc) · 9.16 KB

🧠 LeetLog AI

Solve a LeetCode problem → Auto-publish a blog post to Dev.to, Hashnode, Medium, or your own site — in seconds.

License: MIT PRs Welcome GSSoC Python FastAPI

📖 What is LeetLog AI?

LeetLog AI is a Chrome Extension with a Python FastAPI backend that automatically generates and publishes technical blog posts whenever you solve a LeetCode problem.

It extracts the problem statement, solution code, and author details directly from the LeetCode page, then uses AI providers like Gemini, OpenAI, or Perplexity to generate a beginner-friendly and structured blog post.

The generated content can be published to platforms like Dev.to, Hashnode, Medium, or even a custom blog webhook — helping developers share their coding journey quickly and consistently.

No manual copy-pasting or formatting required — just solve the problem and let the AI handle the rest.

✨ Features

Feature Description
🤖 AI Blog Generation Gemini, OpenAI, or Perplexity generate a structured post: explanation, intuition, approach, code, complexity analysis
📤 Multi-platform publishing Posts can be published to Dev.to, Hashnode, Medium, or a custom blog webhook
🧭 Platform selection Choose publishing targets from the extension popup before generating a post
📊 Per-platform status The backend reports success or failure for each selected platform independently
⚡ One-click from Extension Click "Generate Blog" in the popup — that's it
🔍 Smart Code Extraction Scrapes your solution code and problem details directly from the LeetCode page
🧑‍💻 Author Attribution Automatically picks up your LeetCode username for the post footer

🏗️ Architecture

┌─────────────────────────┐        ┌─────────────────────────────┐
│   Chrome Extension      │        │   FastAPI Backend (Python)  │
│                         │        │                             │
│  content.js             │─POST─▶|  /generate-blog             │
│  (scrapes LeetCode page)│        │       │                     │
│                         │        │       ▼                     │
│  background.js          │        │   ai/ (Provider System)     │
│  (sends to backend)     │        │       │                     │
│                         │        │       ▼                     │
│  popup.html / popup.js  │◀─JSON─│   devto.py (publishers)     │
│  (shows status)         │        │                             │
└─────────────────────────┘        └─────────────────────────────┘

🚀 Getting Started

Prerequisites

1. Clone the Repository

git clone https://github.com/vanshaggarwal27/LeetcodeAI
cd LeetcodeAI

2. Set Up the Backend

cd backend
python -m venv venv

# Windows
venv\Scripts\activate

# macOS / Linux
source venv/bin/activate

pip install -r requirements.txt

Create your .env file

# backend/.env
# backend/.env

# value can be gemini || openai || perplexity
AI_PROVIDER=gemini

GEMINI_API_KEY=your_google_gemini_api_key_here
OPENAI_API_KEY=your_openai_api_key_here
PERPLEXITY_API_KEY=your_perplexity_api_key_here

DEVTO_API_KEY=your_devto_api_key_here

TWILIO_ACCOUNT_SID=your_twilio_sid
TWILIO_AUTH_TOKEN=your_twilio_auth_token
TWILIO_PHONE_NUMBER=your_twilio_phone_number

ELEVENLABS_API_KEY=your_elevenlabs_api_key

⚠️ Never commit your .env file. It is already listed in .gitignore.

Run the server

python main.py

The server will start at http://localhost:10000.

3. Load the Chrome Extension

  1. Open Chrome and navigate to chrome://extensions/
  2. Enable Developer mode (top-right toggle)
  3. Click "Load unpacked"
  4. Select the extension/ folder from this repository

The LeetLog AI extension icon will appear in your toolbar.

4. Use It!

  1. Go to any LeetCode problem page (e.g., https://leetcode.com/problems/two-sum/)
  2. Write or paste your solution
  3. Click the LeetLog AI extension icon
  4. Click "Generate Blog"
  5. Select one or more platforms in the popup
  6. Wait a few seconds — the popup will show which platforms published successfully ✅

📁 Project Structure

LeetcodeAI/
│
├── backend/                  # Python FastAPI server
│   ├── main.py               # FastAPI entry point and API routes
│   ├── requirements.txt      # Python dependencies
│   ├── .env                  # ⚠️ Your secrets (NOT committed)
│   │
│   ├── ai
│   │   ├── blog_generator.py
│   │   ├── __init__.py
│   │   ├── prompts.py
│   │   ├── provider_manager.py
│   │   └── providers
│   │       ├── base.py
│   │       ├── gemini_provider.py
│   │       ├── openai_provider.py
│   │       └── perplexity_provider.py
│
├── extension/                # Chrome Extension (MV3)
│   ├── manifest.json         # Extension config
│   ├── content.js            # Scrapes LeetCode page data
│   ├── background.js         # Chrome extension service worker for backend communication
│   ├── popup.html            # Extension popup UI
│   └── popup.js              # Popup event logic
│
├── .gitignore
├── CONTRIBUTING.md
└── README.md

🔮 Future Scope (Ideas for Open Source Contributors)

Here is a checklist of features that would be incredibly useful for the community. We welcome contributions for these!

  • WhatsApp Reminder Service: Send automated daily reminders to solve LeetCode problems using the Twilio API.
  • Automated Call Alerts: Trigger automated phone calls using ElevenLabs and Twilio if a user hasn't solved their daily problem by a specific time.
  • Multi-platform Publishing: Support publishing generated blogs to Dev.to, Medium, Hashnode, and custom personal blog webhooks.
  • Customizable Prompts: Allow users to configure prompts for Gemini, OpenAI, or Perplexity so they can customize the tone and style of generated blog posts.
  • Support for Other Coding Platforms: Extend support to platforms like HackerRank, Codeforces, or GeeksforGeeks.
  • Dashboard/Stats Page: Create a simple dashboard to track the number of problems solved, posts published, and consistency streaks.
  • Social Sharing: Automatically share the published Dev.to post to Twitter/X or LinkedIn.

🌐 Deploying the Backend

The backend can be deployed for free on Render.

  1. Push your code to GitHub
  2. Create a new Web Service on Render
  3. Set Build Command: pip install -r requirements.txt
  4. Set Start Command: uvicorn main:app --host 0.0.0.0 --port 10000
  5. Add your environment variables (AI_PROVIDER, AI API keys, and publishing platform API keys) in the Render dashboard
  6. Copy your public Render URL and update API_URL in extension/background.js

🤝 Contributing

We ❤️ contributions! LeetLog AI is part of GSSoC 2026 and welcomes contributors of all experience levels, including beginners who are getting started with open source.

Please read our CONTRIBUTING.md for:

  • How to set up your development environment
  • Guidelines for submitting issues and pull requests
  • Code style standards

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

🙏 Acknowledgements