Veizik documentation

From nothing to a first run

# the veizik command for Linux x86-64
$ curl -fsSL https://veizik.com/install.sh | sh
# if the installer asks you to put ~/.local/bin on your PATH
$ export PATH="$HOME/.local/bin:$PATH"
$ veizik list
# Qwen (language): install by qwen, qwen35, qwen36 or a full model key (qwen35_0p8b, qwen35_2b, qwen35_4b, qwen35_9b, qwen36_35b_a3b)
$ veizik install qwen36
# activation needs no weights; point VZ_WEIGHTS at the checkpoint you downloaded, for veizik run
$ export VZ_WEIGHTS=/data/models
$ veizik activate
$ veizik run qwen36_35b_a3b "The capital of France is" --tokens 32
$ veizik chat qwen35_2b
$ veizik serve qwen35_2b --weights /data/models/Qwen3.5-2B --port 8000
# Wan (video): install by wan, wan21, wan22 or a full model key (wan21_t2v_1_3b, wan21_t2v_14b, wan22_t2v_a14b, wan22_i2v_a14b)
$ veizik install wan22
$ veizik activate # once per device; for the Wan package too
$ veizik pull wan22 # fetches the Wan weights and prepares the video decoder
$ veizik run wan22_t2v_a14b "<your prompt>" --out ./clip
$ veizik serve wan22_t2v_a14b --port 8000 # render API: POST /v1/videos/generations

$ ./install.sh
$ veizik activate
$ veizik pull <model>
$ veizik run <model> "…"
$ veizik chat <model>
$ veizik serve <model>

Apple Silicon, step by step. The Veizik build for Apple Silicon installs from its signed disk image, exactly as before. NVIDIA installs with one veizik command, model engines by name, above.

1. 1

   Install

   on your machine

   One signed package. One command in a shell, and it is ready.

   ./install.sh

2. 2

   Create an account

   needs the network

   An email link, Google or GitHub. Self-service, nobody in the loop.

   veizik.com/signin

3. 3

   Activate this device

   needs the network

   The command opens your browser — and prints the link too, in case it cannot. You approve there, and the machine receives a licence bound to it.

   veizik activate

4. 4

   Pull a checkpoint

   needs the network

   One command downloads a supported safetensors checkpoint into the local cache and makes it ready to run. A gated repository needs a token stored with veizik hf login; the licence is accepted at the publisher.

   veizik pull

5. 5

   Run

   on your machine

   Generation happens on the device. Your prompt, the weights and the output stay on the machine; the first run of a session leases the licence key into memory, and for the window the server sets — 48 hours as of 2026-10-02 — the runs that reuse it need no connection. Restarting the computer ends the window.

   veizik run

3 of the 5 steps reach the network. Generation is not one of them.

# 1 · get the build — signed package, published with its digest
#     account:  veizik.com/signin   (free, one click)
#     build:    github.com/veizikhq/veizik-metal/releases

# 2 · verify and install — shell only, nothing compiled
$ shasum -a 256 -c SHA256SUMS
$ ./install.sh

# 3 · put this machine on your account
$ veizik activate

# 4 · fetch a supported checkpoint, then run
$ veizik pull qwen2.5-7b
$ veizik run qwen2.5-7b "The capital of France is"
 Paris

Getting the build

One command set on every engine.

Every model engine answers the same commands. What differs is the set of run options an engine accepts and the shape of its local server. A run option an engine does not accept is refused with a message that names it (<flag> does not apply to this model.), never silently ignored. veizik <command> --help gives the detail for one command.

Use a model

Get and manage models

Look after the installation

veizik update and veizik convert are in the command list but do not do their work in this release: update has no catalogue refresh and convert has no converter.

Run options: one vocabulary, translated per engine.

Write one set of options. The command passes on only the ones the engine accepts and refuses the rest.

Every run takes --out DIR, --name NAME, --prompt-file FILE, --resume, --resume-from REF and --checkpoint-every N. --resume-from REF resumes that run's directory: REF is a --name or an absolute directory, and its saved state is reloaded. Bare --resume continues the render in the directory the command resolves to, so repeat the run with the same --out/--name (or neither, for the default folder) and the same prompt. Resume finishes that same render — same prompt, seed and settings — it does not re-prompt it; to change the prompt, start a new render.

Serve: the API each engine answers.

• veizik run, chat and serve generate only after veizik activate (browser approval, once per device) and with the model's weights present (--weights DIR, VZ_WEIGHTS, or the pull cache). Output from these commands has not been certified end to end yet.
• veizik pull wan22 downloads the Wan weights (Apache-2.0) and prepares the video decoder automatically — no manual VAE setup or support request.

The commands documented here

This build also ships commands for running a shared server for other people. They are not documented here yet. veizik help on the installed build prints every command it has.

Every command here is one the release binary has — the list is compared against the binary before a release goes out — and veizik help lists the few it has that this page does not document. Where a command can be run without changing anything, what it does was checked as well; the ones that generate, download, install or delete are described from the binary, not from a run.

Scriptable and fixed

Common results

Release-specific limitations are listed with each release.