Attention

These docs have moved. The current simpleaf documentation lives at https://combine-lab.github.io/simpleaf and is the only version that is updated. This readthedocs site is a frozen snapshot of the 0.27.0 docs and will not track later releases.

Installation

Simpleaf can be installed from source, from crates.io, or installed via bioconda. simpleaf requires alevin-fry, piscem, and wget.

Recommended: installing from conda

We recommend that Linux and macOS users install simpleaf from bioconda, because all its dependencies are also available on conda, and will be automatically installed (except piscem) when installing simpleaf.

conda install simpleaf piscem -c bioconda -c conda-forge

Apple-silicon and ARM users need no special handling. bioconda ships native osx-arm64 and linux-aarch64 packages for simpleaf, piscem, and alevin-fry, so the command above works as-is in a native shell. Rosetta2 is not required, and installing under emulation is no longer recommended.

Installing with cargo

cargo is the rust package manager. simpleaf is available on crate.io and can be installed from cargo.

cargo install simpleaf

Once installed, one will need to set the path to the executable of dependencies using the simpleaf set-paths program as discussed in section Set Up Simpleaf manually.

Building from source (from GitHub)

You can also choose to build simpleaf from source by pulling its GitHub repo and build it as a normal rust program. Then, one needs to set up simpleaf manually.

git clone https://github.com/COMBINE-lab/simpleaf.git && cd simpleaf
cargo build --release