If you are looking to contribute you will need to have a local development environment. See the Developer Install for full details.
Broadly this involves cloning the repository, installing the pre-reqs, and InvokeAI (in editable form). Assuming this is working, choose your area of focus.
We use mkdocs for our documentation with the
material theme. Documentation is
written in markdown files under the
./docs folder and then built into a static
website for hosting with GitHub Pages at
To contribute to the documentation you'll need to install the dependencies. Note
the use of
Now, to run the documentation locally with hot-reloading for changes made.
You'll then be prompted to connect to
http://127.0.0.1:8080 in order to
The backend is contained within the
./invokeai/backend folder structure. To
get started however please install the development dependencies.
From the root of the repository run the following command. Note the use of
This in an optional group of packages which is defined within the
pyproject.toml and will be required for testing the changes you make the the
We use pytest for our test suite. Tests can
be found under the
./tests folder and can be run with a single
command. Optionally, to review test coverage you can append
Test outcomes and coverage will be reported in the terminal. In addition a more
detailed report is created in both XML and HTML format in the
folder. The HTML one in particular can help identify missing statements
requiring tests to ensure coverage. This can be run by opening
HTML coverage report output
Created: March 5, 2023