clvm-tools-rs

What it is and what it does

clvm_tools_rs is a Rust port of Chia's Chialisp compiler and CLVM tools, providing both a Python library and command-line utilities for developing smart contracts on the Chia blockchain. It compiles Chialisp source code to CLVM bytecode, executes CLVM programs, and offers interactive debugging and disassembly capabilities. The package includes a Python API for programmatic compilation and a set of CLI tools: run (compiler), repl (interactive evaluator), cldb (stepwise debugger), brun (bytecode executor), opc (s-expression to hex), and opd (hex to s-expression).

The package has no runtime dependencies and ships as precompiled wheels for major platforms (macOS, Linux, Windows). It is actively maintained as part of the Chia ecosystem. Installation via pip provides a subset of tools; full functionality requires cargo installation. The codebase includes both a ported classic compiler and a newer simplified compiler selectable via source directives.

Use it for:

• Compile Chialisp smart contracts to CLVM bytecode for deployment on the Chia blockchain
• Debug Chialisp programs interactively using the REPL or stepwise debugger (cldb) with YAML output
• Convert between CLVM s-expression and hex representations for low-level program analysis (opc/opd)
• Integrate Chialisp compilation into Python build pipelines for automated contract compilation
• Execute and test CLVM programs directly via the brun tool or Python API
• Develop Chia blockchain applications using the Python bindings within a venv or conda environment

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Compiles and executes Chialisp programs to CLVM bytecode, providing Python bindings for the Chia blockchain's smart contract language alongside command-line tools for compilation, disassembly, and interactive evaluation.

Yes, if you are developing on the Chia blockchain or working with Chialisp. The package is actively maintained, has no runtime dependencies, ships precompiled for major platforms, and offers both Python and CLI interfaces. The Apache-2.0 license poses no restrictions. Install friction is moderate due to platform-specific wheels but manageable. No known vulnerabilities. Verify Python version compatibility before installing.

Install

clvm-tools-rs on PyPI

pip install clvm-tools-rs

uv add clvm-tools-rs

poetry add clvm-tools-rs

Installing clvm-tools-rs

Before you install

Medium install friction due to compiled wheels for multiple platforms (macOS arm64/x86_64, Linux aarch64/x86_64, Windows x64, musl). Last release 379 days ago; repository is active with recent commits as of 2026-08-12, indicating ongoing maintenance despite infrequent version bumps.

License in practice

Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions—suitable for most development and deployment scenarios.

Quickstart

from clvm_tools_rs import compile_clvm

compile_result = compile_clvm(
    'path/to/program.clsp',
    'output.clvm.hex',
    include_paths=[],
    include_symbols=True
)
symbols = compile_result['symbols']

Wheels are cp39-abi3; no runtime dependencies but compilation from source requires Rust toolchain and maturin.

Verify before relying

• Exact Python version range supported (wheels are cp39-abi3 but requires_python is unspecified)
• Whether all command-line tools (run, repl, cldb, brun, opc, opd) are accessible via pip install or only via cargo
• Performance characteristics compared to the original Python clvm_tools implementation

Package facts

Evidence: clvm_tools_rs-0.4.0-cp39-abi3-macosx_13_0_arm64.whl; clvm_tools_rs-0.4.0-cp39-abi3-macosx_13_0_x86_64.whl; clvm_tools_rs-0.4.0-cp39-abi3-manylinux_2_28_aarch64.whl; clvm_tools_rs-0.4.0-cp39-abi3-manylinux_2_28_x86_64.whl; clvm_tools_rs-0.4.0-cp39-abi3-musllinux_1_1_x86_64.whl; clvm_tools_rs-0.4.0-cp39-abi3-win_amd64.whl

Keywords: chia, chialisp, clvm

Tags

More Build Tools packages