Gazu, Python client for the Kitsu API
The Kitsu Python client allows you to fetch data easily from the Kitsu collaboration platform. With Gazu, you bring assets and shots data into your pipeline tools. It comes with extra features such as preview publishing and event stream listening.
It is made to be used with the Kitsu API. It requires an up-and-running instance of Kitsu to run correctly.
Quickstart
Install Gazu in your application environment via pip:
pip install gazuFor the asynchronous API (gazu.aio), install the async extra:
pip install gazu[async]The client requires a few extra configurations 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")For scripts, DCC integrations and automation, prefer a bot token over user credentials:
gazu.set_host("https://zou-server-url/api")
gazu.set_token("your-bot-jwt-token")Let’s finish with an example. Fetch all the open projects:
projects = gazu.project.all_open_projects()
CLI
Gazu ships with an optional command-line interface. Install it with:
pip install gazu[cli]Then log in and start querying your Kitsu instance from the terminal:
gazu-cli login --host https://zou-server-url/api
gazu-cli projects
gazu-cli assets --project "My Project"
gazu-cli my-tasks
gazu-cli shots --project "My Project" --sequence SEQ01
gazu-cli comment --task <task-id> --status wip --message "Started lighting"Use gazu-cli --help to see all available commands. Add --json to any command to get machine-readable JSON output. You can also set the GAZU_PROJECT environment variable to avoid repeating --project.
Documentation
Documentation and specification are available on a dedicated website:
Projects using the Kitsu client
Our community-built open-source tools connect your content creation 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.
Gazu Publisher: Our work in progress publisher tool.
Contributions
All contributions are welcome as long as they respect the C4 contract.
The code must follow the pep8 convention.
You can use the pre-commit hook for Black (a Python code formatter) before committing :
pip install pre-commit
pre-commit installContributors
@aboellinger (Xilam)
@BigRoy (Colorbleed)
@col-one (Allegorithmic)
@EvanBldy (CGWire) - maintainer
@flablog (Les Fées Spéciales)
@frankrousseau (CGWire) - maintainer
@kguyaux
@LedruRollin (Xilam)
@g-Lul (TNZPV)
@jdrese (HEAJ)
@pcharmoille (Unit Image)
@tokejepsen (Bumpybox)
@tpodeva
About authors
Kitsu 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 cg-wire.com for more information.
1 maintainer
Release files for gazu 1.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| gazu-1.3.1.tar.gz | 131.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gazu-1.3.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 225.6 kB
Release files / gazu-1.3.1.tar.gz
| Download URL | gazu-1.3.1.tar.gz |
|---|---|
| Size | 131.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ec828f775fe819cb67d14606c44941f268c3ef925c6536a8f1cf47eddc2d5017
|
|
BLAKE2b-256 checksum How to use checksums |
918f0be61ab56c810b553012dabccd1e09519adc709e8a5360b094c82be424de
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency logRelease files / gazu-1.3.1-py3-none-any.whl
| Download URL | gazu-1.3.1-py3-none-any.whl |
|---|---|
| Size | 94.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
15b8d00aa5975009a789fd5b954c72669cda4c279bd10fdd10249155f8cfd6f9
|
|
BLAKE2b-256 checksum How to use checksums |
724c872ae30171cc6e606bf04d1e788fcd3b5f36272cfe7133863c9058e9f9c7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency log
