Install & Compatibility
Where this runs
tested against v0.4.5 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
py 3.9
✕ build_error
✕ build_error
19MB installed
● package 19MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
assemble
✓ from chialisp import assemble
✗ from chialisp import assemble
compile
✓ from chialisp import compile
disassemble
✓ from chialisp import disassemble
This quickstart demonstrates the core functionality of `chialisp` for assembling Chialisp source code into CLVM byte representations and disassembling CLVM bytes back into human-readable Chialisp. It uses the `assemble` and `disassembler` functions from `chialisp.clvm_tools.binutils`.
from chialisp.clvm_tools.binutils import assemble, disassembler
# Chialisp source code
chialisp_source = "(a (q 2 2) (q 1 3))"
# 1. Assemble Chialisp source into a CLVM program (bytes)
print(f"Original Chialisp source: {chialisp_source}")
assembled_program = assemble(chialisp_source)
print(f"Assembled CLVM program (bytes): {assembled_program.hex()}")
# 2. Disassemble a CLVM program back into Chialisp source (approximate)
disassembled_source = disassembler(assembled_program)
print(f"Disassembled Chialisp source: {disassembled_source}")
# Example with a slightly more complex structure
complex_source = "(a (q . 1) (q (a (q 2 2) (q 1 3)) (c (q 5) (q 1))))"
assembled_complex = assemble(complex_source)
print(f"\nComplex Chialisp source: {complex_source}")
print(f"Assembled complex program (bytes): {assembled_complex.hex()}")
print(f"Disassembled complex program: {disassembler(assembled_complex)}")
chia --version
Debug
Known issues
gotchaInstallation may fail if pre-compiled wheels for the `clvm_tools_rs` dependency are not available for your platform and a Rust toolchain is not installed on your system.fixEnsure you have a Rust toolchain (compiler and Cargo) installed before attempting to `pip install chialisp`. Refer to `rustup.rs` for installation instructions.
affects: 0.4.0+
gotchaThe interpretation and compilation of Chialisp programs can change between versions due to updates in the underlying CLVM specification or compiler logic.fixAlways test Chialisp programs with the specific `chialisp` library version intended for deployment. Consult Chia-Network documentation for CLVM specification changes.
affects: All versions, especially across major `chialisp` or `clvm_tools_rs` updates.
gotchaWhile `chialisp` depends on `clvm_tools_rs`, its core functionalities are exposed through the `chialisp.clvm_tools` namespace. Direct imports from `clvm_tools_rs` are generally not intended for external use and may lead to unexpected behavior or API instability.fixAlways import compiler and assembly utilities from `chialisp.clvm_tools` (e.g., `from chialisp.clvm_tools.binutils import assemble`).
affects: 0.4.0+
Upgrade
Version history
0.4.5latest on PyPI · released May 8, 2026
Audit
Dependencies
clvm_tools_rsrequiredProvides core CLVM compilation, assembly, and disassembly functionality, implemented in Rust for performance. This package is a wrapper around it.