{"id":13704170,"url":"https://github.com/cokelaer/bioservices","last_synced_at":"2025-05-15T00:07:22.097Z","repository":{"id":20162333,"uuid":"23432970","full_name":"cokelaer/bioservices","owner":"cokelaer","description":"Access to Biological Web Services from Python. ","archived":false,"fork":false,"pushed_at":"2025-02-27T22:38:23.000Z","size":6099,"stargazers_count":296,"open_issues_count":15,"forks_count":63,"subscribers_count":17,"default_branch":"main","last_synced_at":"2025-04-13T21:33:58.561Z","etag":null,"topics":["biomodels","chebi","chembl","eutils","kegg","muscle","python","quickgo","unichem","uniprot","wikipathways"],"latest_commit_sha":null,"homepage":"http://bioservices.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cokelaer.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-08-28T15:24:45.000Z","updated_at":"2025-04-11T16:02:39.000Z","dependencies_parsed_at":"2023-01-13T20:48:59.812Z","dependency_job_id":"6629d9e7-c807-469a-9059-50b8939ae70b","html_url":"https://github.com/cokelaer/bioservices","commit_stats":{"total_commits":1151,"total_committers":30,"mean_commits":38.36666666666667,"dds":"0.10512597741094698","last_synced_commit":"f1c551d85a14fd95565bfc30c4ccfb3fe744892b"},"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cokelaer%2Fbioservices","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cokelaer%2Fbioservices/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cokelaer%2Fbioservices/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cokelaer%2Fbioservices/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cokelaer","download_url":"https://codeload.github.com/cokelaer/bioservices/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254249197,"owners_count":22039029,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["biomodels","chebi","chembl","eutils","kegg","muscle","python","quickgo","unichem","uniprot","wikipathways"],"created_at":"2024-08-02T21:01:05.146Z","updated_at":"2025-05-15T00:07:22.060Z","avatar_url":"https://github.com/cokelaer.png","language":"Python","funding_links":[],"categories":["Next Generation Sequencing"],"sub_categories":["Python Modules"],"readme":".. image:: https://raw.githubusercontent.com/cokelaer/bioservices/main/doc/_static/bioservices2_logo_256.png\n    :target: https://raw.githubusercontent.com/cokelaer/bioservices/main/doc/_static/bioservices2_logo_256.png\n\n\n#################################################################################\nBIOSERVICES: access to biological web services programmatically\n#################################################################################\n\n\n.. image:: https://badge.fury.io/py/bioservices.svg\n    :target: https://pypi.python.org/pypi/bioservices\n\n.. image:: https://github.com/cokelaer/bioservices/actions/workflows/ci.yml/badge.svg\n   :target: https://github.com/cokelaer/bioservices/actions/workflows/ci.yml\n\n.. image:: http://readthedocs.org/projects/bioservices/badge/?version=main\n    :target: http://bioservices.readthedocs.org/en/main/?badge=main\n    :alt: Documentation Status\n\n.. image:: https://static.pepy.tech/personalized-badge/bioservices?period=month\u0026units=international_system\u0026left_color=black\u0026right_color=orange\u0026left_text=Downloads\n    :target: https://pepy.tech/project/bioservices\n\n.. image:: https://anaconda.org/conda-forge/bioservices/badges/version.svg\n    :target: https://anaconda.org/conda-forge/bioservices\n\n\n|Codacy-Grade|\n\n\n\n:Python_version_available: BioServices is tested for Python 3.9, 3.10, 3.11, 3.12\n:Contributions: Please join https://github.com/cokelaer/bioservices\n:Issues: Please use https://github.com/cokelaer/bioservices/issues\n:How to cite: Cokelaer et al. *BioServices: a common Python package to access biological Web Services programmatically*\n     `Bioinformatics \u003chttp://bioinformatics.oxfordjournals.org/content/29/24/3241\u003e`_ (2013) 29 (24): 3241-3242\n:Documentation: `RTD documentation \u003chttp://bioservices.readthedocs.io/\u003e`_.\n\n**Bioservices** is a Python package that provides access to many Bioinformatices Web Services (e.g.,\nUniProt) and a framework to easily implement Web Services wrappers (based on\nWSDL/SOAP or REST protocols).\n\n\nThe primary goal of **BioServices** is to use Python as a glue language to provide\na programmatic access to several Bioinformatics Web Services. By doing so, elaboration of  new\napplications that combine several of the wrapped Web Services is fostered.\n\nOne of the main philosophy of **BioServices** is to make use of the existing\nbiological databases (not to re-invent new databases) and to alleviates the\nneeds for expertise in Web Services for the developers/users.\n\nBioServices provides access to about 40 Web Services.\n\nContributors\n============\n\nMaintaining BioServices would not have been possible without users and contributors.\nEach contribution has been an encouragement to pursue this project. Thanks to all:\n\n.. image:: https://contrib.rocks/image?repo=cokelaer/bioservices\n    :target: https://github.com/cokelaer/bioservices/graphs/contributors\n\n\nQuick example\n=============\n\nHere is a small example using the UniProt Web Service to search for the zap70 specy in human\norganism::\n\n    \u003e\u003e\u003e from bioservices import UniProt\n    \u003e\u003e\u003e u = UniProt(verbose=False)\n    \u003e\u003e\u003e data = u.search(\"zap70+and+taxonomy_id:9606\", frmt=\"tsv\", limit=3,\n    ...                 columns=\"id,length,accession, gene_names\")\n    \u003e\u003e\u003e print(data)\n    Entry name   Length  Entry   Gene names\n    ZAP70_HUMAN  619     P43403  ZAP70 SRK\n    B4E0E2_HUMAN 185     B4E0E2\n    RHOH_HUMAN   191     Q15669  RHOH ARHH TTF\n\n\n.. note:: major changes of UniProt API changed all columns names in June 2022. The code above is valid for bioservices\n   versions \u003e1.10. Earlier version used::\n\n        \u003e\u003e\u003e data = u.search(\"zap70+and+taxonomy:9606\", frmt=\"tab\", limit=3,\n        ...                 columns=\"entry name,length,id, genes\")\n\n   Note that columns names have changed, the frmt was changed from tab to tsv\n   and taxonomy is now taxonomy_id. Names correspondences can be found in::\n\n        u._legacy_names\n\n\nMore examples and tutorials are available in the `On-line documentation \u003chttp://bioservices.readthedocs.io/\u003e`_\n\nCurrent services\n================\nHere is the list of services available and their testing status.\n\n\n==================== ================================================================================================\nService              CI testing\n==================== ================================================================================================\narrayexpress          .. image:: https://github.com/cokelaer/bioservices/actions/workflows/arrayexpress.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/arrayexpress.yml\nbigg                  .. image:: https://github.com/cokelaer/bioservices/actions/workflows/bigg.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/bigg.yml\nbiocontainers         .. image:: https://github.com/cokelaer/bioservices/actions/workflows/biocontainers.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/biocontainers.yml\nbiodbnet              .. image:: https://github.com/cokelaer/bioservices/actions/workflows/biodbnet.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/biodbnet.yml\nbiogrid               .. image:: https://github.com/cokelaer/bioservices/actions/workflows/biogrid.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/biogrid.yml\nbiomart               .. image:: https://github.com/cokelaer/bioservices/actions/workflows/biomart.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/biomart.yml\nbiomodels             .. image:: https://github.com/cokelaer/bioservices/actions/workflows/biomodels.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/biomodels.yml\nchebi                 .. image:: https://github.com/cokelaer/bioservices/actions/workflows/chebi.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/chebi.yml\nchembl                .. image:: https://github.com/cokelaer/bioservices/actions/workflows/chembl.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/chembl.yml\ncog                   .. image:: https://github.com/cokelaer/bioservices/actions/workflows/cog.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/cog.yml\ndbfetch               .. image:: https://github.com/cokelaer/bioservices/actions/workflows/dbfetch.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/dbfetch.yml\nena                   .. image:: https://github.com/cokelaer/bioservices/actions/workflows/ena.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/ena.yml\nensembl               .. image:: https://github.com/cokelaer/bioservices/actions/workflows/ensembl.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/ensembl.yml\neutils                .. image:: https://github.com/cokelaer/bioservices/actions/workflows/eutils.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/eutils.yml\neva                   .. image:: https://github.com/cokelaer/bioservices/actions/workflows/eva.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/eva.yml\nhgnc                  .. image:: https://github.com/cokelaer/bioservices/actions/workflows/hgnc.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/hgnc.yml\nintact_complex        .. image:: https://github.com/cokelaer/bioservices/actions/workflows/intact_complex.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/intact_complex.yml\nkegg                  .. image:: https://github.com/cokelaer/bioservices/actions/workflows/kegg.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/kegg.yml\nmuscle                .. image:: https://github.com/cokelaer/bioservices/actions/workflows/muscle.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/muscle.yml\nmygeneinfo            .. image:: https://github.com/cokelaer/bioservices/actions/workflows/mygeneinfo.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/mygeneinfo.yml\nncbiblast             .. image:: https://github.com/cokelaer/bioservices/actions/workflows/ncbiblast.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/ncbiblast.yml\nomicsdi               .. image:: https://github.com/cokelaer/bioservices/actions/workflows/omicsdi.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/omicsdi.yml\nomnipath              .. image:: https://github.com/cokelaer/bioservices/actions/workflows/omnipath.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/omnipath.yml\npanther               .. image:: https://github.com/cokelaer/bioservices/actions/workflows/panther.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/panther.yml\npathwaycommons        .. image:: https://github.com/cokelaer/bioservices/actions/workflows/pathwaycommons.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/pathwaycommons.yml\npdb                   .. image:: https://github.com/cokelaer/bioservices/actions/workflows/pdb.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/pdb.yml\npdbe                  .. image:: https://github.com/cokelaer/bioservices/actions/workflows/pdbe.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/pdbe.yml\npfam                  .. image:: https://github.com/cokelaer/bioservices/actions/workflows/pfam.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/pfam.yml\npride                 .. image:: https://github.com/cokelaer/bioservices/actions/workflows/pride.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/pride.yml\npsicquic              .. image:: https://github.com/cokelaer/bioservices/actions/workflows/psicquic.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/psicquic.yml\npubchem               .. image:: https://github.com/cokelaer/bioservices/actions/workflows/pubchem.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/pubchem.yml\nquickgo               .. image:: https://github.com/cokelaer/bioservices/actions/workflows/quickgo.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/quickgo.yml\nreactome              .. image:: https://github.com/cokelaer/bioservices/actions/workflows/reactome.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/reactome.yml\nrhea                  .. image:: https://github.com/cokelaer/bioservices/actions/workflows/rhea.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/rhea.yml\nseqret                .. image:: https://github.com/cokelaer/bioservices/actions/workflows/seqret.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/seqret.yml\nunichem               .. image:: https://github.com/cokelaer/bioservices/actions/workflows/unichem.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/unichem.yml\nuniprot               .. image:: https://github.com/cokelaer/bioservices/actions/workflows/uniprot.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/uniprot.yml\nwikipathway           .. image:: https://github.com/cokelaer/bioservices/actions/workflows/wikipathway.yml/badge.svg\n                         :target: https://github.com/cokelaer/bioservices/actions/workflows/wikipathway.yml\n==================== ================================================================================================\n\n.. note:: Contributions to implement new wrappers are more than welcome.\n    See `BioServices github page \u003chttps://github.com/cokelaer/bioservices/\u003e`_\n    to join the development, and the Developer guide on how to implement new\n    wrappers.\n\nBioservices command\n====================\n\nIn version 1.8.2, we included a bioservices command. For now it has only one subcommand to download a NCBI accession number and possibly it genbank or GFF file (if available)::\n\n    bioservices download-accession --accession K01711.1 --with-gbk\n\n\nChangelog\n=========\n\n\n========= ====================================================================\nVersion   Description\n========= ====================================================================\n1.12.1    * fix pyproject to use python\u003e3.9 and pandas/numpy\u003e2.2\n1.12.0    * Fix pyproject missing requirements\n          * Fix pkg_resources warning\n          * drop python 3.8, add py3.12\n1.11.2    * Update COG service to be more user-friendly and return all pages\n            by default\n          * uniprot set progress to False in the search method\n          * Merged #250 and #249 user PRs (compress option in uniprot module\n            and logging issue in biodbnet)\n1.11.1    * Fix regression i uniprot.mapping\n            (https://github.com/cokelaer/bioservices/issues/245)\n1.11.0    * Fix uniprot limitation of 25 results only (\n          * For developers: all services are now refactorised to use services\n            as an attribute rather than a parent class.\n          * Remove ReactomeOld and ReactomeAnalysis (deprecated)\n          * move rnaseq_ebi (deprecated) to attic for book_keeping\n1.10.4    * Fix v1.10.3 adding missing requirements.txt\n1.10.3    * Update pdb service to use v2 API\n          * remove biocarta (website not accesible anymore)\n          * Update Chembl (no API changes)\n1.10.2    * Fix #226 and applied PR from Fix from @GianArauz\n            https://github.com/cokelaer/bioservices/pull/232 about UniProt\n            error\n          * Update MANIFEST to fix #232\n1.10.1    * allow command line to download genbank and GFF\n          * update pride module to use new PRIDE API (July 2022)\n          * Fixed KEGG bug #225\n1.10.0    * Update uniprot to use the new API (june 2022)\n1.9.0     * Update unichem to reflect new API\n1.8.4     * biomodels. Fix #208\n          * KEGG: fixed #204 #202 and #203\n1.8.3     * Eutils: remove warning due to unreachable URL. Set REST as\n            attribute rather and inheritance.\n          * NEW biocontainers module\n          * KEGG: add save_pathway method. Fix parsing of structure/pdb entry\n          * remove deprecated function from Reactome\n1.8.2     * Fix suds package in code and requirements\n1.8.1     * Integrated a change made in KEGG service (DEFINITON was changed to\n            ORG_CODE)\n          * for developers: applied black on all modules\n          * switch suds-jurko to new suds community\n1.8.0     * add main standalone application.\n          * moved chemspider and clinvitae to the attic\n          * removed picr service, not active anymore\n1.4.X     * NEW RNAseq from EBI in rnaseq_ebi module\n          * Replaced deprecated HGNC with the official web service from genenames.org\n          * Fully updated EUtils since WSDL is now down; implementation uses REST now.\n          * Removed the apps/taxonomy module now part of http://github.com/biokit.\n1.3.X     * CACHE files are now stored in a general directory in the home\n          * New REST class to use **requests** package instead of urllib2.\n          * Creation of a global configuration file in .config/bioservice/bioservices.cfg\n          * NEW services: Reactome, Readseq, Ensembl, EUtils\n1.2.X     * NEW services: BioDBnet, BioDBNet, MUSCLE, PathwayCommons, GeneProf\n1.1.X     * NEW services: biocarta, pfam, ChEBI, UniChem\n1.0.0:    * first stable release\n0.9.X:    * NEW services: BioModels, Kegg, Reactome, Chembl, PICR, QuickGO,\n            Rhea, UniProt,WSDbfetch, NCBIblast, PSICQUIC, Wikipath\n========= ====================================================================\n\n\n.. |Codacy-Grade| image:: https://app.codacy.com/project/badge/Grade/9b8355ff642f4de9acd4b270f8d14d10\n   :target: https://app.codacy.com/gh/cokelaer/bioservices/dashboard\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcokelaer%2Fbioservices","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcokelaer%2Fbioservices","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcokelaer%2Fbioservices/lists"}