GitHub Jupyter Notebook Repository Fetcher

A Python script that fetches and displays the top Jupyter Notebook repositories from GitHub using the GitHub API.

Prerequisites

• Python 3.10 or higher
• uv package manager

Installation

1. Clone or download this repository

   git clone <repository-url>
   cd githublanguages

2. Install dependencies using uv

   uv sync

   This will:

   • Create a virtual environment
   • Install all required dependencies from pyproject.toml
   • Generate a uv.lock file for reproducible builds

Configuration

GitHub Token (Optional but Recommended)

For better rate limits and to avoid hitting GitHub's API limits, create a GitHub Personal Access Token:

1. Go to GitHub Settings > Personal Access Tokens
2. Click "Generate new token (classic)"
3. Select scopes: public_repo (for public repositories)
4. Copy the generated token

Create a .env file in the project root:

cp .env_template .env

Edit .env and add your token:

GITHUB_TOKEN=your_github_token_here

Note: Without a token, the script will work but with lower rate limits (60 requests/hour vs 5000 requests/hour).

Usage

Run with uv

uv run script.py

This command will:

• Activate the virtual environment
• Run the script with all dependencies available
• Display the top 20 Jupyter Notebook repositories

Alternative: Activate virtual environment manually

# Activate the virtual environment
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate     # On Windows

# Run the script
python script.py