MCPcopy Index your code
hub / github.com/JLSteenwyk/ClipKIT

github.com/JLSteenwyk/ClipKIT @v2.12.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v2.12.0 ↗ · + Follow
530 symbols 2,031 edges 71 files 139 documented · 26% updated 16d agov2.12.0 · 2026-03-31★ 902 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Logo

<a href="https://jlsteenwyk.com/ClipKIT/">Docs</a>
·
<a href="https://github.com/jlsteenwyk/clipkit/issues">Report Bug</a>
·
<a href="https://github.com/jlsteenwyk/clipkit/issues">Request Feature</a>






    <a href="https://github.com/JLSteenwyk/ClipKIT/actions" alt="Build">
        <img src="https://img.shields.io/github/actions/workflow/status/JLSteenwyk/ClipKIT/ci.yml?branch=master">
    </a>
    <a href="https://codecov.io/gh/jlsteenwyk/clipkit" alt="Coverage">
      <img src="https://codecov.io/gh/jlsteenwyk/clipkit/branch/master/graph/badge.svg?token=0J49I6441V">
    </a>
    <a href="https://github.com/JLSteenwyk/ClipKIT/graphs/contributors" alt="Contributors">
        <img src="https://img.shields.io/github/contributors/JLSteenwyk/ClipKIT">
    </a>
    <a href="https://bsky.app/profile/jlsteenwyk.bsky.social" target="_blank" rel="noopener noreferrer">
      <img src="https://img.shields.io/badge/Bluesky-0285FF?logo=bluesky&logoColor=fff">
    </a>



    <a href="https://pepy.tech/badge/clipkit">
      <img src="https://static.pepy.tech/personalized-badge/clipkit?period=total&units=international_system&left_color=grey&right_color=blue&left_text=PyPi%20Downloads">
    </a>
    <a href="https://anaconda.org/bioconda/clipkit">
      <img src="https://img.shields.io/conda/dn/bioconda/clipkit?label=bioconda%20downloads" alt="Bioconda Downloads">
    </a>
    <a href="https://lbesson.mit-license.org/" alt="License">
        <img src="https://img.shields.io/badge/License-MIT-blue.svg">
    </a>



    <a href="https://pypi.org/project/clipkit/" alt="PyPI - Python Version">
        <img src="https://img.shields.io/pypi/pyversions/clipkit">
    </a>
    <a href="https://journals.plos.org/plosbiology/article?id=10.1371/journal.pbio.3001007">
      <img src="https://zenodo.org/badge/DOI/10.1371/journal.pbio.3001007.svg">  
    </a>

Run ClipKIT in the browser and leave the computing up to us!

ClipKIT is a fast and flexible alignment trimming tool that keeps phylogenetically informative sites and removes others.

If you found ClipKIT useful, please cite ClipKIT: a multiple sequence alignment trimming software for accurate phylogenomic inference. Steenwyk et al. 2020, PLOS Biology. doi: 10.1371/journal.pbio.3001007.


This documentation covers downloading and installing ClipKIT. Details about each function as well as tutorials for using ClipKIT are available in the online documentation. Release automation details are documented in RELEASE.md.

Quick Start

# install
pip install clipkit
# run
clipkit input.fa

eComp archives

ClipKIT can trim Evolutionary Compression (.ecomp) archives directly. Simply pass the .ecomp file to the CLI, and ClipKIT will unpack its metadata sidecar and native payload before trimming the alignment. Archives encoded with zstd require the optional zstandard module; all other payload encodings work out of the box. By default the trimmed alignment is written back as an .ecomp archive (with a gzip fallback payload); specify -of fasta if you prefer a text format.

Installation

If you are having trouble installing ClipKIT, please contact the lead developer, Jacob L. Steenwyk, via email or twitter to get help.

To install using pip, we strongly recommend building a virtual environment to avoid software dependency issues. To do so, execute the following commands:

# create virtual environment
python -m venv venv
# activate virtual environment
source venv/bin/activate
# install clipkit
pip install clipkit

Note: the virtual environment must be activated to use clipkit.

After using ClipKIT, you may wish to deactivate your virtual environment and can do so using the following command:

# deactivate virtual environment
deactivate

Similarly, to install from source, we strongly recommend using a virtual environment. To do so, use the following commands:

# download
git clone https://github.com/JLSteenwyk/ClipKIT.git
cd ClipKIT/
# create virtual environment
python -m venv venv
# activate virtual environment
source venv/bin/activate
# install
make install

To deactivate your virtual environment, use the following command:

# deactivate virtual environment
deactivate

Note: the virtual environment must be activated to use clipkit.

To install via anaconda, execute the following command:

conda install bioconda::clipkit

Visit here for more information: https://anaconda.org/bioconda/clipkit

Core symbols most depended-on inside this repo

execute
called by 117
clipkit/clipkit.py
process_args
called by 38
clipkit/args_processing.py
decode_blocks
called by 23
clipkit/ecomp/reader.py
_decompress_alignment
called by 17
clipkit/ecomp/reader.py
_pack_codes
called by 14
clipkit/ecomp/reader.py
_decode_sequence_ids
called by 14
clipkit/ecomp/reader.py
clipkit
called by 13
clipkit/api.py
from_bio_msa
called by 12
clipkit/msa.py

Shape

Method 354
Function 115
Class 60
Route 1

Languages

Python100%

Modules by API surface

tests/unit/ecomp/test_reader.py142 symbols
tests/unit/test_args_parsing.py39 symbols
clipkit/msa.py36 symbols
clipkit/ecomp/reader.py25 symbols
tests/integration/test_writing_to_different_output_file_formats.py14 symbols
tests/integration/test_kpi_gappy_mode.py14 symbols
tests/integration/test_gappy_mode.py14 symbols
tests/unit/test_msa.py12 symbols
tests/unit/test_parser.py11 symbols
tests/integration/test_api.py11 symbols
tests/unit/test_files.py10 symbols
tests/integration/test_smart_gap_mode.py9 symbols

For agents

$ claude mcp add ClipKIT \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page