v5.3.0 (Minor Release) ⭐ RECOMMENDED

Zixir v5.3.0 — Minor Release ⭐ RECOMMENDED

Minor release with installer improvements and enhancements. Follows semantic versioning (new features = minor version bump). No breaking changes.

---

New Features & Improvements

Installer improvements

• Windows (install-zixir.ps1) — Production installer: structured logging, -InstallDir / -Force / -SkipCUDA, cleanup flow, prerequisite checks, clearer CUDA prompt
• Unix (install-zixir.sh) — Version aligned to v5.3.0; one-shot quick start + optional Metal/CUDA/ROCm
• Bootstrap installers — install-zixir-bootstrap.sh and install-zixir-bootstrap.ps1 updated for v5.3.0 (curl/iwr one-liners)

Other enhancements

• Version bump to 5.3.0 across mix.exs and all installer scripts
• Documentation and quick start paths updated for v5.3.0

---

Requirements

• Elixir 1.14+ / OTP 25+
• Zig 0.15+ (build-time; run mix zig.get after mix deps.get)
• Python 3.8+ (optional) for ML/specialist calls
• GPU (optional) — CUDA (NVIDIA, Windows/Linux), ROCm (AMD, Linux), or Metal (macOS). See SETUP_GUIDE.md.

Quick start

One-shot installer (includes Quick start + optional GPU: Metal / CUDA / ROCm):

# Unix/macOS — clone, checkout v5.3.0, mix deps.get, mix zig.get, mix compile, then optional Metal (macOS) or CUDA/ROCm (Linux)
git clone https://github.com/Zixir-lang/Zixir.git
cd Zixir
git checkout v5.3.0
./scripts/install-zixir.sh

# Windows — clone, checkout v5.3.0, mix deps.get, mix zig.get, mix compile, then optional CUDA
git clone https://github.com/Zixir-lang/Zixir.git
cd Zixir
git checkout v5.3.0
.\scripts\install-zixir.ps1

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).

Manual (no installer script):

git clone https://github.com/Zixir-lang/Zixir.git
cd Zixir
git checkout v5.3.0
mix deps.get
mix zig.get
mix compile

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).

License

Apache-2.0 — see LICENSE.

v5.2.0

Zixir v5.2.0 — Hotfixes: type system, Python bridge, specs, errors

Patch release with bug fixes, documentation improvements, and type-safety enhancements. No breaking changes.

---

Bug Fixes

• Type system — Fixed pattern matching bugs in TypeSystem module (3 issues)
• Python bridge — Added missing Python bridge functions: math/2, numpy/2, stats/0, healthy?/0, parallel/2

---

Improvements

• install-zixir.ps1 — Fixed PowerShell parse error (split git fetch line); clearer "Install CUDA now? [y/N]" prompt
• Type safety — Added comprehensive @spec annotations (85+ functions)
• Errors — Added standardized error module (Zixir.Errors)
• Compiler — Removed compiler warning suppressions (5 files)
• Documentation — Improved code documentation across 20 files

---

Requirements

• Elixir 1.14+ / OTP 25+
• Zig 0.15+ (build-time; run mix zig.get after mix deps.get)
• Python 3.8+ (optional) for ML/specialist calls
• GPU (optional) — CUDA (NVIDIA, Windows/Linux), ROCm (AMD, Linux), or Metal (macOS). See SETUP_GUIDE.md.

Quick start

One-shot installer (includes Quick start + optional GPU: Metal / CUDA / ROCm):

# Unix/macOS — clone, checkout v5.2.0, mix deps.get, mix zig.get, mix compile, then optional Metal (macOS) or CUDA/ROCm (Linux)
git clone https://github.com/Zixir-lang/Zixir.git
cd Zixir
git checkout v5.2.0
./scripts/install-zixir.sh

# Windows — clone, checkout v5.2.0, mix deps.get, mix zig.get, mix compile, then optional CUDA
git clone https://github.com/Zixir-lang/Zixir.git
cd Zixir
git checkout v5.2.0
.\scripts\install-zixir.ps1

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).

Manual (no installer script):

git clone https://github.com/Zixir-lang/Zixir.git
cd Zixir
git checkout v5.2.0
mix deps.get
mix zig.get
mix compile

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).

License

Apache-2.0 — see LICENSE.

v5.1.0 — Hotfix: shared utils, dedup, config, engine retry fix

Zixir v5.1.0 — Hotfix: Shared utils, dedup, config, engine retry fix

Hotfix release: shared utilities module, elimination of code duplication, centralized configuration, and a critical engine retry bug fix.

---

1. Created Shared Utilities Module ✅

• New file: lib/zixir/utils.ex
• Functions: format_bytes/1, generate_id/1, now_ms/0, iso8601_now/0
• Centralized helpers used across the codebase

---

2. Eliminated Code Duplication ✅

• Removed 8 duplicate function clauses from 2 files
• Updated 5 modules to use centralized ID generation
• Files affected: cache.ex, sandbox.ex, workflow.ex, quality.ex, experiment.ex, checkpoint.ex

---

3. Centralized Configuration ✅

