ZigX

A maturin-like Python binding system implemented in pure Zig

---

ZigX makes it easy to create Python extensions using Zig, providing automatic ctypes-based bindings, type stub generation, GIL support, and cross-platform wheel building.

Features

• 🚀 Pure Zig Implementation - No Python build dependencies beyond standard library
• 📦 Wheel Building - Create platform-specific wheels with proper metadata
• 🔧 Development Mode - Hot-reload friendly develop command
• 📝 Type Stubs - Automatic .pyi file generation for IDE support
• 🔒 GIL-Safe - Automatic GIL release for ctypes calls (just like maturin/pyo3)
• 🌐 Cross-Platform - Supports Linux, Windows, and macOS
• 🎯 Automatic Export Detection - No configuration needed, exports are detected from Zig source
• ⚡ uv Integration - Works seamlessly as a PEP 517 build backend

Quick Start

# Install zigx
pip install zigx

# Create a new project
zigx new myproject
cd myproject

# Build in development mode
zigx develop

# Use in Python
python -c "import myproject; print(myproject.add(1, 2))"

Example

Write your Zig code:

// src/lib.zig
pub export fn add(a: i32, b: i32) i32 {
    return a + b;
}

pub export fn fibonacci(n: u32) u64 {
    if (n <= 1) return n;
    var a: u64 = 0;
    var b: u64 = 1;
    var i: u32 = 2;
    while (i <= n) : (i += 1) {
        const c = a + b;
        a = b;
        b = c;
    }
    return b;
}

Use in Python with automatic bindings:

import myproject

result = myproject.add(1, 2)  # Returns 3
fib_10 = myproject.fibonacci(10)  # Returns 55

Requirements

• Zig 0.14.0 or later (0.15.0+ recommended)
• Python 3.8 or later
• uv (recommended) or pip

Navigation

• 🚀 Getting Started

  ---

  Install ZigX and create your first project

  → Installation

• 📖 User Guide

  ---

  Learn how to write Zig code and build Python extensions

  → User Guide

• 💻 Examples

  ---

  Explore example projects and use cases

  → Examples

• 🔧 Reference

  ---

  CLI commands, configuration, and API reference

  → Reference