Welcome to Gazu’s documentation!

logo

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.

cgwirelogo