RepoFit

AI-powered GitHub Trending analyzer that learns your projects, recommends repos that fit your stack, and generates monetization ideas.

Features

Core Features

• Trending Scraper: GitHub Trending (daily/weekly/monthly) with language filters
• GitHub Enrichment: Topics, issues, license, and activity via GitHub API
• AI Scoring & Summaries: Gemini analysis with heuristic fallback when AI is disabled
• Project Profiles: Register projects with stack, tags, and goals
• Smart Matching: Two-stage matcher (pgvector similarity + stack overlap + quality)
• GitHub Search Discovery: Find repos beyond trending using project-based queries
• Snapshots & History: Save runs and track trending history over time

Project Auto-Discovery (New!)

• GitHub Sync: Sync your GitHub repos as projects automatically (gt github-sync)
• Folder Scanner: Scan local projects folder for auto-registration (gt scan-projects)
• Stack Detection: Auto-detect tech stack from package.json, pyproject.toml, README.md

Notifications & Slack Bot

• Slack Integration: Rich Korean notifications for all features
• Daily Digest: Trending + project matching summary
• Project Matches: "This trending repo fits your project X"
• RAG-powered Bot: AI answers using stored repo data (langchain + Gemini)
• Slack Commands: 스캔, 추천, 트렌딩 in channel → results as new message

Architecture

┌─────────────────────────────────────────────────────────────┐
│                        RepoFit                               │
│                          │                                   │
│    ┌─────────────────────┼─────────────────────┐            │
│    │                     ▼                     │            │
│    │   ┌──────────┐  ┌──────────┐  ┌────────┐ │            │
│    │   │Collector │→ │ Enricher │→ │Analyzer│ │  Python    │
│    │   │(scraper) │  │(GH API)  │  │(Gemini)│ │  Backend   │
│    │   └──────────┘  └──────────┘  └────────┘ │            │
│    │         │              │           │     │            │
│    │         └──────────────┴───────────┘     │            │
│    │                     │                     │            │
│    │              ┌──────────────┐             │            │
│    │              │   Embedder   │             │            │
│    │              │  (Gemini)    │             │            │
│    │              └──────────────┘             │            │
│    │                     │                     │            │
│    │              ┌──────────────┐             │            │
│    │              │   Matcher    │             │            │
│    │              │  (2-stage)   │             │            │
│    │              └──────────────┘             │            │
│    └─────────────────────┼─────────────────────┘            │
│                          │                                   │
│                          ▼                                   │
│    ┌─────────────────────────────────────────┐              │
│    │           Supabase (PostgreSQL)          │              │
│    │  ┌─────────┐ ┌─────────┐ ┌───────────┐  │              │
│    │  │gt_repos │ │gt_projs │ │ pgvector  │  │              │
│    │  └─────────┘ └─────────┘ └───────────┘  │              │
│    └─────────────────────────────────────────┘              │
│                          │                                   │
│              ┌───────────┴───────────┐                      │
│              ▼                       ▼                      │
│    ┌─────────────────┐    ┌─────────────────┐              │
│    │  Next.js Web UI │    │  Slack Notifier │              │
│    └─────────────────┘    └─────────────────┘              │
└─────────────────────────────────────────────────────────────┘

5-Minute Quickstart

cp .env.example .env
python -m venv .venv && source .venv/bin/activate
pip install -e .

gt init
gt quickstart

# Register your project
gt project-add --name "MyApp" --stack "python,fastapi" --tags "api,web"

# Or sync from GitHub
gt github-sync

# Get daily recommendations
gt sync --notify

CLI Commands

Core Commands

Command	Description
gt init	Create env files and validate Supabase schema
gt setup	Validate configuration and show setup hints
gt quickstart	Seed trending data and recommendations quickly
gt trending	View trending repos
gt trending --analyze	With AI analysis
gt inspect owner/repo	Detailed repo analysis
gt history owner/repo	Trending history for a repo
gt snapshots	List saved trending snapshots

Project Management

Command	Description
gt projects	List your projects
gt project-add	Register a project
gt github-sync	Sync your GitHub repos as projects
gt github-sync --starred	Also show starred repos
gt scan-projects ~/projects	Scan local folder for projects
gt match	Find matching repos for all projects
gt match --project <id>	Match a single project
gt recommendations	View AI recommendations
gt discover	Discover GitHub repos that fit your projects

Automation

Command	Description
gt sync	Full pipeline (fetch → analyze → save → match)
gt sync --notify	Full pipeline with daily digest to Slack
gt schedule	Run daily sync at a fixed local time (default 19:00)
gt bot	Start Slack auto-reply bot (requires Socket Mode)

Smart Matching

The recommendation engine uses a 2-stage approach across all stored repositories:

1. Stage 1 - Fast Filter:

   • Tech stack overlap (languages, frameworks)
   • Keyword matching (tags, topics)
   • Quality threshold (stars, activity)

2. Stage 2 - Semantic Rerank:

   • Vector similarity using Gemini embeddings
   • Cosine distance between project ↔ repo embeddings

Scoring Formula:

score = 0.5 × embedding_similarity
      + 0.3 × stack_overlap
      + 0.2 × quality_score

