🚀 "This app didn't just change how I check GitHub streaks — it changed my entire life. I cry every time I open it."

— Probably every developer who's ever used it

 ██████╗ ██╗████████╗██╗  ██╗██╗   ██╗██████╗     ███████╗████████╗██████╗ ███████╗ █████╗ ██╗  ██╗
██╔════╝ ██║╚══██╔══╝██║  ██║██║   ██║██╔══██╗    ██╔════╝╚══██╔══╝██╔══██╗██╔════╝██╔══██╗██║ ██╔╝
██║  ███╗██║   ██║   ███████║██║   ██║██████╔╝    ███████╗   ██║   ██████╔╝█████╗  ███████║█████╔╝ 
██║   ██║██║   ██║   ██╔══██║██║   ██║██╔══██╗    ╚════██║   ██║   ██╔══██╗██╔══╝  ██╔══██║██╔═██╗ 
╚██████╔╝██║   ██║   ██║  ██║╚██████╔╝██████╔╝    ███████║   ██║   ██║  ██║███████╗██║  ██║██║  ██╗
 ╚═════╝ ╚═╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝ ╚═════╝     ╚══════╝   ╚═╝   ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝

---

🌟 What Is This Sorcery?

This is not just an app. This is a movement. A beautifully crafted, ridiculously powerful, absolutely unhinged GitHub Streak Checker built with Python and Streamlit. It was forged in the fires of late-night coding sessions, fueled by caffeine, and seasoned with pure developer passion.

You type a GitHub username. You get everything. Streak cards, stats, trophies, activity graphs — and shareable links in Markdown, HTML, and direct URL format. All in one place. All for free. All looking gorgeous.

Scientists are baffled. Investors are calling. Your GitHub streak has never looked this good.

---

✨ Features That Will Make You Weep With Joy

Feature	Status	How Mind-Blowing
🔥 GitHub Streak Card	✅	Extremely
📊 Full Stats Card	✅	Very extremely
💻 Top Languages Card	✅	Unreasonably
🏆 Trophy Showcase	✅	Dangerously
📈 Activity Graph	✅	Medically inadvisable
🎨 12 Beautiful Themes	✅	Yes
🔗 Shareable Direct URL	✅	One click. Done.
📝 Markdown Embed	✅	README-ready instantly
🌐 HTML Embed	✅	Website-ready instantly
🤖 Auto Best-Source Detection	✅	It literally checks which API is alive
🔄 Automatic Fallback URLs	✅	Never broken. Ever.
🌙 Dark Mode UI	✅	Easy on the eyes, hard on the heart

---

🎨 Themes Available

Choose from 12 stunning themes that will make your streak card the envy of every developer on the internet:

dark • default • radical • merko • gruvbox • tokyonight
onedark • cobalt • synthwave • dracula • highcontrast • transparent

---

🌐 Live Demo

No installation needed — try it right now in your browser!

👉 gitstreak.streamlit.app

Click. Type a username. Get your streak. That's it. That's the whole thing.

---

🚀 Getting Started (Takes 30 Seconds. Seriously.)

Prerequisites

• Python 3.9+
• A GitHub account (and hopefully a streak worth showing off)
• The desire to be absolutely unstoppable

Installation

# Step 1: Clone this legendary repository
git clone https://github.com/your-username/github-streak-checker.git

# Step 2: Navigate into greatness
cd github-streak-checker

# Step 3: Install the two (2) dependencies
pip install -r requirements.txt

# Step 4: Launch the rocket ship
streamlit run github_streak_app.py

That's it. You're done. Open http://localhost:8501 and prepare to be amazed.

---

📦 Requirements

streamlit>=1.32.0
requests>=2.31.0

Two dependencies. TWO. This app runs the entire GitHub stat universe on two packages. Peak engineering.

---

🧠 How It Works (The Smart Part)

You type username
       ↓
App sends HEAD requests to all API sources simultaneously
       ↓
Picks the FIRST one that responds with HTTP 200
       ↓
Renders your beautiful card
       ↓
Gives you URL + Markdown + HTML embed — all pre-formatted
       ↓
You paste it into your README and become a legend

No broken images. No "API is down" nightmares. The app automatically detects which source is alive and uses it. If one dies, it silently switches to the fallback. You will never know it happened. That's the point.

---

🌐 API Sources Used

Card Type	Primary Source	Fallback
🔥 Streak	streak-stats.demolab.com	github-readme-streak-stats-eight.vercel.app
📊 Stats	github-readme-stats.vercel.app	—
💻 Languages	github-readme-stats.vercel.app	—
🏆 Trophies	github-profile-trophy.vercel.app	—
📈 Activity	github-readme-activity-graph.vercel.app	—

---

📸 Embed Formats You Get

After entering a username, the app instantly generates 3 ready-to-use embed formats:

Direct URL — paste anywhere:

https://streak-stats.demolab.com?user=YOUR_USERNAME&theme=dark

Markdown — drop straight into your README:

[![GitHub Streak](https://streak-stats.demolab.com?user=YOUR_USERNAME&theme=dark)](https://github.com/YOUR_USERNAME)

HTML — for your portfolio or blog:

<a href="https://github.com/YOUR_USERNAME" target="_blank">
  <img src="https://streak-stats.demolab.com?user=YOUR_USERNAME&theme=dark" alt="GitHub Streak" />
</a>

---

🏆 Add To Your README Right Now

Copy this into your GitHub profile README and make it legendary:

<div align="center">

[![GitHub Streak](https://streak-stats.demolab.com?user=YOUR_USERNAME&theme=tokyonight)](https://github.com/YOUR_USERNAME)

[![GitHub Stats](https://github-readme-stats.vercel.app/api?username=YOUR_USERNAME&theme=tokyonight&show_icons=true)](https://github.com/YOUR_USERNAME)

[![Top Languages](https://github-readme-stats.vercel.app/api/top-langs/?username=YOUR_USERNAME&theme=tokyonight&layout=compact)](https://github.com/YOUR_USERNAME)

[![Trophies](https://github-profile-trophy.vercel.app/?username=YOUR_USERNAME&theme=onedark)](https://github.com/YOUR_USERNAME)

</div>

---

🤝 Contributing

Found a bug? Want to add a feature? Feel like this app changed your life and you want to give back?

1. Fork the repo
2. Create your feature branch (git checkout -b feature/make-it-even-more-unhinged)
3. Commit your changes (git commit -m 'Add even more greatness')
4. Push to the branch (git push origin feature/make-it-even-more-unhinged)
5. Open a Pull Request

All contributions welcome. Even the chaotic ones.

---

📄 License

MIT License — use it, share it, remix it, put it on a t-shirt. Just don't forget where it came from.

---

💚 Built With Love By

"I built this because I was tired of checking 5 different websites just to see my GitHub streak. Now you don't have to. You're welcome."

— Esha Tariq