geofetch is a command-line tool that downloads sequencing data and metadata from GEO and SRA and create metadata tables in standard PEP format. geofetch is hosted at pypi. You can convert the result of geofetch into unmapped bam or fastq files with the included sraconvert command.
Key geofetch features:
- Works with GEO and SRA metadata
- Combines samples from different projects
- Standardizes output metadata
- Filters type and size of processed files (from GEO) before downloading them
- Easy to use
- Fast execution time
- Can search GEO to find relevant data
- Can be used either as a command-line tool or from within Python using an API
Docs
Documentation: https://pep.databio.org/geofetch/
Source Code: https://github.com/pepkit/geofetch/
Installation
To install geofetch use this command:
pip install geofetch
or install the latest version from the GitHub repository:
pip install git+https://github.com/pepkit/geofetch.git
All GEO projects (GSE + GSM) in PEP format.
All GEO projects are available in PEPhub under geo namespace: https://pephub.databio.org/geo/ . User can search for GEO projects using the search bar, or download archive with all GEO PEPs from archive section of the namespace: https://pephub.databio.org/geo?view=archive
How to cite:
https://doi.org/10.1093/bioinformatics/btad069
@article{10.1093/bioinformatics/btad069,
author = {Khoroshevskyi, Oleksandr and LeRoy, Nathan and Reuter, Vincent P and Sheffield, Nathan C},
title = "{GEOfetch: a command-line tool for downloading data and standardized metadata from GEO and SRA}",
journal = {Bioinformatics},
volume = {39},
number = {3},
pages = {btad069},
year = {2023},
month = {03},
abstract = "{The Gene Expression Omnibus has become an important source of biological data for secondary analysis. However, there is no simple, programmatic way to download data and metadata from Gene Expression Omnibus (GEO) in a standardized annotation format.To address this, we present GEOfetch—a command-line tool that downloads and organizes data and metadata from GEO and SRA. GEOfetch formats the downloaded metadata as a Portable Encapsulated Project, providing universal format for the reanalysis of public data.GEOfetch is available on Bioconda and the Python Package Index (PyPI).}",
issn = {1367-4811},
doi = {10.1093/bioinformatics/btad069},
url = {https://doi.org/10.1093/bioinformatics/btad069},
eprint = {https://academic.oup.com/bioinformatics/article-pdf/39/3/btad069/49407404/btad069.pdf},
}
3 maintainers
Release files for geofetch 0.12.11
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| geofetch-0.12.11.tar.gz | 37.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| geofetch-0.12.11-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 79.9 kB
Release files / geofetch-0.12.11.tar.gz
| Download URL | geofetch-0.12.11.tar.gz |
|---|---|
| Size | 37.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7a32b15ae87d654e33969333334ce8f0070f6b3663d1461a70b40fb7d7bd0422
|
|
BLAKE2b-256 checksum How to use checksums |
492426676d0d01be39ba5127c6c4e6001c0a7be38602a9e5b53e1ce500fbe17c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Mar 25, 2026.
Transparency logRelease files / geofetch-0.12.11-py3-none-any.whl
| Download URL | geofetch-0.12.11-py3-none-any.whl |
|---|---|
| Size | 42.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
934fbf806af3062e97f75957b5d06cb980583354868f41edf60a8da3f3d455ce
|
|
BLAKE2b-256 checksum How to use checksums |
7cd3129768e3f9a2487b01426d44b6849529f278429a7c2ad3af942257f2ab75
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Mar 25, 2026.
Transparency log
