Valtz

A native macOS app for generative creation and composition, powered by Vpipe.

Let the pictures tell the story.

---

---

---

Build

Needs macOS 26 or later on Apple Silicon, Xcode (Swift 6), CMake ≥ 3.29, Ninja (brew install ninja) and an installed vpipe:

# vpipe, once (see its README): build it, then install it
cmake --install <vpipe-build> --prefix ~/dump/vpipe-install

git submodule update --init
cmake --preset dev && cmake --build --preset dev   # → ~/dump/valtz-build
~/dump/valtz-build/tests/valtz_test
open ~/dump/valtz-build/app/macos/Valtz.app

VALTZ_VPIPE_PREFIX points at a vpipe installed elsewhere; cmake --preset no-engine builds without vpipe (the UI and the store only).

The dev build runs in place: it finds libvpipe where it was installed. A relocatable app -- libvpipe and the plugin inside the bundle, every reference rewritten, signed ad hoc -- is the valtz-dist target:

cmake --preset release && cmake --build --preset release --target valtz-dist
# → ~/dump/valtz-build-rel/dist/Valtz.app

Auto-update (optional)

Valtz updates itself with Sparkle when it is built with it. Sparkle is not vendored:

app/macos/fetch-sparkle.sh            # → ~/dump/sparkle/Sparkle-<version>
cmake --preset release -DVALTZ_SPARKLE_DIR=~/dump/sparkle/Sparkle-<version>

Without it the app builds and runs, and simply never offers an update.

License

Valtz is licensed under the Mozilla Public License 2.0; see NOTICE. The Valtz Extension SDK, when it is published, will be licensed under the Apache License 2.0, as vpipe is; the example extensions (examples/extensions/) already are.

Third-party components -- vpipe, LMDB, nlohmann/json, Sparkle and MiniMax H3's prompt-writing guide, each under its own license -- are listed in THIRD_PARTY_LICENSES.md. Model weights are not part of Valtz, nor is anything licensed for non-commercial use only (such as QwenLM's Qwen-Image prompt rewriters): each is downloaded from its publisher, on request, under the publisher's license.