Python Project for reviewing GitHub PRs with Open AI and Chat-GPT.
Project description
gpt-review
A Python based CLI and GitHub Action to use Open AI or Azure Open AI models to review contents of pull requests.
How to install CLI
First, install the package via pip:
pip install gpt-review
GPT API credentials
You will need to provide an OpenAI API key to use this CLI tool. In order of precedence, it will check the following methods:
-
Presence of a context file at
azure.yamlor whereverCONTEXT_FILEpoints to. Seeazure.yaml.templatefor an example. -
AZURE_OPENAI_API_URLandAZURE_OPENAI_API_KEYto connect to an Azure OpenAI API:export AZURE_OPENAI_API=<your azure api url> export AZURE_OPENAI_API_KEY=<your azure key>
-
OPENAI_API_KEYfor direct use of the OpenAI APIexport OPENAI_API_KEY=<your openai key>
-
AZURE_KEY_VAULT_URLto use Azure Key Vault. Put secrets for the url atazure-open-aiand the API Keyazure-openai-key, then run:export AZURE_KEY_VAULT_URL=https://<keyvault_name>.vault.azure.net/ az login
Main Commands
To show help information about available commands and their usage, run:
gpt --help
To display the current version of this CLI tool, run:
gpt --version
Here are the main commands for using this CLI tool:
1. Ask a Question
To submit a question to GPT and receive an answer, use the following format:
gpt ask "What is the capital of France?"
You can customize your request using various options like maximum tokens (--max-tokens), temperature (--temperature), top-p value (--top-p), frequency penalty (--frequency-penalty), presence penalty (--presence-penalty), etc.
Ask a Question about a File
To submit a question to GPT with a file and receive an answer, use the following format:
gpt ask --files WordDocument.docx "Summarize the contents of this document."
2. Review a PR
To review a PR, use the following format:
gpt github review \
--access-token $GITHUB_ACCESS_TOKEN \
--pull-request $PULL_REQUEST_NUMBER \
--repository $REPOSITORY_NAME
3. Generate a git commit message with GPT
To generate a git commit message with GPT after having added the files, use the following format:
git add .
gpt git commit
For more detailed information on each command and its options, run:
gpt COMMAND --help
Replace COMMAND with one of the main commands listed above (e.g., 'ask').
Developer Setup
To install the package in development mode, with additional packages for testing, run the following command:
pip install -e .[test]
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file gpt_review-0.9.5rc969.post1.tar.gz.
File metadata
- Download URL: gpt_review-0.9.5rc969.post1.tar.gz
- Upload date:
- Size: 34.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: python-requests/2.31.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | a9bdd6f14ba87d915973f887ab4fbe7bddbdc79dfb84ce9aa91a7e0a5d5ecf73 |
|
| MD5 | 26e0ce1c34df2bdb2bd2a2d1e0d763ec |
|
| BLAKE2b-256 | 2cf3e3117a03805a31653086769f49e446b40465f095644099f36be02f41a7b6 |
File details
Details for the file gpt_review-0.9.5rc969.post1-py3-none-any.whl.
File metadata
- Download URL: gpt_review-0.9.5rc969.post1-py3-none-any.whl
- Upload date:
- Size: 23.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: python-requests/2.31.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 19aabba372080138db40ff288ecec7b39b5f5748b58360c9f1633f479579e2a2 |
|
| MD5 | 40b710e1a5e3e2f3eb5789bfe5fc960f |
|
| BLAKE2b-256 | bd2f29f283634fc73d351948031b555c0bdfe2708a67f0b90dacebf6d19d3d6a |
