Top Quant Gits

Top Quant Gits is a standalone Python scout that finds fresh GitHub repositories in quant, trading, crypto, backtesting, and Indian options trading niches, then publishes a ranked Markdown digest.

What it does

• Searches GitHub for recent repositories across focused categories
• Scores repos using freshness, traction, activity, and keyword relevance
• Keeps a local history of seen repositories
• Produces a digest with the top picks per category

Default categories

• Quant Research
• Algo Trading
• Crypto Trading
• Indian Options
• Backtesting

Quick start

cd D:\Python\quant-github-scout
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -e .
Copy-Item .env.example .env
top-quant-gits --days 90 --top 5

The generated digest is written to output\latest_digest.md. The branded publication is also rendered to output\latest_digest.html and output\latest_digest.pdf.

To also send the branded PDF digest to Telegram:

top-quant-gits --days 90 --top 5 --send-telegram

GitHub Actions

This repo includes a daily GitHub Actions workflow at .github/workflows/daily-digest.yml.

• Scheduled run: every day at 01:30 UTC (07:00 IST)
• Manual run: available from the GitHub Actions tab with optional days and top inputs
• Auth: uses GH_API_TOKEN when provided, otherwise falls back to the repository's built-in GitHub token
• Output: commits output/latest_digest.md back to the repo when it changes, uploads the latest Markdown and PDF artifacts, prints the digest in the workflow summary, and sends the branded PDF to Telegram when Telegram secrets are configured
• Telegram behavior: a companion text message with direct clickable repo URLs is sent before the PDF, because some in-app PDF viewers do not honor PDF link taps consistently even when the PDF contains valid link annotations

The workflow cron is pinned directly to 01:30 UTC so it lands at 07:00 IST.

To enable Telegram delivery from GitHub Actions, add these repository secrets:

• GH_API_TOKEN (recommended GitHub personal access token for higher search limits)
• TELEGRAM_BOT_TOKEN
• TELEGRAM_CHAT_ID

Environment

GITHUB_TOKEN is optional but strongly recommended to avoid low rate limits.

GITHUB_TOKEN=ghp_your_token_here
GH_API_TOKEN=ghp_your_optional_actions_token_here
TOP_QUANT_GITS_OUTPUT_DIR=output
TOP_QUANT_GITS_STATE_FILE=output/seen_repos.json
TOP_QUANT_GITS_BRAND_NAME=Top Quant Gits
TOP_QUANT_GITS_SIGNATURE_NAME=gkmraju
TOP_QUANT_GITS_GITHUB_URL=https://github.com/gkmraju/quant-github-scout
TOP_QUANT_GITS_TELEGRAM_CAPTION=Top Quant Gits branded PDF digest
TELEGRAM_BOT_TOKEN=your_telegram_bot_token
TELEGRAM_CHAT_ID=@your_channel_or_chat_id

Example command

top-quant-gits --days 60 --top 5 --output output\weekly_digest.md

To avoid repeat recommendations from previous runs:

top-quant-gits --days 60 --top 5 --exclude-seen

To generate and deliver in one step:

top-quant-gits --days 60 --top 5 --exclude-seen --send-telegram

Ranking idea

This project does not use raw creation time alone. It combines:

• Freshness
• Repository traction
• Recent activity
• Relevance to the category keywords
• Basic quality signals

That keeps the digest closer to "top recent repos worth noticing" instead of "the last five repos someone created".