Pipeline automation

Bulk texture processing CLI.

Upload private texture batches, start the processor, monitor progress, and retrieve production ZIPs from a terminal or build pipeline.

Install

The client uses only Python's standard library and requires Python 3.10 or newer.

Windows PowerShell

irm https://texelmatic.com/install.ps1 | iex

macOS / Linux

curl -fsSL https://texelmatic.com/install.sh | sh

Open a new terminal after installation, then confirm it is ready with texelmatic --help.

Download texelmatic.py

python texelmatic.py --help
$env:TEXELMATIC_API_TOKEN="txm_your_token"   # PowerShell
export TEXELMATIC_API_TOKEN="txm_your_token" # macOS / Linux

Create or revoke tokens from Account Settings → CLI / API. A token is shown once and inherits your account limits and points balance.

Common workflow

texelmatic upload ./textures --project "Castle" --start --wait --download castle-materials.zip
texelmatic status BATCH_ID
texelmatic wait BATCH_ID
texelmatic download BATCH_ID -o materials.zip

Resuming an interrupted transfer

The CLI prints the upload-session ID as soon as staging begins. Repeat the upload with the same files and pass --resume-id SESSION_ID; the server reports confirmed offsets and only missing chunks are sent.

texelmatic upload ./textures --resume-id SESSION_ID

Privacy and safety

CLI batches use the same private Bulk Processor storage, SHA-256 integrity checks, duplicate detection, tier limits, point reservation, retention rules, and owner-only downloads as the web Intake Deck. Tokens are stored only as hashes and can be revoked independently.

Command-line workflow

Automate private texture-to-PBR batches from a terminal.

The CLI uses the same private Bulk Processor, account limits, points wallet, resumable uploads, worker progress, and owner-only downloads as the web interface. It is dependency-free beyond Python 3.10 or newer.

Install on Windows, macOS, or Linux

Use the provided PowerShell or shell installer, or download the single Python client directly.

Resume large folder uploads

SHA-256 fingerprints and upload-session offsets allow interrupted transfers to continue without resending confirmed chunks.

Run the complete pipeline

Upload a directory, start its processor run, monitor map-level progress, and download the completed ZIP from one command.

Practical questions

Before you start

What does the TEXELMATIC CLI require?

It uses only Python's standard library and requires Python 3.10 or newer. No pip package installation is required.

How do I authenticate the CLI?

Create a personal CLI token in Account Settings, then store it in the TEXELMATIC_API_TOKEN environment variable. The full token is displayed only once.

Can an interrupted upload resume?

Yes. Re-run the upload with the same files and pass the printed upload-session ID using --resume-id.

Does the CLI make textures public?

No. CLI batches use the same private storage and owner-only output downloads as the web Bulk Processor.