fp-tools-bio

Pre-release

This release is a pre-release and may not be stable for production use.

fp-tools — regulatory footprinting

Documentation · Output demo with ENCODE cancer cell lines · GUI demo · PyPI

fp-tools is a command-first toolkit for footprinting Tn5-based chromatin profiling data, including ATAC-seq, CUT&Tag, and related assays. It provides bias correction, motif analysis, replicate-aware comparisons, and single-cell footprint signatures. The GUI and YAML runner call the same commands.

Install

Choose one route:

Route	Best for	Start
Desktop app	Windows or Apple Silicon macOS	Download
Python package	Windows, macOS, or Linux with Python 3.11–3.13	`python -m pip install fp-tools-bio`
Container	Complete reproducible environment	`docker build -t fp-tools:latest https://github.com/oncologylab/fp-tools.git#main`

Python package example:

python -m pip install --pre fp-tools-bio
fp-tools-gui

Optional de novo motif tools are downloaded into a private, versioned cache on first use. Docker remains an optional reproducible backend.

Bulk ATAC-seq

bulk-footprinting runs from coordinate-sorted BAM/BAI files and matching peak BED files through the final interactive comparison report.

bulk-footprinting \
  --sample-table samples.tsv \
  --comparison-table comparisons.tsv \
  --genome hg38.fa.gz \
  --outdir project \
  --cores 8

The wrapper runs atac-correct, call-footprints, match-motifs, diff-footprints, and review-multi-comparisons. Each command can also be run directly. diff-footprints --comparison-axis regions compares matched genomic region sets within one sample or across biological replicates.

FASTQ-to-BAM preparation is available through prepare-atac on the Linux CLI and in the Linux container. The GUI and native macOS/Windows installations start from BAM/BAI and peak BED files.

Single-cell ATAC-seq

sc-footprinting groups fragments, runs pseudobulk footprinting, and produces per-cell KNN footprint-signature heatmaps and UMAPs.

sc-footprinting \
  --fragments fragments.tsv.gz \
  --annotations cell_annotations.tsv \
  --h5ad embedding.h5ad \
  --group-by cell_type \
  --genome-sizes hg38.chrom.sizes \
  --genome hg38.fa.gz \
  --peaks merged_peaks.bed \
  --outdir project/single_cell

Main commands

Area	Commands
Core analysis	`atac-correct`, `call-footprints`, `match-motifs`, `diff-footprints`, `normalize-bigwig`
Linux preprocessing	`prepare-atac`
Workflows	`bulk-footprinting`, `sc-footprinting`, `run-yaml-workflow`, `fp-tools-gui`, `fp-tools-runtime`
Reports	`plot-aggregate`, `review-multi-comparisons`
De novo motifs	`discover-motifs`, `summarize-motifs`
Single-cell utilities	`pseudobulk-fragments`, `find-signature-fp`

Use <command> --help for complete options. Practical examples and the API reference are available in the documentation.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fp_tools_bio-0.2.0rc7.tar.gz (1.5 MB view details)

Uploaded Aug 20, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

fp_tools_bio-0.2.0rc7-cp313-cp313-win_amd64.whl (1.7 MB view details)

Uploaded Aug 20, 2026 CPython 3.13Windows x86-64

fp_tools_bio-0.2.0rc7-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (3.0 MB view details)

Uploaded Aug 20, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

fp_tools_bio-0.2.0rc7-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl (3.0 MB view details)

Uploaded Aug 20, 2026 CPython 3.13manylinux: glibc 2.17+ ARM64manylinux: glibc 2.28+ ARM64

fp_tools_bio-0.2.0rc7-cp313-cp313-macosx_11_0_x86_64.whl (1.7 MB view details)

Uploaded Aug 20, 2026 CPython 3.13macOS 11.0+ x86-64

fp_tools_bio-0.2.0rc7-cp313-cp313-macosx_11_0_arm64.whl (1.7 MB view details)

Uploaded Aug 20, 2026 CPython 3.13macOS 11.0+ ARM64

fp_tools_bio-0.2.0rc7-cp312-cp312-win_amd64.whl (1.7 MB view details)

