PyEnsembl
PyEnsembl queries Ensembl genes, transcripts, exons and sequences from local indexes. It supports numbered releases, dated new-platform annotations and custom matched GTF/FASTA files.
Installation
Use Python 3.9 or later. Install the package and one explicit annotation:
python -m pip install pyensembl
pyensembl install --release 93 --species human
This selects human GRCh38 and downloads and indexes its annotation, transcript and peptide files. Setup takes several minutes and disk space; whole-genome DNA is optional. See installation and first lookup.
Example Usage
After installing the data above:
from pyensembl import EnsemblRelease
with EnsemblRelease(93, species="human") as data:
gene = data.gene_by_id("ENSG00000141510")
print(gene.name, gene.contig, gene.start, gene.end, gene.strand)
TP53 17 7661779 7687550 -
Coordinates are one-based and inclusive; TP53 is on the minus strand. The tutorial continues with a selected transcript and explains identifiers, versions and sequence lengths. Pin an annotation version: coordinates and sequences can differ between releases, and names may match several loci.
Usage tips
The documentation separates task guides and complete reference. Existing README anchors below lead to the corresponding guidance.
| Task | Guide |
|---|---|
| Choose an assembly, species and coverage | Assembly selection |
| Use dated Ensembl downloads | New platform |
| Load custom matched files | Custom genomes |
| Inspect data and cache readiness | Cached data |
| Load human or custom aliases | Alias lookup |
| Work with feature objects | Genes and transcripts |
| Read genomic intervals and manage DNA | Reference DNA |
| Find complete interfaces and lookup methods | API reference |
For contributions, see development setup,
documentation style and
releasing. Every PR includes a version bump, lint and
tests; maintainers merge through a PR and publish with ./deploy.sh from clean main.
5 maintainers
Metadata
5 maintainers
Release files for pyensembl 2.22.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pyensembl-2.22.1.tar.gz | 172.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pyensembl-2.22.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 266.3 kB
Release files / pyensembl-2.22.1.tar.gz
| Download URL | pyensembl-2.22.1.tar.gz |
|---|---|
| Size | 172.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
007c444cb4acb24a4717b0b0656d6a747c43a8b1425a8f822b4a17f5c8bbc54d
|
|
BLAKE2b-256 checksum How to use checksums |
1cc489450ca3690b4d71bfb48ab9b26b13f3d1670e38f96fd5a76d879d9e7260
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.6
|
Release files / pyensembl-2.22.1-py3-none-any.whl
| Download URL | pyensembl-2.22.1-py3-none-any.whl |
|---|---|
| Size | 93.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f5f88fbff873b305f73b7a8ebc38465072a34a5cbf46c510a00bb0cb1e73a72f
|
|
BLAKE2b-256 checksum How to use checksums |
f33e191a7b50073044b76919eec31a946ffc8fa8a5bf80742eb9458f0ab21e6f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.6
|
