Iris is a hybrid distributed runtime built in Rust with first-class Python bindings. It combines three execution styles:

• Actor Mesh: Stateful, message-driven workflows with high concurrency.
• Native Offload/JIT: CPU-heavy hot paths accelerated via Cranelift. This path is experimental, currently paused, and may be dropped in future releases.
• Cross-Language API: Service-oriented apps mixing Rust and Python.

Iris uses a cooperative reduction-based scheduler for fairness, providing built-in supervision, hot swapping, discovery, and location-transparent messaging across nodes.

• Hybrid Concurrency: Mix "Push" green-thread actors with "Pull" OS-thread actors.
• Atomic Hot-Swap: Update live application logic (Python) with zero downtime.
• Global Discovery: Register and resolve named services locally or over the network.
• Resilience: Built-in supervision, load shedding, and network-aware exit reasons for self-healing systems.
• Observability: Deep runtime introspection, system metrics, and actor health tracking.
• Async Request/Reply: Built-in call() semantics for ergonomic, awaitable actor communication.
• Vortex-Transmuter (Experimental): Instruction-bound preemption, transactional ghosting primitives, and guarded bytecode transmutation with explicit fallback telemetry (see Vortex-Transmuter Guide).
• JIT Acceleration: Transparently compile Python math functions to native machine code.
  • Quantum Speculation: Optional multi-variant JIT selection with runtime telemetry, bounded by compile budget and cooldown controls (see JIT Internals & Configuration).

pip install maturin
maturin develop --release

npm install
npm run build

import iris
rt = iris.Runtime()

# 1. Spawn a high-performance actor
def worker(msg):
    print(f"Got: {msg}")

pid = rt.spawn(worker, budget=50)

# 2. Transparently offload math to JIT
@iris.offload(strategy="jit", return_type="float")
def fast_math(x: float):
    return x * 1.5 + 42.0

# 3. Message the actor
rt.send(pid, b"hello world")
rt.send_many(pid, [b"a", bytearray(b"b"), memoryview(b"c")])
print(fast_math(10.0))

• Full Architecture Reference
• Usage Examples & API Guide
• JIT Internals & Configuration
• Distributed Mesh & Discovery
• Vortex-Transmuter Guide & Roadmap