cogent3 is a mature python library for analysis of genomic sequence data. We endeavour to provide a first-class experience within Jupyter notebooks, but the algorithms also support parallel execution on compute systems with 1000's of processors. A plugin system enables custom extensions to expand the library capabilities. See the cogent3 docs for more detail.
Who is it for?
Anyone who wants to analyse sequence divergence using robust statistical models
cogent3 is unique in providing numerous non-stationary Markov models for modelling sequence evolution, including codon models. cogent3 also includes an extensive collection of time-reversible models (again including novel codon models). We have done more than just invent these new methods, we have established the most robust algorithms for their implementation and their suitability for real data. Additionally, there are novel signal processing methods focussed on statistical estimation of integer period signals.
🎬 Demo non-reversible substitution model
Anyone who wants to undertake exploratory genomic data analysis
Beyond our novel methods, cogent3 provides an extensive suite of capabilities for manipulating and analysing sequence data. You can manipulate sequences by their annotations, e.g.
🎬 Demo sequences with annotations
Plus, you can read standard tabular and biological data formats, perform multiple sequence alignment using any cogent3 substitution models, phylogenetic reconstruction and tree manipulation, manipulation of tabular data, visualisation of phylogenies and much more.
Beginner friendly approach to genomic data analysis
Our cogent3.app module provides a very different approach to using the library capabilities. Expertise in structural programming concepts is not essential!
🎬 Demo friendly coding
Installation
For most users we recommend
$ pip install "cogent3[extra]"
which installs support for data visualisation (which requires Plotly) and extensions for jupyter notebooks.
Note: In order to write Plotly figures to static image files you will need to install Chrome.
Minimal installation
If you're running on a high-performance computing system we recommend
$ pip install cogent3
which skips the data visualisation and notebook support.
Install with developer tools
Everything we use for cogent3 development. Run this from a clone of the repository.
$ pip install -e . --group dev
Note: Installs all dependencies that can be installed using
pip.
Installing the development version
$ pip install git+https://github.com/cogent3/cogent3.git@develop#egg=cogent3
Warning: The interface can change without warning on the development branch.
Installing using conda / mamba
Activate your conda environment, then
(myenv) $ conda install bioconda::cogent3
Project Information
cogent3 is released under the BSD-3 license, documentation is at cogent3.org, while cogent3 code is on GitHub. If you would like to contribute (and we hope you do!), we have created a companion c3dev GitHub repo which provides details on how to contribute and some useful tools for doing so.
Project History
cogent3 is a descendant of PyCogent. While there is much in common with PyCogent, the amount of change has been substantial, motivating the name change to cogent3. This name has been chosen because cogent was always the import name (dating back to PyEvolve in 2004) and it's Python 3 only.
Given this history, we are grateful to the multitude of individuals who have made contributions over the years. Many of these contributors were also co-authors on the original PyEvolve and PyCogent publications. Individual contributions can be seen by using "view git blame" on individual lines of code on GitHub, through git log in the terminal, and more recently the changelog.
Funding
Cogent3 has received funding support from the Australian National University and an Essential Open Source Software for Science Grant from the Chan Zuckerberg Initiative.
3 maintainers
Release files for cogent3 2026.9.10
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cogent3-2026.9.10.tar.gz | 17.2 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cogent3-2026.9.10-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 17.9 MB
Release files / cogent3-2026.9.10.tar.gz
| Download URL | cogent3-2026.9.10.tar.gz |
|---|---|
| Size | 17.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4d86b31ad6e00c7420cfd8fd5d5a716035ace8ac594c4de6289049ac4205d772
|
|
BLAKE2b-256 checksum How to use checksums |
39833deceb17d63dbcc30457a7a26ad9c9f77cc5b129c3c0de5d6ecce05541a6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 10, 2026.
Transparency logRelease files / cogent3-2026.9.10-py3-none-any.whl
| Download URL | cogent3-2026.9.10-py3-none-any.whl |
|---|---|
| Size | 695.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ef548a47460e2c68681101246ba393cd3e30f03ede9058d62ebd784c546c30a1
|
|
BLAKE2b-256 checksum How to use checksums |
234042405c2c05b597fca7f4e1fea8fd556ff63cdbe02e0b27da65f6c2e735ac
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 10, 2026.
Transparency log