• New config values in config/config.exs:
  • python_timeout: 30_000
  • workflow_step_timeout: 30_000
• Files updated: worker.ex, pool.ex, workflow.ex
• All now read from config instead of hardcoded values

---

4. Fixed Critical Bug ✅

• File: lib/zixir/engine.ex
• Problem: Infinite loop risk in rescue block
• Solution: Added retry tracking to prevent endless retries

---

Requirements

• Elixir 1.14+ / OTP 25+
• Zig 0.15+ (build-time; run mix zig.get after mix deps.get)
• Python 3.8+ (optional) for ML/specialist calls

Quick start

git clone https://github.com/Zixir-lang/Zixir.git
cd Zixir
git checkout v5.1.0
mix deps.get
mix zig.get
mix compile
mix test

License

Apache-2.0 — see LICENSE.

v5.0.0 — Portable CLI, setup fixes, and redeploy

Zixir v5.0.0 — Portable CLI, setup fixes, and redeploy

This release adds a global/portable CLI (run Zixir from any terminal path), setup and docs fixes, signature test, test task sample, and PowerShell test script. Redeploy of v5 with these fixes included.

---

1. Global / Portable CLI ✅

• Run from any path — After mix release, add _build/dev/rel/zixir/bin (or prod) to PATH. Run zixir_run.bat (Windows) or zixir_run.sh (Unix) with a path to a .zixir file from any directory.
• Zixir.CLI — run_file(path) and run_file_from_argv() for release eval; argv handling skips -- so the path is correct.
• Overlay scripts — rel/overlays/bin/zixir_run.bat and zixir_run.sh included in the release.

---

2. Setup and docs fixes ✅

• SETUP_GUIDE.md — Added mix zig.get to Project Setup; aligned Zig version (0.15+); Windows install options (Scoop + installer link); note that Zigler can download Zig via mix zig.get.
• README.md — Link to SETUP_GUIDE for full install; “From a clone of the repo” before Setup commands.
• docs/INDEX.md — SETUP_GUIDE listed under Getting Started.

---

3. Signature test and test task ✅

• test/zixir/signature_test.exs — Unique test: hello-program signature (11.0), Zixir.run, parse→eval, idempotent eval; engine composition (dot_product + list_sum, etc.); parse/compile pipeline.
• examples/test_task.zixir — Sample that compiles and returns 22.0; used for portable CLI verification.
• scripts/test-portable-cli.ps1 — PowerShell script: (1) mix zixir.run relative path, (2) mix zixir.run absolute path, (3) release zixir_run.bat from another directory. Checks both dev and prod release paths.

---

4. Release and compatibility

• mix.exs — Version 5.0.0; release overlays rel/overlays for portable runner scripts.
• PowerShell 7.x — Test script runs correctly; release zixir_run.bat works from any cwd when given full path to a .zixir file.

---

Requirements

• Elixir 1.14+ / OTP 25+
• Zig 0.15+ (build-time; run mix zig.get after mix deps.get)
• Python 3.8+ (optional) for ML/specialist calls

Quick start

git clone https://github.com/Zixir-lang/Zixir.git
cd Zixir
git checkout v5.0.0
mix deps.get
mix zig.get
mix compile

Portable CLI (after mix release, add bin/ to PATH):

# Windows
zixir_run.bat C:\path\to\script.zixir

# Unix/macOS
./zixir_run.sh /path/to/script.zixir

License

Apache-2.0 — see LICENSE.

v4.0.0 — Compiler, type system, MLIR, parser improvements

Zixir v4.0.0 — Compiler, type system, and MLIR improvements

This release adds major improvements to the Zig backend, MLIR optimizations, type system, and parser: structs, maps, list comprehensions, try/catch, async/await, range expressions, comptime, defer, and self-healing AI pipelines. Plus automatic drift detection, A/B winner promotion, and data cleaning/validation.

---

1. Zig Backend (100%) ✅

• Automatic drift detection and alerting ✅
• Automatic winner promotion in A/B tests ✅
• Automatic data cleaning and validation ✅
• Self-healing AI pipelines ✅
• Struct/type definition generation
• Map literal generation
• Struct initialization and field access
• Better pattern matching (switch) codegen
• List comprehension generation
• Try/catch/finally expressions
• Defer statements
• Comptime blocks
• Async/await expressions
• Range expressions
• Strength reduction optimization

---

2. MLIR (100%) ✅

• Full dead code elimination with variable usage tracking
• Constant propagation with type checking
• Loop invariant code motion (LICM)
• Strength reduction for common patterns
• Better struct/map type representations

---

3. Type System (100%) ✅

• Lambda type inference
• Struct type inference
• Struct field access type inference
• Map types with key/value unification
• Map access type inference
• List comprehension type inference
• Range expression types
• Try/catch type inference
• Future/async type inference

---

4. Parser (100%) ✅

• List comprehension parsing ([expr for var in iterable if condition])
• Map literal parsing ({key => value, ...})
• Struct definition parsing (struct { field: Type })
• Try/catch parsing
• Async/await parsing
• Range expression parsing (start..end)
• Defer statement parsing
• Comptime block parsing

---

Requirements

