Hugging Face's logo

Spaces:
thisrudrapatel
/
WhatTheCode
Running

App Files Community
WhatTheCode / README.md
thisrudrapatel's picture
thisrudrapatel
Update README.md
0362dec verified
preview code
|
raw
history blame contribute delete
3 kB

A newer version of the Gradio SDK is available: 5.36.2

Upgrade
metadata
title: WhatTheCode
emoji: 💻
colorFrom: gray
colorTo: indigo
sdk: gradio
app_file: app.py
pinned: false
license: mit
short_description: WhatTheCode 👀 is a fun, dev-centric solution explainer

WhatTheCode 💻🤯

“Because sometimes your own code feels like decoding an encrypted puzzle.”

Status WhatTheCode Banner
License: MIT Built with Groq + LLaMA 4 Made by Rudra

🎯 Overview

WhatTheCode 👀 is a fun, dev-centric Leetcode solution explainer that turns your raw code or problem description into clean, structured, and markdown-ready explanations — perfect for:

  • Future self-reviews 🧠
  • Leetcode Discuss posts 💬
  • Understanding alien 👽 code
  • Teaching others (or learning from your past logic)

No fluff. No academic jargon. Just structured, fun, markdown-formatted explanations that feel like a dev wrote them at 2 AM with pizza in hand and Stack Overflow tabs open.

🚀 Features

  • ✍️ Instant Markdown Explanations
    Paste your Leetcode code or problem, click a button — get a full explanation with:

    • ## Intuition 💡
    • ## Approach 🪜
    • ## Complexity ⏳
    • ## Code 👨🏽‍💻
    • Optional: ## Alternate 🔁

  • 🤖 Prompt Engineered Output
    Built on top of Groq + Meta-LLaMA 4, carefully tuned with a cheeky, dev-friendly tone.

  • 🔁 Alternate Solution Generator
    Got time? Ask it to cook up a different approach with one click.

  • 📦 Copy-Paste Ready Markdown Tab
    Designed for fast Leetcode Discuss uploads.

🛠️ Tech Stack

  • Gradio — Frontend & interactivity
  • Python — Core logic
  • Groq API — LLM backend (Meta LLaMA-4)
  • .env & HuggingFace Secrets — for secure prompt/key handling

⚙️ How to Use Locally

  1. Clone the repo

    git clone https://huggingface.co/spaces/<your-username>/WhatTheCode
cd WhatTheCode

  2. Install dependencies

    pip install -r requirements.txt

  3. Add a .env file:

    GROQ_API_KEY=your_groq_key_here
MAGIC_PROMPT="Your prompt string..."

  4. Run it locally:

    python app.py

📡 Deploy on Hugging Face Spaces

  1. Push your repo to Hugging Face
  2. Go to Settings > Secrets and add:
    • GROQ_API_KEY
    • PROMPT_ADVANCE (optional)
  3. Hit “Restart Space” — and you're live!

🎨 App Metadata 

title: WhatTheCode
emoji: 👀
colorFrom: gray
colorTo: purple
sdk: gradio
app_file: app.py
license: mit
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference