This service generates a dynamic visitor count badge for your GitHub repository. It tracks unique visitors and displays a weekly visualization of visitor traffic. This project was inspired by the blt project https://blt.owasp.org
- Tracks unique visitors using IP addresses
- Shows last 7 days of visitor statistics
- Displays total visitor count
- Updates in real-time
- Clean, minimal design
Add this badge to your repository by inserting the following line in your README.md:
Note: Replace:
your-render-app-name with your actual Render service name your-repo-name with your repository name
- Clone this repository to your GitHub account by clicking the Fork button.
-
Sign up for a free account at render.com
-
Create a new Web Service
-
Connect your GitHub repository
-
Configure the following settings: * Build Command: pip install -r requirements.txt * Start Command: gunicorn app:app * Environment Variable:
- Key: PYTHON_VERSION
- Value: 3.12.0
- Note your Render service URL
- Update the badge URL in your README.md
- Wait a few minutes for the service to fully deploy
Verify the badge appears correctly in your repository's README. Local Development To run the service locally:
git clone https://github.com/yourusername/visitor-badge-service
cd visitor-badge-service
# Create virtual environment
python -m venv venv
# Activate virtual environment
# On Unix/macOS:
source venv/bin/activate
# On Windows:
venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Run the application
python app.py
-
Badge updates occur on each README view
-
Visitor counting mechanism:
- Based on unique IP addresses
- Data stored in SQLite database
-
Visualization features:
- Displays last 7 days of traffic
- Week boundaries marked with vertical lines
- Proper handling of month transitions
This project is licensed under the MIT License - see the LICENSE file for details.