Slack Notifications

Setup

1. Create Slack App with Bot Token:

   • Go to Slack API → Create New App
   • Add Bot Token Scopes: chat:write, channels:read, channels:history
   • Install to Workspace → Copy Bot Token (xoxb-...)
   • Invite bot to your channel: /invite @YourBot

2. Enable Socket Mode (for auto-reply bot):

   • Slack App Settings → Socket Mode → Enable
   • Create App-Level Token with connections:write scope
   • Copy the token (xapp-...)
   • Event Subscriptions → Enable Events
   • Subscribe to bot events: message.channels, app_mention

3. Configure environment:

   SLACK_BOT_TOKEN=xoxb-your-bot-token
   SLACK_APP_TOKEN=xapp-your-app-token  # Socket Mode용
   SLACK_CHANNEL_ID=C0A1CVD5153
   SLACK_NOTIFY_THRESHOLD=0.7

Slack Bot (RAG-powered)

RepoFit 봇은 langchain + Gemini + pgvector를 사용하여 저장된 레포 데이터를 검색하고 더 정확한 답변을 제공합니다.

gt bot  # 봇 시작 (백그라운드로 실행 권장)

채널 명령어 (새 메시지로 결과 전송):

채널/스레드에 입력	동작
스캔 / scan	프로젝트 폴더 스캔 → 등록 → 매칭
추천 / recommend	추천 결과 → 채널에 새 메시지
트렌딩 / trending	트렌딩 TOP 10 → 채널에 새 메시지
매칭 / match	매칭 실행 → 결과 채널에

일반 질문 (RAG 응답):

[Slack 스레드]
├─ 🤖 RepoFit: 📊 오늘의 다이제스트...
├─ 👤 나: "fastapi랑 langchain 조합하면 뭐 만들 수 있어?"
└─ 🤖 RepoFit: (저장된 레포 정보 검색 후 구체적 답변)

Sample Daily Digest

📊 오늘의 RepoFit 다이제스트
🌐 Python • 📈 트렌딩 25개 분석
────────────────────────────
🎯 프로젝트별 매칭 결과
  MyApp: 5개 매칭 • 🔥 최고점 92% (owner/repo)
  Backend: 3개 매칭 • ⭐ 최고점 85% (author/lib)
────────────────────────────
🏆 오늘의 TOP 추천
  🔥 fastapi/fastapi → MyApp 92% 매칭
  ⭐ langchain/langchain → Backend 85% 매칭
────────────────────────────
🚀 다음 단계
  • gt recommendations - 전체 추천 보기

Daily Notifications

# One-off run (send Slack summary + high-score matches)
gt sync --notify

# Daily schedule at 19:00 local time (keep process running)
gt schedule --hour 19 --minute 0 --notify

Environment Variables

# Backend (.env)
SUPABASE_URL=your-supabase-url
SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_KEY=your-service-key
GEMINI_API_KEY=your-gemini-key
GEMINI_MODEL=gemini-2.5-flash
GITHUB_TOKEN=your-github-token  # For github-sync

# Slack Bot (optional but recommended)
SLACK_BOT_TOKEN=xoxb-xxx
SLACK_APP_TOKEN=xapp-xxx  # Socket Mode
SLACK_CHANNEL_ID=Cxxx
SLACK_NOTIFY_THRESHOLD=0.7

# Frontend (web/.env.local)
NEXT_PUBLIC_SUPABASE_URL=your-supabase-url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key

Daily Automation

systemd (recommended)

mkdir -p ~/.config/systemd/user
cp scripts/repofit-daily.{service,timer} ~/.config/systemd/user/
systemctl --user daemon-reload
systemctl --user enable --now repofit-daily.timer

To change the time, edit ~/.config/systemd/user/repofit-daily.timer and update OnCalendar=.

Cron Job

# Every day at 7 PM - full digest
0 19 * * * cd /path/to/repofit && .venv/bin/gt sync --notify

# Every day at 6 PM - run matching
0 18 * * * cd /path/to/repofit && .venv/bin/gt match --notify

GitHub Actions

Use .github/workflows/daily-sync.yml with secrets:

• SUPABASE_URL, SUPABASE_ANON_KEY, SUPABASE_SERVICE_KEY
• GEMINI_API_KEY
• SLACK_BOT_TOKEN, SLACK_CHANNEL_ID

Tech Stack

Component	Technology
CLI	Python, Typer, Rich
AI	Google Gemini (analysis + embeddings)
AI SDK	google-genai, langchain, langchain-google-genai
RAG	langchain + pgvector retrieval
Database	Supabase (PostgreSQL + pgvector)
Frontend	Next.js 16, React 19, Tailwind CSS 4
HTTP	httpx (async)
Notifications	Slack Block Kit, slack-bolt (Socket Mode)

Troubleshooting

• Schema missing: Run schema.sql in Supabase SQL Editor
• No recommendations: Set GEMINI_API_KEY, then run gt quickstart
• Slack not working: Check SLACK_BOT_TOKEN and SLACK_CHANNEL_ID
• No project matches: Register projects with gt project-add first
• GitHub sync fails: Check GITHUB_TOKEN permissions (repo scope)

License

MIT