-
-
Notifications
You must be signed in to change notification settings - Fork 5.2k
Contributing guidelines
- Please submit your changes to the
dev
branch of the repository. - Lint the changes that you have made. I use the following tools:
pyflakes file.py # To check for errors
pycodestyle file.py # To check for style problems
The following pycodestyle errors can be ignored:
- E402 module level import not at top of file
- E501 line too long
- E722 do not use bare 'except'
The remaining errors should be fixed.
-
Thoroughly self-test your code. Can you think of a scenario where it might not work as expected? Does it interfere with other parts of the program?
-
Keep it simple, structured, and organized. Do not add more lines than you have to.
The main focus of this project is the Gradio UI, so you should familiarize yourself with Gradio: https://www.gradio.app/docs/interface
Project structure
-
shared.settings
contains default values for Gradio components. It can be customized through asettings.yaml
file. -
shared.args
contains the command-line arguments. They represent variables that need to be changed often. -
shared.gradio
contains the UI elements, like sliders and dropdowns. When defining Gradio event handlers, thegradio
function inmodules.utils
can be used to write
gradio('history', 'character_menu', 'mode')
instead of
[shared.gradio[k] for k in ['history', 'character_menu', 'mode']]
- The UI values are not passed directly to the generation functions. Instead, they are first fed into the
shared.gradio['interface_state']
state variable. This variable receives the namestate
when used as input to backend functions. The code for updatingshared.gradio['interface_state']
with the current UI values is the following (seeserver.py
for several examples):
ui.gather_interface_values, gradio(shared.input_elements), gradio('interface_state')
- The chat history is represented as a dictionary with the following structure:
{
'internal': [['hi', 'hey'], ['how are you?', "i'm fine, thanks!"]],
'visible': [['hi', 'hey'], ['how are you?', "i'm fine, thanks!"]]
}
Each row is in the format [input, reply]
. history['visible']
contains the messages as they will appear in the UI, and history['internal']
contains the messages as they appear in the prompt. When no extension is used, the two will be identical, but many extensions add images, audio widgets, or translations to history['visible']
.
As a rule of thumb, new extensions should be submitted to https://github.com/oobabooga/text-generation-webui-extensions. You are highly encouraged to submit your extensions to that list!
New built-in extensions can be accepted in cases where they would be useful to a large percentage of the user base, preferably while adding few or no additional dependencies.