Uploaded Aug 20, 2026 CPython 3.12Windows x86-64

fp_tools_bio-0.2.0rc7-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (3.0 MB view details)

Uploaded Aug 20, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

fp_tools_bio-0.2.0rc7-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl (3.0 MB view details)

Uploaded Aug 20, 2026 CPython 3.12manylinux: glibc 2.17+ ARM64manylinux: glibc 2.28+ ARM64

fp_tools_bio-0.2.0rc7-cp312-cp312-macosx_11_0_x86_64.whl (1.7 MB view details)

Uploaded Aug 20, 2026 CPython 3.12macOS 11.0+ x86-64

fp_tools_bio-0.2.0rc7-cp312-cp312-macosx_11_0_arm64.whl (1.7 MB view details)

Uploaded Aug 20, 2026 CPython 3.12macOS 11.0+ ARM64

fp_tools_bio-0.2.0rc7-cp311-cp311-win_amd64.whl (1.7 MB view details)

Uploaded Aug 20, 2026 CPython 3.11Windows x86-64

fp_tools_bio-0.2.0rc7-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (3.0 MB view details)

Uploaded Aug 20, 2026 CPython 3.11manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

fp_tools_bio-0.2.0rc7-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl (3.0 MB view details)

Uploaded Aug 20, 2026 CPython 3.11manylinux: glibc 2.17+ ARM64manylinux: glibc 2.28+ ARM64

fp_tools_bio-0.2.0rc7-cp311-cp311-macosx_11_0_x86_64.whl (1.7 MB view details)

Uploaded Aug 20, 2026 CPython 3.11macOS 11.0+ x86-64

fp_tools_bio-0.2.0rc7-cp311-cp311-macosx_11_0_arm64.whl (1.7 MB view details)

Uploaded Aug 20, 2026 CPython 3.11macOS 11.0+ ARM64

File details

Details for the file fp_tools_bio-0.2.0rc7.tar.gz.

File metadata

Download URL: fp_tools_bio-0.2.0rc7.tar.gz
Upload date: Aug 20, 2026
Size: 1.5 MB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.12.14

File hashes

Hashes for fp_tools_bio-0.2.0rc7.tar.gz
Algorithm	Hash digest
SHA256	`0811fe5c04a613548d7dc66336b1a3aa4e58cffb41eb12dca631d9198140d99e`
MD5	`b5567e0f074541762a693f80351e6be5`
BLAKE2b-256	`df9ad16f0836a609fe906bbfbd4e80cee324899b685a3a687aef109d5db0acaf`

Algorithm	Hash digest
SHA256	`f2559131c7630ca4c5def8da5793e1e6bb8ba85e7c000b8e784d36b5cd8c1da6`
MD5	`03cd97f9694a266f82cfb16064946ef2`
BLAKE2b-256	`c0353461a8759a0bfb10b87725ae60d323417668e75aad06847685bf1f505a0c`

Algorithm	Hash digest
SHA256	`62157161d5d7d4eefb71a1bd9906b57b817b8396fcaff61ac12ab8334dd26543`
MD5	`5261b6b2c7dede2102b3774cc7d757d7`
BLAKE2b-256	`7b0c29e3e937d330ca3968adc00000e42fa89f6812d3150c08c3c165b8efee17`

Algorithm	Hash digest
SHA256	`da8a0c91b378a7921a47f2b47230eaf839ca086080953d48f6fc48299e0603ed`
MD5	`641c81115bfb77ef959ceb12fe2b24c1`
BLAKE2b-256	`5a3bfc6842bd70f5d21075d2f4ecc10e8a63af3c4c6e24b6fecb413ee898cfff`

Algorithm	Hash digest
SHA256	`1c1b2ccfefab994673105659719e80f27c95cdba22d46c09bdaf6d36f4cca08a`
MD5	`91875d45eea64e848207360af2093391`
BLAKE2b-256	`71afa8a2976b0faf55dd8d66dd52b81cd6aa1af3a337dc1813ccfa72e3a80d3a`

Algorithm	Hash digest
SHA256	`743f969ba45055e1841e75b5c312811de83cdaf23be399d7e170eab5fe872c95`
MD5	`3039c1dc09afd7d1cc2db942bbfcad00`
BLAKE2b-256	`7d5853d83bc63ac9646d3a5d91d593d7124109c4b2317849d846858562ccecee`

Algorithm	Hash digest
SHA256	`783d2ad9db5a8fb1955e5f45c35fe9765715b5ff8c07c0cf73689afa34dbb389`
MD5	`524e3ab96957dd3ddd15164f431843df`
BLAKE2b-256	`b2e63652c59b94916fdbfec34b11e1efb3a348f3d7d1047e5a8653e6fdca3274`

Algorithm	Hash digest
SHA256	`8af745bb21582928ce4076b97dcda500e3ac1943e4d2356b8f87fe2921855b39`
MD5	`ad60264bfc240193f348df27e401c8bf`
BLAKE2b-256	`403bd0f5cedd4c0e2712e012f4e150fdbc5f2f603a198fb10a5a44eb44c0a3e4`

Algorithm	Hash digest
SHA256	`f416108deec9e78b2e7739d569a0a6ff29ddcae595b7aabfcf284d1b51126e8e`
MD5	`31dc2d3611859465c09d8c7c30303247`
BLAKE2b-256	`96b6c4ace8aa47d7d8b32111207249e71ba5aebda4a6e2864593d229ca9744e5`

Algorithm	Hash digest
SHA256	`4fb1ad9f0c625c8f0ab90e21d9e15e32ab95b29082a75e1a2c1dec4491c0eade`
MD5	`57fcba5bf3e7438a14cd541061d27033`
BLAKE2b-256	`45f12e5f20f64ffda3853c0d1fd4e567c6dd204c45e148e75afdcaf511474554`

Algorithm	Hash digest
SHA256	`0a19ccea843bfc71fa1b2e42bcf5871146e58674dba1c01141ed111e1126ebcb`
MD5	`4a09af9139713b5e68bf6af1be52f891`
BLAKE2b-256	`c5173b7d58b2354d97feb7eb429e72958a926d2b18d008de365001c33d4eced5`

Algorithm	Hash digest
SHA256	`49c6aea8559ea2f100f10bd9545da2fc28d05f07d5e2551014e0c670b28f6a30`
MD5	`c354582d72513a4fb838e26b754a83d0`
BLAKE2b-256	`97a32f931dff59a968246f3443ce6be8fde341b858fe8d3473e57761bc35af10`

Algorithm	Hash digest
SHA256	`8356beef983c0cea8b8032f0e3e1676aa2f5f9e6711106f1b24a09f1121bdbd1`
MD5	`80406ed42d14e239c3c0e3f3bda95c0f`
BLAKE2b-256	`3987202a8f97bd955353f161c24844594c7d20d6e5dbae8d484da1d611bf2c0d`

Algorithm	Hash digest
SHA256	`4363021d721790ee68adad44b339449a8d93ec88e68c8fa832b336fd66a1412e`
MD5	`bcb725f527b46577dfae017ceb64b161`
BLAKE2b-256	`7a1c5fff7bef908b2c75e31d619ba0251b65df15c4eed3fed83654dd4f018455`

Algorithm	Hash digest
SHA256	`a4b2f0fe4c11dbe4f50577e2fc6072cd7e08f2e4718bf559d9f450a70f90dc94`
MD5	`08c377e57cbd2489a3632e3832faee5c`
BLAKE2b-256	`f9876ee21ffdeaa74ecb560da74b7ef7f7d567e927d2c906f70ec0570021c1c3`

Algorithm	Hash digest
SHA256	`4366141ad0b4a3397ae8b7f2b2d3a569fbd8776c5cdce374c400c0ccf978cad1`
MD5	`7b55cdf806f1e22faf34c97d9580fd1d`
BLAKE2b-256	`5159660994d489e4da295b615053e00a274e4e029166244357a8a06b4bcbb224`

fp-tools-bio 0.2.0rc7

Install

Bulk ATAC-seq

Single-cell ATAC-seq

Main commands

Project links

Key dates

1 maintainer

Credits

License expression

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

Release history Release notifications | RSS feed