Zou, the Kitsu API is the memory of your animation production

The Kitsu API allows to store and manage the data of your animation/VFX production. Through it, you can link all the tools of your pipeline and make sure they are all synchronized.

A dedicated Python client, Gazu, allows users to integrate Zou into the tools.

Features

Zou can:

• Store production data, such as projects, shots, assets, tasks, and file metadata.
• Track the progress of your artists
• Store preview files and version them
• Provide folder and file paths for any task
• Import and Export data to CSV files
• Publish an event stream of changes

Installation and Documentation

Installation of Zou requires the setup of third-party tools such as a database instance, so it is recommended to follow the documentation:

https://zou.cg-wire.com/

Specification: - https://api-docs.kitsu.cloud/

Contributing

Contributions are welcomed so long as the C4 contract is respected.

Zou is based on Python and the Flask framework.

You can use the pre-commit hook for Black (a Python code formatter) before committing:

pip install pre-commit
pre-commit install

If you use Claude Code (or another AI assistant that reads CLAUDE.md), copy CLAUDE.local.md.example to CLAUDE.local.md and adapt it to your local environment (virtualenv path, test database name, etc.). The CLAUDE.local.md file is gitignored and holds your local-only commands (test execution, migrations), while CLAUDE.md only documents code conventions shared by the whole team.

cp CLAUDE.local.md.example CLAUDE.local.md

Instructions for setting up a development environment are available in the documentation

Contributors

• @aboellinger (Xilam/Spa)
• @BigRoy (Colorbleed)
• @EvanBldy (CGWire) - maintainer
• @ex5 (Blender Studio)
• @flablog (Les Fées Spéciales)
• @frankrousseau (CGWire) - maintainer
• @kaamaurice (Tchak)
• @g-Lul (TNZPV)
• @pilou (Freelancer)
• @LedruRollin (Cube-Xilam)
• @mathbou (Zag)
• @manuelrais (TNZPV)
• @NehmatH (CGWire)
• @pcharmoille (Unit Image)
• @Tilix4 (Normaal)

About authors

Kitsu is written by CGWire, a company based in France. We help with 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.