자체 호스팅 GitHub Wrapped – GitHub 페이지에 배포되는 주간 AI 보고서

AI-powered weekly and monthly GitHub activity reports — deployed automatically to GitHub Pages, with zero backend infrastructure. Like Spotify Wrapped, but for your code. Runs on your own GitHub account every week or month, generates a unique AI-written personality profile from your actual activity, and publishes a beautiful static report to GitHub Pages. Every run produces: - A full static HTML report page (no JavaScript, SEO optimized) - An animated SVG card to embed in your GitHub profile README Two themes: noir — dark, cinematic, monospace. Movie poster feel.clean — light, minimal, editorial. Portfolio-ready. Two frequencies: weekly — every Monday, compares to previous weekmonthly — first of each month, richer stats AI writes three things every run: - Archetype — a unique sentence describing your coding personality this period, generated fresh from actual behavior signals. Never a fixed label. - Evolution story — one paragraph comparing this period to your history. Unlocks after 2+ periods. - Headline — one punchy line for the animated SVG card. npx github-dev-wrapped setup The wizard takes about 60 seconds and handles everything: - Creates your report repo - Stores your API keys as encrypted GitHub secrets - Enables GitHub Pages - Commits the workflow file - Triggers your first report You need: - A GitHub Personal Access Token with repo andworkflow scopes - An API key from any supported LLM provider (free tiers work) After your first run, add this to your GitHub profile README.md : All free tiers on OpenRouter, Groq, and Gemini make the full feature set available at $0/month. | Provider | Free tier | Default model | |---|---|---| | OpenRouter | Yes (many free models) | meta-llama/llama-3.3-70b-instruct:free | | Groq | Yes | llama-3.3-70b-versatile | | Gemini | Yes | gemini-2.0-flash | | OpenAI | No | gpt-4o-mini | | Anthropic | No | claude-haiku-4-5-20251001 | | Grok (xAI) | No | grok-3-mini | Activity stats (from GitHub API): - Commits — time of day, day of week, repo - PRs opened / merged / reviewed - Issues opened / closed - Languages written (by primary repo language) Derived signals: - Peak coding hour - Coding streak (consecutive active days) - Focus score — how concentrated your effort was (one repo vs many) - Review generosity — helping others vs building your own stuff - Language drift — stack shifting over time Evolution delta: Every run computes a delta against the previous period. Stored as JSON in your report repo so it compounds over time. Evolution data appears in reports after 2+ periods. The full narrative arc unlocks after 3+ months. GitHub Actions (weekly/monthly cron) │ ├─ fetch Collect activity from GitHub API → write JSON to repo ├─ generate Send signals to LLM → get archetype + headline + evolution ├─ render Build HTML report + animated SVG card from Handlebars templates └─ deploy Force-push static output to gh-pages branch All data lives in your report repo as JSON. No external database. No hosted backend. The orphan data branch stores period history; gh-pages serves the rendered output. The generated workflow file (.github/workflows/wrapped.yml ) supports these inputs: | Input | Default | Description | |---|---|---| frequency | weekly | weekly or monthly | theme | noir | noir or clean | language | en | Report language (en, ja, zh-CN, zh-TW, ko, es, fr, de, pt, ru) | timezone | UTC | IANA timezone (e.g. Asia/Colombo ) | llm-provider | — | Provider name (see table above) | llm-model | — | Model name | $0/month on a public repo. - GitHub Actions: free for public repos - LLM: one API call per period — OpenRouter/Groq/Gemini free tiers cover it - GitHub Pages: free for public repos The npm package exposes internal commands used by the GitHub Action: npx github-dev-wrapped setup # Interactive setup wizard npx github-dev-wrapped fetch # Collect GitHub activity npx github-dev-wrapped generate # Generate AI narrative npx github-dev-wrapped render # Build HTML report + SVG card npx github-dev-wrapped deploy # Push to GitHub Pages MIT