Skip to content
aperture

GitHub Action

katalin - Python code advisor

v1 Latest version

katalin - Python code advisor

aperture

katalin - Python code advisor

Comments on PRs with suggested documentation, security, and logic improvements

Installation

Copy and paste the following snippet into your .yml file.

              

- name: katalin - Python code advisor

uses: kislyuk/katalin@v1

Learn more about this action in kislyuk/katalin

Choose a version

katalin GitHub action

This is a GitHub action that generates LLM-assisted suggestions for improving Python code in PRs, and posts them as PR comments.

See this sample PR for an example of katalin in action.

Inputs

openai-api-token

Required The OpenAI API token to use.

enabled-advisors

A newline-separated list of advisor modules to enable. Available advisors are:

  • docstrings: Provides doscstring suggestions for undocumented Python modules, functions, classes, and methods.
  • security: Provides comments regarding potential security concerns.
  • logic-check: Identifies possible logic errors.

Example usage

uses: kislyuk/katalin@v1
with:
  openai-api-key: ${{secrets.OPENAI_API_KEY}}
  enabled-advisors: |-
    docstrings
    security
    logic-check

See Using secrets in GitHub Actions for details on how to set the secret above.