Welcome to Gazu’s documentation!
Gazu is a Python client for the Kitsu API. It allows fetching easily your production data. More than giving access to data, it allows performing operations on it like marking a task as started or setting a thumbnail on a shot.
NB: It requires an up and running instance of the Kitsu API to run properly.
Who is it for?
The audience for this Python client is Technical Artists, Technical Directors and Software Engineers from animation/VFX studios. With Gazu they can augment their tools with the production data.
Quickstart
Install Gazu in your application environment via pip:
pip install gazu
The client requires a few extra configuration before being used. It needs to know where is located the API server and to log in:
import gazu
gazu.set_host("https://zou-server-url/api")
gazu.log_in("user@yourdomain.com", "password")
Let’s finish with an example. Fetch all the open projects:
projects = gazu.project.all_open_projects()
Use cases
Here is a non exhaustive list of use cases that allows Gazu:
Make sure that every artist workstations are on the same page when dealing with the file system.
Build a todo list for artists of the project.
Get working file paths and output file paths for a given task.
Get next available working revision for a given task.
Manage automatic validation changes.
Sources
The source is available on Github.
Projects based on Gazu
Our community built open-source tools to connect your CG tools to your Kitsu instance. They are listed below:
Qtazu: Qt Widgets such as a login modal.
Nagato: Publishing and file versioning for Blender.
Bamboo: Pyside2 widgets to publish previews to Kitsu.
Kitsu Publisher: Our publish tool for Blender and Harmony.
Contents
Function References
About authors
Gazu is written by CGWire, a company based in France. We help animation and VFX studios to collaborate better through efficient tooling. We already work with more than 70 studios around the world.
Visit our website for more information.
