GitHub Follower Checker — v2.0.0

What's Changed

• Update README.md by @jaseva in #8
• Implement comprehensive follower stats tracking and dashboard features by @jaseva in #10
• Add AI insights, dashboard queries, and profile summarization features by @jaseva in #11

Full Changelog: v1.1.0...v2.0.0

Overview

This release marks a major step forward from v1, introducing an AI-powered web dashboard, backend API, and profile intelligence layer alongside infrastructure fixes that bring the full stack into a reliable, deployable state.

---

✨ New Features

AI Intelligence & Insights

• New backend endpoints: /stats/insights, /stats/query, and /stats/profile-summary — support natural-language questions, grounded narratives, and evidence-backed answers about your follower data
• profile_summarizer module generates OpenAI-powered (or local fallback) profile summaries with explainability guardrails, mirroring the desktop app's prompt behavior
• New Pydantic models for insight requests/responses including evidence, confidence scoring, and recommended action fields

Web Dashboard (Next.js + FastAPI)

• New interactive web dashboard at http://localhost:3000 — live follower stats, growth trend chart, new/lost follower lists
• FastAPI backend (http://localhost:8000) with full REST API: /ping, /stats/followers, /stats/trends, /stats/history/{new|lost}
• Extended DashboardHealth model with recent sync run summaries for API health transparency and data freshness indicators
• AI query bar, evidence-backed answers panel, and enhanced signal quality panel in the dashboard

---

🐛 Bug Fixes & Infrastructure

• Fixed ModuleNotFoundError — Restored missing root-level analytics.py module (create_table, insert_follower, plot_follower_growth, segment_followers, plot_unfollower_trend)
• Fixed UnboundLocalError — Removed duplicate dead code block in main.py's track_followers() that referenced unfollowers after the finally block
• Fixed backend credential loading — tracker.py now explicitly loads backend/.env via python-dotenv so GitHub credentials are always picked up on startup
• Fixed tsconfig.json — Removed incompatible baseUrl option that conflicted with "moduleResolution": "bundler" in TypeScript 5+
• Desktop app UX — Entry fields (username, token, filename) now auto-populate from .env on startup — no more manual re-entry every run

---

⚙️ Configuration

Variable	File	Purpose
GITHUB_USERNAME	backend/.env	GitHub username to track
GITHUB_TOKEN	backend/.env	GitHub PAT (needs read:user)
OPENAI_API_KEY	backend/.env	Powers AI profile summaries (optional, falls back to local)

---

📋 Requirements

• Python 3.10+, openai package added to backend/requirements.txt
• Node.js 18+, Next.js 15.3.1

---

Full Changelog: v1.0.0...v2.0.0

What's Changed

• Update README.md by @jaseva in #8
• Implement comprehensive follower stats tracking and dashboard features by @jaseva in #10
• Add AI insights, dashboard queries, and profile summarization features by @jaseva in #11

Full Changelog: v1.1.0...v2.0.0

New Functionality: Analytics, Segmentation, and AI Generate Summary

Github Follower Checker v1.1.0

We're pleased to announce the release of Github Follower Checker v1.1.0! This update builds upon the functionalities of the previous version and introduces exciting new features.

What's New

Enhanced Analytics (Optional): (New Feature):
Track follower growth over time by generating visual charts.
Analyze follower demographics through segmentation based on repository contributions or activity levels. (Note: This requires additional setup, refer to the updated documentation.)

Improved User Experience

Generate summaries of user profiles using OpenAI's powerful language models. (New Feature)
Improved output formatting for better readability.

Existing Features

Track your Github followers and identify who has unfollowed or followed you back.
Fetch the list of followers for a given user using the Github API.
Compare the current list of followers to the previous check for insights.
Output follower changes to a text file.

Getting Started

For existing users, refer to the updated documentation for details on new features. New users can follow the instructions in the README file to set up the application.

Contributing

We encourage contributions! Submit pull requests for bug fixes or new features.

Thank you for using Github Follower Checker!

License

This project remains under the MIT License (refer to LICENSE.md for details).

What's Changed

• Update README.md by @jaseva in #2
• Update README.md by @jaseva in #5
• Analytics by @jaseva in #6
• Analytics by @jaseva in #7

New Contributors

• @jaseva made their first contribution in #2

Full Changelog: v1.0...v1.1.0

Initial Release

Github Follower Checker v1.0.0

We're excited to announce the release of Github Follower Checker v1.0.0! This is a Python script that allows you to check your Github followers, track who has unfollowed you, and who has followed you back.

Features

Fetches the list of followers for a given user using the Github API.
Compares the current list of followers to the list from the previous check to determine who has unfollowed and who has followed you back.
Outputs the changes in the follower count and status to a text file.

Getting Started

To get started, clone this repository to your local machine and follow the instructions in the README file to install the required dependencies and authenticate your requests to the Github API.

Contributing

Contributions are always welcome! If you find a bug or want to add a new feature, feel free to submit a pull request. To get started, fork this repository and create a new branch for your changes. Make your changes and submit a pull request with a brief description of your changes.

License

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

Thank you for using Github Follower Checker!