Pype Commands Reference


To get all available commands:

pype --help

To get help on particular command:

pype <command> --help


Command to clean Python bytecode files from Pype and it's environment. Useful for developers after code or environment update.



  • without this option, tests are run on pype-setup only.

Generate code coverage report.

pype coverage --pype


To deploy Pype:

pype deploy


To force re-deploy:

pype deploy --force


To download required dependencies:

pype download


This command launches ftrack event server.

This should be ideally used by system service (such us systemd or upstart on linux and window service).

You have to set either proper environment variables to provide URL and credentials or use option to specify them. If you use --store_credentials provided credentials will be stored for later use.

To run ftrack event server:

pype eventserver --ftrack-url=<url> --ftrack-user=<user> --ftrack-api-key=<key> --ftrack-events-path=<path> --no-stored-credentials --store-credentials


  • print debug info


  • URL to ftrack server


  • user name to log in to ftrack


  • ftrack api key


  • path to event server plugins


  • will use credential specified with options above


  • will store credentials to file for later use


To install Pype:

pype install


To reinstall Pype:

pype install --force


To install Pype in offline mode:

pype install --offline

To reinstall Pype in offline mode:

pype install --offline --force


Launch application in Pype environment.


Application name - this should be the same as it's defining toml file (without .toml)


Project name


Asset name


Task name


Optional: Additional tools environment files to add


Optional: User on behalf to run

--ftrack-server / -fs

Optional: Ftrack server URL

--ftrack-user / -fu

Optional: Ftrack user

--ftrack-key / -fk

Optional: Ftrack API key

For example to run Python interactive console in Pype context:

pype launch --app python --project my_project --asset my_asset --task my_task


Generate API documentation into docs/build

pype make_docs


To run testing mongodb database (requires mongoDB installed on the workstation):

pype mongodb


Pype takes JSON from provided path and use it to publish data in it.

pype publish <PATH_TO_JSON>


  • run Pyblish GUI


  • print more verbose infomation



  • without this option, tests are run on pype-setup only.

Run test suite on Pype:

pype test --pype

For more information about testing see Pytest documentation


Copy specified textures to provided asset path.

It validates if project and asset exists. Then it will copy all textures found in all directories under --path to destination folder, determined by template texture in anatomy. I will use source filename and automatically rise version number on directory.

Result will be copied without directory structure so it will be flat then. Nothing is written to database.




pype texturecopy --project <PROJECT_NAME> --asset <ASSET_NAME> --path <PATH_TO_JSON>


To launch Tray:

pype tray


To launch Tray with debugging information:

pype tray --debug


Synchronize dependecies in your virtual environment with requirement.txt file. Equivalent of running pip freeze > pypeapp/requirements.txt from your virtual environmnet. This is useful for development purposes.

pype update-requirements


To validate deployment:

pype validate


To validate JSON configuration files for syntax errors:

pype validate-config