Developer documentation#

Here we provide some guides for the development of Argilla.

Development setup#

To set up your system for Argilla development, you first of all have to fork our repository and clone the fork to your computer:

git clone https://github.com/[your-github-username]/argilla.git
cd argilla

To keep your forkโ€™s master branch up to date with our repo you should add it as an upstream remote branch:

git remote add upstream https://github.com/argilla-io/argilla.git

Now go ahead and create a new conda environment in which the development will take place and activate it:

conda env create -f environment_dev.yml
conda activate argilla

In the new environment Argilla will already be installed in editable mode with all its server dependencies.

To keep a consistent code format, we use pre-commit hooks. You can install them by simply running:

pre-commit install

Install the commit-msg hook if you want to check your commit messages in your contributions:

pre-commit install --hook-type commit-msg

The last step is to build the static UI files in case you want to work on the UI:

bash scripts/build_frontend.sh

If you want to run the web app now, simply execute:

python -m argilla

Congrats, you are ready to take Argilla to the next level ๐Ÿš€

Building the documentation#

To build the documentation, make sure you set up your system for Argilla development. Then go to the docs folder in your cloned repo and execute the make command:

cd docs
make html

This will create a _build/html folder in which you can find the index.html file of the documentation.

Alternatively, you can use install and sphinx-autobuild to continuously deploy the webpage using the following command:

sphinx-autobuild docs/_source docs/_build/html