Skip to main content

WILDkCAT

pypi stable documentation

WILDkCAT is a set of scripts designed to extract, retrieve, and predict enzyme turnover numbers (kcat) for genome-scale metabolic models.


WILDkCAT produces a .tsv file with the retrieved and predicted kcat values for each combination of enzyme, substrates in your genome-scale metabolic model. Each step of the pipeline also generates an HTML report that provides detailed information about the retrieval process to facilitate transparency and reproducibility. The HTML reports are generated automatically after each stage of the workflow (extraction, retrieval, prediction) and can be opened directly in any web browser.

WILDkCAT Report Demo

Access the report here

Installation

Install WILDkCAT directly from PyPI:

pip install wildkcat

Environment Setup

Provide your BRENDA login credentials and Entrez API email adress to query the BRENDA enzyme database and NCBI database.

Create a file named .env in the root of your project with the following content:

ENTREZ_EMAIL=your_registered_email@example.com
BRENDA_EMAIL=your_registered_email@example.com
BRENDA_PASSWORD=your_password

Usage

WILDkCAT can be used as scripts or via the CLI.

Command-Line Interface (CLI)

After installation, you can use the WILDkCAT CLI:

wildkcat --help

Example Workflow:

# Extract kcat data
wildkcat extraction \
    path/to/my_model.json \
    path/to/folder_output

# Retrieve kcat values from databases
wildkcat retrieval \
    path/to/folder_output
    'Organism name' \
    20 30 \  # Temperature range
    6.5 8.5 \  # pH range

# Generate input for CataPro
wildkcat prediction-part1 \
    path/to/folder_output
    9  # Limit penalty score 

# Integrate CataPro prediction
wildkcat prediction-part2 \
    path/to/folder_output
    prediction_output.csv \
    9  # Limit penalty score

# Generate summary report
wildkcat report \
    path/to/my_model.json \
    path/to/folder_output

Programatic Access

from wildkcat import run_extraction, run_retrieval, run_prediction_part1, run_prediction_part2, generate_summary_report

Example: E. coli Core Model

A ready-to-run example is available here. It demonstrates a full extraction, retrieval, and prediction workflow on the E. coli core model.


Key scripts

extract_kcat.py

  • Identify all enyme-reaction combination in the model
  • Verify if EC numbers are valid (incomplete or transferred via KEGG)
  • If multiple enzymes are provided, searches UniProt for catalytic activity.

retrieve_kcat.py

  • If the same enzyme is not found, computes identity percentages relative to the identified catalytic enzyme.
  • Applies Arrhenius correction to values within the appropriate pH range.
  • For rows with multiple scores, selects:
    • The best score
    • The highest identity percentage
    • The closest organism (if sequence is not available)
    • The highest kcat value

predict_kcat.py

  • Predict kcat values not retrieved in experimental databases using machine learning.

cf. Refer to the documentation for a more detailed explanation.


Feedback & Improvements

Contributions, suggestions, and feedback are very welcome! If you encounter any issues, have ideas for new features, or notice room for improvement, feel free to open an issue or submit a pull request.

Cite us

If you use WILDkCAT in your research, please cite:

Escoffier H, Linster CL, Sauter T. WILDkCAT: extract, retrieve, and predict enzyme turnover numbers of constraint-based metabolic models. Bioinformatics (2026). https://doi.org/10.1093/bioinformatics/btag510

Metadata

Release files for wildkcat 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for wildkcat 0.3.1
File Size Uploaded
wildkcat-0.3.1.tar.gz 96.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for wildkcat 0.3.1
File Interpreter ABI Platform
wildkcat-0.3.1-py3-none-any.whl Python 3 none any Details

Total release size: 145.9 kB

Release files / wildkcat-0.3.1.tar.gz

Download URL wildkcat-0.3.1.tar.gz
Size 96.0 kB
Tags Source
SHA-256 checksum
How to use checksums
b856f54e65546e2f690b66eb5cd1151379ea74c69ad7720662322c080222c40a
BLAKE2b-256 checksum
How to use checksums
7c32f114529cdd314a2234d8808f9f7db7d320552ca6f14e59c0db3af64c0d00
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / wildkcat-0.3.1-py3-none-any.whl

Download URL wildkcat-0.3.1-py3-none-any.whl
Size 49.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5305251f08fd5ed08515c305d70eaf0baced1b4ed7fa589868fb3e4cbb99311e
BLAKE2b-256 checksum
How to use checksums
9f3d44c4bc04582b5cb713955b2b282a0b5cad8b4cb5a19b77e2328f8af74785
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

This release

0.3.1 This release

2 release files

0.3.0

2 release files

0.2.3

2 release files

0.2.0

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

0.0.26

2 release files

0.0.25

2 release files

0.0.24

2 release files

0.0.18

2 release files

0.0.17

2 release files

0.0.16

2 release files

0.0.15

2 release files

0.0.14

2 release files

0.0.12

2 release files

0.0.11

2 release files

0.0.10

2 release files

0.0.9

2 release files

0.0.8

2 release files

0.0.7

2 release files

0.0.5

2 release files

0.0.3

2 release files

0.0.2

1 release file

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page