Zero-CGO WebGPU bindings for Go — GPU-accelerated graphics and compute in pure Go

Pure Go WebGPU bindings using goffi + wgpu-native. No CGO required.

Beta — Comprehensive API ready for testing and feedback.

• Go 1.25+
• wgpu-native v29.0.0.0 (download)

go get github.com/go-webgpu/webgpu

go run github.com/go-webgpu/webgpu/cmd/setup@latest

This downloads the correct wgpu-native v29 binary for your platform (Windows/macOS/Linux, amd64/arm64) into ./lib/.

The library is found automatically from ./lib/ — no environment variable needed. To override the search path explicitly:

# Linux
export WGPU_NATIVE_PATH=./lib/libwgpu_native.so

# macOS
export WGPU_NATIVE_PATH=./lib/libwgpu_native.dylib

# Windows (PowerShell)
$env:WGPU_NATIVE_PATH = "lib\wgpu_native.dll"

# Windows (cmd)
set WGPU_NATIVE_PATH=lib\wgpu_native.dll

Or copy the library to your project root — it will also be found automatically.

Download from gfx-rs/wgpu-native releases and place in your project directory or system PATH.

Custom library location:

export WGPU_NATIVE_PATH=/path/to/libwgpu_native.so      # Linux/macOS
set WGPU_NATIVE_PATH=C:\path\to\wgpu_native.dll          # Windows

This library is the Rust FFI backend for gogpu/wgpu — the unified Go WebGPU package. Build with -tags rust to use wgpu-native instead of the Pure Go implementation:

go build -tags rust ./myapp

Same API, same types, same user code — build tag selects the implementation.

WebGPU types from gputypes are re-exported as type aliases in the wgpu package. A single import is sufficient:

import "github.com/go-webgpu/webgpu/wgpu"

// gputypes constants available directly via wgpu package
config.Format = wgpu.TextureFormatBGRA8Unorm
buffer.Usage = wgpu.BufferUsageVertex | wgpu.BufferUsageCopyDst

If you use multiple gogpu ecosystem packages, importing gputypes directly also works and is fully compatible:

import (
    "github.com/go-webgpu/webgpu/wgpu"
    "github.com/gogpu/gputypes" // optional — for ecosystem interop
)

config.Format = gputypes.TextureFormatBGRA8Unorm // same underlying type

go-webgpu API is designed to be compatible with gogpu/wgpu, enabling future backend switching within the gogpu ecosystem.

package main

import (
    "fmt"
    "log"

    "github.com/go-webgpu/webgpu/wgpu"
)

func main() {
    // Initialize library
    if err := wgpu.Init(); err != nil {
        log.Fatal(err)
    }

    // Create WebGPU instance
    instance, err := wgpu.CreateInstance(nil)
    if err != nil {
        log.Fatal(err)
    }
    defer instance.Release()

    // Request GPU adapter
    adapter, err := instance.RequestAdapter(nil)
    if err != nil {
        log.Fatal(err)
    }
    defer adapter.Release()

    fmt.Printf("Adapter: %#x\n", adapter.Handle())
}

Run examples:

cd examples/triangle && go run .

┌─────────────────────────────────────────┐
│            Your Go Application          │
│    (uses wgpu.TextureFormatBGRA8Unorm)  │
├─────────────────────────────────────────┤
│     go-webgpu/wgpu (this package)       │
│     - Go-idiomatic API                  │
│     - gputypes type aliases             │
│     - Error returns on all operations   │
├─────────────────────────────────────────┤
│     Internal FFI layer                  │
│     - Wire structs (C-layout)           │
│     - convert.go (enum translation)     │
│     - goffi (Pure Go FFI)               │
├─────────────────────────────────────────┤
│     wgpu-native v29 (Rust WebGPU)       │
├─────────────────────────────────────────┤
│     Vulkan / Metal / DX12 / OpenGL      │
└─────────────────────────────────────────┘

For a detailed explanation of the architecture, including why convert.go exists and the FFI wire struct contract, see docs/ARCHITECTURE.md.

This project uses FFI bindings to wgpu-native. If you're looking for a 100% Pure Go WebGPU implementation (no native dependencies), check out:

👉 github.com/gogpu — Pure Go GPU ecosystem

• goffi — Pure Go FFI (callbacks, cross-platform loading)
• gputypes — Shared WebGPU type definitions for the gogpu ecosystem
• wgpu-native — Rust WebGPU implementation (runtime binary, not a Go dependency)
• golang.org/x/sys — Platform-specific syscalls

MIT

Contributions welcome! Please open an issue or PR.