|
| 1 | +# Zixir v5.3.0 — Minor Release ⭐ RECOMMENDED |
| 2 | + |
| 3 | +Minor release with installer improvements and enhancements. Follows semantic versioning (new features = minor version bump). No breaking changes. |
| 4 | + |
| 5 | +--- |
| 6 | + |
| 7 | +## New Features & Improvements |
| 8 | + |
| 9 | +### Installer improvements |
| 10 | +- **Windows (install-zixir.ps1)** — Production installer: structured logging, `-InstallDir` / `-Force` / `-SkipCUDA`, cleanup flow, prerequisite checks, clearer CUDA prompt |
| 11 | +- **Unix (install-zixir.sh)** — Version aligned to v5.3.0; one-shot quick start + optional Metal/CUDA/ROCm |
| 12 | +- **Bootstrap installers** — `install-zixir-bootstrap.sh` and `install-zixir-bootstrap.ps1` updated for v5.3.0 (curl/iwr one-liners) |
| 13 | + |
| 14 | +### Other enhancements |
| 15 | +- Version bump to **5.3.0** across mix.exs and all installer scripts |
| 16 | +- Documentation and quick start paths updated for v5.3.0 |
| 17 | + |
| 18 | +--- |
| 19 | + |
| 20 | +## Requirements |
| 21 | + |
| 22 | +- **Elixir** 1.14+ / OTP 25+ |
| 23 | +- **Zig** 0.15+ (build-time; run `mix zig.get` after `mix deps.get`) |
| 24 | +- **Python** 3.8+ *(optional)* for ML/specialist calls |
| 25 | +- **GPU** *(optional)* — CUDA (NVIDIA, Windows/Linux), ROCm (AMD, Linux), or Metal (macOS). See [SETUP_GUIDE.md](SETUP_GUIDE.md#gpu-computing). |
| 26 | + |
| 27 | +## Quick start |
| 28 | + |
| 29 | +**One-shot installer (includes Quick start + optional GPU: Metal / CUDA / ROCm):** |
| 30 | + |
| 31 | +```bash |
| 32 | +# Unix/macOS — clone, checkout v5.3.0, mix deps.get, mix zig.get, mix compile, then optional Metal (macOS) or CUDA/ROCm (Linux) |
| 33 | +git clone https://github.com/Zixir-lang/Zixir.git |
| 34 | +cd Zixir |
| 35 | +git checkout v5.3.0 |
| 36 | +./scripts/install-zixir.sh |
| 37 | +``` |
| 38 | + |
| 39 | +```powershell |
| 40 | +# Windows — clone, checkout v5.3.0, mix deps.get, mix zig.get, mix compile, then optional CUDA |
| 41 | +git clone https://github.com/Zixir-lang/Zixir.git |
| 42 | +cd Zixir |
| 43 | +git checkout v5.3.0 |
| 44 | +.\scripts\install-zixir.ps1 |
| 45 | +``` |
| 46 | + |
| 47 | +The installer runs `mix deps.get`, `mix zig.get`, `mix compile`, then prompts to install platform GPU deps: **Metal** (macOS), **CUDA** (Windows/Linux NVIDIA), **ROCm** (Linux AMD). |
| 48 | + |
| 49 | +**Manual (no installer script):** |
| 50 | + |
| 51 | +```bash |
| 52 | +git clone https://github.com/Zixir-lang/Zixir.git |
| 53 | +cd Zixir |
| 54 | +git checkout v5.3.0 |
| 55 | +mix deps.get |
| 56 | +mix zig.get |
| 57 | +mix compile |
| 58 | +``` |
| 59 | + |
| 60 | +**Optional (GPU) after manual setup:** From repo root: `./scripts/install-optional-deps.sh` (Unix: Metal/CUDA/ROCm) or `.\scripts\install-optional-deps.ps1 -Install` (Windows: CUDA). |
| 61 | + |
| 62 | +## License |
| 63 | + |
| 64 | +**Apache-2.0** — see [LICENSE](LICENSE). |
0 commit comments