https://github.com/timmeinerzhagen/pr-summary
Meaningful Pull Request titles for repos with unintelligible timelines like github/docs with "Repo Sync" PRs
https://github.com/timmeinerzhagen/pr-summary
ai github llm openrouter pull-requests
Last synced: 2 months ago
JSON representation
Meaningful Pull Request titles for repos with unintelligible timelines like github/docs with "Repo Sync" PRs
- Host: GitHub
- URL: https://github.com/timmeinerzhagen/pr-summary
- Owner: timmeinerzhagen
- Created: 2025-05-02T01:38:32.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-02-20T22:11:18.000Z (4 months ago)
- Last Synced: 2026-02-21T04:10:21.280Z (4 months ago)
- Topics: ai, github, llm, openrouter, pull-requests
- Language: Python
- Homepage: https://pr.tim.ad
- Size: 1.42 MB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# pr-summary
`github/docs` Pull Requests have awful titles.
To make it easier to follow changes, this gives you AI-powered summaries of their Pull Requests
Check out [`pr.tim.ad`](https://pr.tim.ad) to see it in action!
## Overview
* `src` - Python code for fetching PRs, calling OpenRouter to analyze PRs
* `generate_summary.py` - Script to generate summaries for a specific PR
* `generate_website_data.py` - Script to generate the `pr-data.json` file
* `list_prs_without_summaries.py` - Script to list PRs that need summaries
* `app` - React web app for displaying PR summaries, hosted on GitHub Pages
* `data` - JSON files containing PR data summaries for `github/docs`
* `.github/workflows`
* `deploy-website.yml` - deploy the React app with the Pull Request data to GitHub Pages
* `generate.yml` - list PRs that need summaries and generate them, push them to `data/`
## Local Development
### PR Analysis
1. Install Python dependencies:
```bash
pip install -r requirements.txt
```
2. Set your OpenRouter API key in your environment:
```bash
export OPENROUTER_API_KEY='your_api_key'
```
3. Run the analysis script:
```bash
python3 generate_summary.py --repo github/docs --pr 12345
```
### React app
1. Analyze some PRs to create data files
2. Run `generate_website_data.py` to generate the `pr-data.json` file
3. Install Node.js dependencies:
```bash
cd app
npm install
```
4. Start the React app:
```bash
npm start
```
The website will be available at `http://localhost:3000`.