Skip to main content

Quickstart

Zyntra is one Go binary with an embedded console. Building from source needs Go and Node 22 (for the console in web/). No cluster, database or model is required.

A ranked plan from a CSV​

git clone https://github.com/zyvorai/zyvor-zyntra.git && cd zyntra
make build                                          # console (web/, Node 22) and the Go binary
./bin/zyntra plan -f packs/shop                     # a ranked plan from CSV fixtures, no cluster needed

plan ranks a reorder and refuses a markdown that would break the shop's margin invariant. Try the other commands against the same pack:

./bin/zyntra gaps -f packs/shop                                 # KPIs missing target, worst first
./bin/zyntra simulate -f packs/shop -action reorder_fast_movers # predicted change to every KPI, with ranges
./bin/zyntra pack validate packs/shop                           # check a pack against its fixture

Open the console​

ZYNTRA_API_KEY=dev ./bin/zyntra serve -f packs/shop   # console and API on :8080

Open http://127.0.0.1:8080 and sign in as admin / Admin@321. That account exists only while the policy file defines no users, and the console shows a banner until you set ZYNTRA_ADMIN_PASSWORD. See Console and sign-in for every page and role.

Or run the container​

docker run --rm -p 8080:8080 -e ZYNTRA_API_KEY=dev ghcr.io/zyvorai/zyntra:edge

Images are multi-arch (amd64 and arm64) and cosign-signed, with an SBOM and provenance. For Compose, Helm, k3s and systemd installs, see Deploy.

Packs for your industry​

IndustryPackTry it
Retailpacks/shop./bin/zyntra plan -f packs/shop
Manufacturingpacks/manufacturing./bin/zyntra plan -f packs/manufacturing
Logisticspacks/logistics./bin/zyntra plan -f packs/logistics
Paymentspacks/payments./bin/zyntra plan -f packs/payments
AI infrastructurepacks/gpu./bin/zyntra plan -f packs/gpu
Imaging operationspacks/imaging-ops./bin/zyntra plan -f packs/imaging-ops
Virtualization fleetpacks/virtualization./bin/zyntra plan -f packs/virtualization
Site reliability (SRE)packs/sre./bin/zyntra plan -f packs/sre

A pack is a directory of files: pack.yaml, kpis.yaml, sources.example.yaml, a README and a fixture/ of sample exports. zyntra pack draft -industry TEXT -sample FILE drafts one from your own export. The newer packs carry declared starting weights, not measured ones: calibrate them against your own outcomes before you lean on the ranking. See The model and packs.

Next steps​