Installation Guide#
Cloning the Repository#
The OpenColorIO Configuration for ACES repository uses Git submodules thus cloning the repository requires initializing them:
git clone --recursive https://github.com/AcademySoftwareFoundation/OpenColorIO-Config-ACES.git
If you have already cloned the repository and forgot the --recursive
argument, it is possible to initialize the submodules as follows:
git submodule update --init --recursive
uv#
The OpenColorIO Configuration for ACES repository adopts uv to help managing its dependencies, this is the recommended way to get started with development.
Assuming python >= 3.10 is available on your system along with OpenColorIO, the development dependencies are installed with uv as follows:
git clone --recursive https://github.com/AcademySoftwareFoundation/OpenColorIO-Config-ACES.git
cd OpenColorIO-Config-ACES
uv sync --all-extras
The aces-dev CTL reference graph can be plotted but it requires Graphviz to be installed on the system.
Docker#
Installing the dependencies for the previous config generator was not a trivial task. For ease of use an aswf-docker based container is now available.
Creating the container from the Dockerfile is done as follows:
docker build -t aswf/opencolorio-config-aces:latest .
or alternatively, if the dependencies described in the next section are satisfied:
invoke docker build
Then, to run bash in the container:
docker run -it -v ${PWD}:/home/aswf/OpenColorIO-Config-ACES aswf/opencolorio-config-aces:latest /bin/bash
Pypi#
The OpenColorIO Configuration for ACES package requires various dependencies in order to run and be able to generate the OCIO configurations: