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 executable	GUI without Python	Download for Windows, macOS, or Linux
Complete container	GUI plus raw-read and motif-discovery programs	`docker run --rm -p 8891:8891 ghcr.io/oncologylab/fp-tools:latest`
Python package	Direct commands in an existing Python environment	`python -m pip install fp-tools-bio`

Python package example:

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

Python 3.11–3.13 is supported on Windows, macOS, and Linux. The container is the complete environment for raw FASTQ processing and external MEME tools.

Bulk ATAC-seq

bulk-footprinting runs the complete analysis from aligned BAM and peak files. FASTQ preparation remains available separately through prepare-atac.

bulk-footprinting \
  --sample-table samples.tsv \
  --comparison-table comparisons.tsv \
  --genome hg38.fa.gz \
  --blacklist hg38.blacklist.bed \
  --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.

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	`prepare-atac`, `atac-correct`, `call-footprints`, `match-motifs`, `diff-footprints`, `normalize-bigwig`
Workflows	`bulk-footprinting`, `sc-footprinting`, `run-yaml-workflow`, `fp-tools-gui`
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.0rc3.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.0rc3-cp313-cp313-win_amd64.whl (1.6 MB view details)

Uploaded Aug 20, 2026 CPython 3.13Windows x86-64

fp_tools_bio-0.2.0rc3-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.0rc3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl (2.9 MB view details)

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

fp_tools_bio-0.2.0rc3-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.0rc3-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.0rc3-cp312-cp312-win_amd64.whl (1.6 MB view details)

Uploaded Aug 20, 2026 CPython 3.12Windows x86-64

fp_tools_bio-0.2.0rc3-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.0rc3-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.0rc3-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.0rc3-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.0rc3-cp311-cp311-win_amd64.whl (1.7 MB view details)

Uploaded Aug 20, 2026 CPython 3.11Windows x86-64

fp_tools_bio-0.2.0rc3-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.0rc3-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.0rc3-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.0rc3-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.0rc3.tar.gz.

File metadata

Download URL: fp_tools_bio-0.2.0rc3.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.13

File hashes

Hashes for fp_tools_bio-0.2.0rc3.tar.gz
Algorithm	Hash digest
SHA256	`580095e5a39c5344004dda201ae5bd759f66cc4d7f27606281e842b9da2fd2f9`
MD5	`0cfe53d5ff53e65727c8e56b905cf9aa`
BLAKE2b-256	`1cea502c0aff8620c49511bf8a90d596d4fd3d0416ded357463b2edfde33f1a9`

Algorithm	Hash digest
SHA256	`6efd45d25b90f658c58365dc6b531b008c9c1eef51c1002532e6ff566bab817f`
MD5	`f2e9913d5d1cf382fc08a2c3a0a03098`
BLAKE2b-256	`74d9144694ed1cb1203fd3176fe3dc411ee67218cf8a60d8589307b2ac8dc23c`

Algorithm	Hash digest
SHA256	`39bb58e67d6d65ff79deee53a5ee5e1d84415e8e0fe5a469cb622c75f45f6391`
MD5	`db8147639bb8f4520d749cfa41cddb89`
BLAKE2b-256	`cf9c0484e68cfee39d2a77f534680e4473e0cecb74f69fa3e167facc116473ee`

Algorithm	Hash digest
SHA256	`5a30a623b63c8499cfaa230f29754816286edd95bf53fee34114aea04ff2d66f`
MD5	`8a753c102864dece0f1237f86774b3c5`
BLAKE2b-256	`59daab2850fad2c767f47cac01303c90bb67c17eaae3ecc656b4019c5fde1c66`

Algorithm	Hash digest
SHA256	`688e34969b478cfaf937066b07aa547b2157e632388c3f24c4ee11b54b6136aa`
MD5	`acec819adb8fd927e35d687e1d86e087`
BLAKE2b-256	`41dadf19a87bc1b9ebe0b497f4245b6dffda0bcc170698af13b0d06bef9115d4`

Algorithm	Hash digest
SHA256	`8305cbc7dfd48ec05f87c7ab1298ea48a0085582499508c8e8747cdf55150263`
MD5	`f5d35e347fbaad724d465ddeca3b922c`
BLAKE2b-256	`0c8dc68632a7123e5ca04ecde135d3b677a3d86e8af2d50c9a6f3d6dd9e6cc9e`

Algorithm	Hash digest
SHA256	`e2278ba4c862155dc06986e6818996730ea7e7fcc2bfee23280258f188f1b9d4`
MD5	`5062faaffd2a38b9d00217b25622ce89`
BLAKE2b-256	`4a6474183d153a48b212dbbeeb1d8ccaef79c103bd94ae55aa048207932a5424`

Algorithm	Hash digest
SHA256	`8c202ee99cd94405ab82ed41bdef46230926d055dd70879a626790fcca646b41`
MD5	`06ad27ee212785849215868be372b0c9`
BLAKE2b-256	`eca679019114ee07b577fb6bfb4c0f41028badb45e34c2d5611436c2f418add7`

Algorithm	Hash digest
SHA256	`4049c4884124e5f2a066ea9caa99c88207ac08b39bc0de869304bec3d6ef2e89`
MD5	`05e0c4cbb484a3f0d970cb17d8a816c8`
BLAKE2b-256	`365e35dcd4ed0086553fc06d5b316cbd96bab76211d3ae8d521b88f317c6e835`

Algorithm	Hash digest
SHA256	`d330764eafda58a612224191327e8ab1ff12a601e5f5f00b8f5f3728094e5165`
MD5	`f6f14f61fabf788fd0481bdbec63b7d5`
BLAKE2b-256	`f98f61f2a979ea46d34288446564acc5e5b12d6e59112b0858e216abfaae3a75`

Algorithm	Hash digest
SHA256	`95d312623da90ee4ad03d3360a75da92cbf42eed762e69eedac5f073e3846502`
MD5	`42dfa97f4fe4038bef230f53c2279055`
BLAKE2b-256	`33613714db8e3b231b9f96d08476331dc05118a0fffb445b85560ff4d99417a5`

Algorithm	Hash digest
SHA256	`aaf164786283634bbf402be1e71494f3e61525be0a786a01f7cfc9c656430f94`
MD5	`11b5967cb9d5dc15b4ea1f84642205d4`
BLAKE2b-256	`77c93a96de25cd5dd2dd5b6a6071d64309a1e4863f74937a9272aece42a2e593`

Algorithm	Hash digest
SHA256	`8f8525b4404fa69cd781a9cf2b48468165bb727c3f99715ce2fb9f70bda4010f`
MD5	`2bfa78f910c511b3e7751c392a8f43cc`
BLAKE2b-256	`0cc0d96d137f80ea1db29d9f259027de6dc74847f09ef5e8cc56426d12e54d94`

Algorithm	Hash digest
SHA256	`830b432f1acf45a1db8026f7dc8a6d961a5dd958e057650af81ae15c4010741a`
MD5	`182d52af50b0c5e6a262972a57ebf6f0`
BLAKE2b-256	`0f5193d008700d9d19f0c0d979814d6c53f853ba41433c3d5040dc1fe2ade2ed`

Algorithm	Hash digest
SHA256	`8374121cca082e654ece2d33014ec5bb8f310713885c6ff2bc6d385e2343fe43`
MD5	`b23240bea9a35198fbcc95b3a7d81162`
BLAKE2b-256	`d9a96567ba0eeaec51bb2ee8d2f592de434793387afc3842fe41c8db78f0ca7a`

Algorithm	Hash digest
SHA256	`1d677b357a7c9654aacf81e0f3e390ca3d6bee2dcaee7c1d608db2440d142842`
MD5	`f73745e54a23474f4c101f064d68a37c`
BLAKE2b-256	`856cba2a4d8df18957e6dbae9dc6467e72cf2cb2a154baf4bc5e9a13f46eac9b`

fp-tools-bio 0.2.0rc3

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