Skip to content

Contributing

Jorge Campo edited this page May 14, 2023 · 17 revisions

Pull requests

To contribute, clone the repository, make your changes, commit and push to your clone, and submit a pull request.

Note If you're not a contributor to this repository, you need to fork and clone the repository before pushing your changes. For more information, check out Contributing to Projects in the GitHub documentation.

  • If you are adding a lot of code, consider making it an extension instead.
  • Do not add multiple unrelated things in same PR.
  • PRs should target the dev branch.
  • Make sure that your changes do not break anything by running tests.
  • Do not submit PRs where you just take existing lines and reformat them without changing what they do.
  • If you are submitting a bug fix, there must be a way for me to reproduce the bug.
There is a discord channel for development of the webui (click to expand). Join if you want to talk about a PR in real time. Don't join if you're not involved in development.
This is a discord for development only, NOT for tech support.

Dev discord

If you are making changes to used libraries or the installation script, you must verify them to work on default Windows installation from scratch. If you cannot test if it works (due to your OS or anything else), do not make those changes (with possible exception of changes that explicitly are guarded from being executed on Windows by ifs or something else).

Code style

I mostly follow code style suggested by PyCharm, with the exception of disabled line length limit.

Quirks

  • webui.user.bat is never to be edited
  • requirements_versions.txt is for python 3.10.6
  • requirements.txt is for people running on colabs and whatnot using python 3.7

Gradio

Gradio at some point wanted to add this section to shill their project in the contributing section, which I didn't have at the time, so here it is now.

For Gradio check out the docs to contribute: Have an issue or feature request with Gradio? open a issue/feature request on github for support: https://github.com/gradio-app/gradio/issues

Clone this wiki locally