• Elixir 1.14+ / OTP 25+
• Zig 0.15+ (build-time; run mix zig.get after mix deps.get)
• Python 3.8+ (optional) for ML/specialist calls

Quick start

git clone https://github.com/Zixir-lang/Zixir.git
cd Zixir
git checkout v4.0.0
mix deps.get
mix zig.get
mix compile
mix test

License

Apache-2.0 — see LICENSE.

v3.0.0 — AI automation release

Zixir v3.0.0 — AI automation release

This release adds full AI automation support: workflow orchestration with checkpointing, resource sandboxing, streaming/async, observability, and a cache layer. Plus universal improvements for binary serialization, tracing, sandbox results, and GenServer startup.

AI automation features

1. Workflow orchestration with checkpointing ✅

• Files: lib/zixir/workflow.ex, lib/zixir/workflow/checkpoint.ex
• Features: DAG execution, dependency management, automatic checkpointing, resume from failure, retry policies, dead letter queues
• Usage: Build fault-tolerant AI pipelines that recover automatically

2. Resource limits & sandboxing ✅

• File: lib/zixir/sandbox.ex
• Features: Time limits, memory limits (e.g. "2GB"), CPU monitoring, automatic process termination, call depth limits
• Usage: Prevent runaway AI processes from consuming all resources

3. Streaming & async support ✅

• File: lib/zixir/stream.ex
• Features: Async/await, parallel execution, lazy sequences, stream transformations (map, filter, batch), backpressure
• Usage: Handle streaming AI responses (LLMs) and parallel model inference

4. Structured observability ✅

• File: lib/zixir/observability.ex
• Features: JSON logging, execution tracing with spans, Prometheus-compatible metrics, performance monitoring
• Usage: Monitor AI workflows without manual intervention

5. Cache & persistence layer ✅

• File: lib/zixir/cache.ex
• Features: In-memory caching with TTL, disk persistence, database-like operations (insert/query/update), cache warming
• Usage: Store intermediate results and avoid redundant computation

Universal improvements

Improvement	Benefit
Binary serialization (instead of JSON)	Handles all Elixir data types (tuples, atoms, PIDs, etc.); more reliable for internal state persistence
Span struct initialization	Prevents KeyError in all tracing scenarios; works regardless of span lifecycle
Result wrapping in Sandbox	Follows Elixir {:ok, result} / {:error, reason} convention; consistent across all sandboxed operations
GenServer startup handling	Standard Elixir pattern for idempotent service startup; works in supervision trees and manual startup

Requirements

• Elixir 1.14+ / OTP 25+
• Zig 0.15+ (build-time; run mix zig.get after mix deps.get)
• Python 3.8+ (optional) for ML/specialist calls

Quick start

git clone https://github.com/PersistenceOS/Zixir.git
cd Zixir
git checkout v3.0.0
mix deps.get
mix zig.get
mix compile
mix test

License

Apache-2.0 — see LICENSE.

v0.2.0 — New update release

Zixir v0.2.0 — New update release

This release adds Python Bridge integration, 25+ engine operations, a module system, an interactive REPL, and pattern matching.

What's new

• Python Bridge — Full integration with numpy/pandas support, circuit breaker, connection pooling, and retry logic.
• 25+ Engine Operations — All aggregations, vector ops, transformations, search, matrix, and string operations.
• Module System — Import resolution, caching, and circular dependency detection.
• Interactive REPL — Multi-line input, variable persistence, built-in commands.
• Pattern Matching — Literal, variable, array patterns with guards.

Requirements

• Elixir 1.14+ / OTP 25+
• Zig 0.10+ (Zigler 0.15; run mix zig.get after mix deps.get)
• Python 3.10+ (for specialist; optional if not using Python calls)

Quick start

git clone https://github.com/PersistenceOS/Zixir.git
cd Zixir
git checkout v0.2.0
mix deps.get
mix zig.get
mix compile
mix test
mix zixir.run examples/hello.zixir

License

Apache-2.0 — see LICENSE.

v0.1.0 — Initial release

Zixir v0.1.0 — Initial release

First public release of Zixir: a programming language and three-tier runtime (Elixir + Zig + Python) for agentic coding.

What's included

• Zixir language: Parser, compiler, interpreter (eval/run); functions, let bindings, engine and Python calls.
• Three-tier runtime: Elixir (orchestrator), Zig (engine NIFs), Python (specialist via port).
• Public API: Zixir.run_engine/2, Zixir.call_python/3, Zixir.eval/1, Zixir.run/1.
• Mix tasks: mix zixir.run, mix zixir.eval, mix zixir.compile, mix zixir.test, etc.
• Docs: README (why three-tier, Mermaid layout), LICENSE (Apache-2.0), project analysis, language docs.

Requirements

• Elixir 1.14+ / OTP 25+
• Zig 0.10+ (Zigler 0.15; run mix zig.get after mix deps.get)
• Python 3.10+ (for specialist; optional if not using Python calls)

Quick start

git clone https://github.com/PersistenceOS/Zixir.git
cd Zixir
mix deps.get
mix zig.get
mix compile
mix test
mix zixir.run examples/hello.zixir

License

Apache-2.0 — see LICENSE.