Skip to main content

usePR

AI-powered PR summary generator for Git repositories

Explore the Documentation »
Report Bug · Request Feature

Table of Contents
  1. About
  2. Quick Start
  3. Usage
  4. Development
  5. Contributing
  6. License

About

usepr (usepr) is a Python CLI that generates pull request summaries from your git commits using AI (DSPy). It analyzes your commit history and produces well-structured, meaningful PR descriptions.

  • AI-powered summaries - Uses DSPy ChainOfThought to understand and summarize your changes
  • Template support - Automatically detects and uses PR templates from your repository
  • Flexible diffing - Generate summaries between any branches, tags, or commits
  • Interactive prompts - Guided workflow with base branch and issue selection
  • Clipboard integration - Copy generated summaries directly to clipboard
  • Model override - Use different LLM models via the -m flag

(back to top)

Quick Start

uv tool install usepr

Install with pipx (alternative)

pipx install usepr

Generate a PR summary

usepr generate

This will prompt you to select a base branch, optionally link related issues, and generate a summary from your commits.

(back to top)

Usage

Generate a PR Summary

usepr generate

The interactive workflow will:

  1. Detect your repository's default branch
  2. Prompt for a base branch to diff against
  3. Gather commits between base and HEAD
  4. Ask for related issues (optional)
  5. Detect and offer PR templates (if any)
  6. Generate and display the summary
  7. Offer to copy to clipboard

Use a Custom Model

Set your API key as an environment variable for the provider you're using:

export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."

Then run with the provider/model format:

usepr generate -m openai/gpt-4o
usepr generate -m anthropic/claude-sonnet-4-20250514
usepr generate -m openrouter/google/gemini-2.5-flash

Use the Short Alias

usepr gen

Available Commands

generate (gen)  Generate a PR summary from commits
help            Show help

(back to top)

Development

Common tasks:

uv run poe clean-full
uv run poe test
uv run poe lint
uv run poe format

(back to top)

Contributing

Quick workflow:

  1. Fork and branch: git checkout -b feature/name
  2. Make changes
  3. Run checks: uv run poe clean-full
  4. Commit and push
  5. Open a Pull Request

(back to top)

License

License information has not been added yet.

(back to top)


Built by thememium

Metadata

Release files for usepr 0.1.10

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for usepr 0.1.10
File Size Uploaded Provenance Actions
usepr-0.1.10.tar.gz 13.3 kB Without provenance Details for usepr-0.1.10.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for usepr 0.1.10
File Interpreter ABI Platform Actions
usepr-0.1.10-py3-none-any.whl Python 3 none any Details for usepr-0.1.10-py3-none-any.whl

Total release size: 30.4 kB

Release files / usepr-0.1.10.tar.gz

Download URL usepr-0.1.10.tar.gz
Size 13.3 kB
Tags Source
SHA-256 checksum
How to use checksums
372a3c7fe5788503128d3b399e2cf7034f2961bb20e977255a7bcec7c2e9f636
BLAKE2b-256 checksum
How to use checksums
08fdf78ad105f2f71add6363436da74d85ce2e2f53957e8ecbbc0ae3db5adf3a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / usepr-0.1.10-py3-none-any.whl

Download URL usepr-0.1.10-py3-none-any.whl
Size 17.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
71ccb50c8c47377a49524ba6db273ed9d8652be5b4c396fa7674e1d0dc989d2f
BLAKE2b-256 checksum
How to use checksums
46eefed446e0faa474b83e6fe67c4084e4f09559cf2f90430894b00421b908c1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for usepr 0.1.10

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page