vcraft

CPython bindings written in V. vcraft is to the V language what PyO3 + maturin is to Rust: a code generator that turns @[vc_*] annotations into extension glue, and a wheel writer that packages the result. No Rust, C++ or zlib in the pipeline.

module hello_native

import vcraft

@[vc_fn]
pub fn greet(name string) string {
    return 'Hello, ${name}!'
}

import hello_native
print(hello_native.greet("world"))  # Hello, world!

Highlights

• A V source file is the API. Annotate a function, a class or a field and the generator writes the glue, the type stubs and the wheel.
• The whole pipeline is V and Python. The compiler is V; the wheel writer builds DEFLATE, ZIP, tar, SHA-256 and METADATA from scratch, with no zlib.
• Near-PyO3 performance, with instance state inline in the object.
• Every supported CPython, 3.11 to 3.15 plus the free-threaded builds, on Linux (glibc and musl), macOS and Windows.

Where to go next

• Getting started — install the CLI and build your first extension.
• The annotation vocabulary — what each @[vc_*] does.
• Type marshalling — how V and Python types map.
• Classes and properties — @[vc_class], fields, constructors.
• The command line and Wheels — build, develop, publish, abi3 and free-threading.

Built with vcraft

vqubit is a dependency-free quantum computing framework for Python in the spirit of Cirq: its linear algebra, gate matrices and simulators are written in V. It ships as a single abi3 wheel per platform, CPython 3.11 and newer, and pulls in nothing else — a good, complete example of a project built on vcraft (source, docs).

Status

1.4.4. The annotation vocabulary, the vcraft.toml keys and the CLI change only with a deprecation period. See the roadmap for what is left, and DECISIONS.md for what was set aside and why.