{"id":29709832,"url":"https://github.com/google-deepmind/alphagenome","last_synced_at":"2025-07-23T20:36:02.792Z","repository":{"id":301181379,"uuid":"873507399","full_name":"google-deepmind/alphagenome","owner":"google-deepmind","description":"This API provides programmatic access to the AlphaGenome model developed by Google DeepMind.","archived":false,"fork":false,"pushed_at":"2025-07-21T19:17:56.000Z","size":9922,"stargazers_count":1077,"open_issues_count":0,"forks_count":117,"subscribers_count":23,"default_branch":"main","last_synced_at":"2025-07-21T20:30:58.106Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.alphagenomedocs.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/google-deepmind.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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,"zenodo":null}},"created_at":"2024-10-16T09:33:11.000Z","updated_at":"2025-07-21T19:34:22.000Z","dependencies_parsed_at":"2025-07-21T20:32:46.870Z","dependency_job_id":null,"html_url":"https://github.com/google-deepmind/alphagenome","commit_stats":null,"previous_names":["google-deepmind/alphagenome"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/google-deepmind/alphagenome","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google-deepmind%2Falphagenome","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google-deepmind%2Falphagenome/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google-deepmind%2Falphagenome/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google-deepmind%2Falphagenome/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/google-deepmind","download_url":"https://codeload.github.com/google-deepmind/alphagenome/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google-deepmind%2Falphagenome/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266743677,"owners_count":23977370,"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","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-07-23T20:35:58.498Z","updated_at":"2025-07-23T20:36:02.781Z","avatar_url":"https://github.com/google-deepmind.png","language":"Python","readme":"![AlphaGenome header image](docs/source/_static/header.png)\n\n# AlphaGenome\n\n![PyPI Python version](https://img.shields.io/pypi/pyversions/AlphaGenome)\n![Presubmit Checks](https://github.com/google-deepmind/alphagenome/actions/workflows/presubmit_checks.yml/badge.svg)\n\n[**Get API key**](https://deepmind.google.com/science/alphagenome) |\n[**Quick start**](#quick-start) | [**Installation**](#installation) |\n[**Documentation**](https://www.alphagenomedocs.com/) |\n[**Community**](https://www.alphagenomecommunity.com) |\n[**Terms of Use**](https://deepmind.google.com/science/alphagenome/terms)\n\nThe AlphaGenome API provides access to AlphaGenome, Google DeepMind’s unifying\nmodel for deciphering the regulatory code within DNA sequences. This repository\ncontains client-side code, examples and documentation to help you use the\nAlphaGenome API.\n\nAlphaGenome offers multimodal predictions, encompassing diverse functional\noutputs such as gene expression, splicing patterns, chromatin features, and\ncontact maps (see [diagram below](#model_overview)). The model analyzes DNA\nsequences of up to 1 million base pairs in length and can deliver predictions at\nsingle base-pair resolution for most outputs. AlphaGenome achieves\nstate-of-the-art performance across a range of genomic prediction benchmarks,\nincluding numerous diverse variant effect prediction tasks (detailed in\n[Avsec et al. 2025](https://doi.org/10.1101/2025.06.25.661532)).\n\nThe API is offered free of charge for\n[non-commercial use](https://deepmind.google.com/science/alphagenome/terms)\n(subject to the terms of use). Query rates vary based on demand – it is well\nsuited for smaller to medium-scale analyses such as analysing a limited number\nof genomic regions or variants requiring 1000s of predictions, but is likely not\nsuitable for large scale analyses requiring more than 1 million predictions.\nOnce you obtain your API key, you can easily get started by following our\n[Quick Start Guide](#quick-start), or watching our\n[AlphaGenome 101 tutorial](https://youtu.be/Xbvloe13nak).\n\n\u003ca id='model_overview'\u003e\n\n![Model overview](docs/source/_static/model_overview.png)\n\n\u003c/a\u003e\n\nThe documentation also covers a set of comprehensive tutorials, variant scoring\nstrategies to efficiently score variant effects, and a visualization library to\ngenerate `matplotlib` figures for the different output modalities.\n\nWe cover additional details of the capabilities and limitations in our\ndocumentation. For support and feedback:\n\n-   Please submit bugs and any code-related issues on\n    [GitHub](https://github.com/google-deepmind/alphagenome/issues).\n-   For general feedback, questions about usage, and/or feature requests, please\n    use the [community forum](https://www.alphagenomecommunity.com) – it’s\n    actively monitored by our team so you're likely to find answers and insights\n    faster.\n-   If you can't find what you're looking for, please get in touch with the\n    AlphaGenome team on alphagenome@google.com and we will be happy to assist\n    you with questions. We’re working hard to answer all inquiries but there may\n    be a short delay in our response due to the high volume we are receiving.\n\n## Quick start\n\nThe quickest way to get started is to run our example notebooks in\n[Google Colab](https://colab.research.google.com/). Here are some starter\nnotebooks:\n\n-   [Quick start](https://colab.research.google.com/github/google-deepmind/alphagenome/blob/main/colabs/quick_start.ipynb):\n    An introduction to quickly get you started with using the model and making\n    predictions.\n-   [Visualizing predictions](https://colab.research.google.com/github/google-deepmind/alphagenome/blob/main/colabs/visualization_modality_tour.ipynb):\n    Learn how to visualize different model predictions using the visualization\n    libraries.\n\nAlternatively, you can dive straight in by following the\n[installation guide](#installation) and start writing code! Here's an example of\nmaking a variant prediction:\n\n```python\nfrom alphagenome.data import genome\nfrom alphagenome.models import dna_client\nfrom alphagenome.visualization import plot_components\nimport matplotlib.pyplot as plt\n\n\nAPI_KEY = 'MyAPIKey'\nmodel = dna_client.create(API_KEY)\n\ninterval = genome.Interval(chromosome='chr22', start=35677410, end=36725986)\nvariant = genome.Variant(\n    chromosome='chr22',\n    position=36201698,\n    reference_bases='A',\n    alternate_bases='C',\n)\n\noutputs = model.predict_variant(\n    interval=interval,\n    variant=variant,\n    ontology_terms=['UBERON:0001157'],\n    requested_outputs=[dna_client.OutputType.RNA_SEQ],\n)\n\nplot_components.plot(\n    [\n        plot_components.OverlaidTracks(\n            tdata={\n                'REF': outputs.reference.rna_seq,\n                'ALT': outputs.alternate.rna_seq,\n            },\n            colors={'REF': 'dimgrey', 'ALT': 'red'},\n        ),\n    ],\n    interval=outputs.reference.rna_seq.interval.resize(2**15),\n    # Annotate the location of the variant as a vertical line.\n    annotations=[plot_components.VariantAnnotation([variant], alpha=0.8)],\n)\nplt.show()\n```\n\n## Installation\n\n\u003c!-- mdformat off(disable for [!TIP] format) --\u003e\n\n\u003e [!TIP]\n\u003e You may optionally wish to create a\n\u003e [Python Virtual Environment](https://docs.python.org/3/tutorial/venv.html) to\n\u003e prevent conflicts with your system's Python environment.\n\n\u003c!-- mdformat on --\u003e\n\nTo install `alphagenome`, clone a local copy of the repository and run `pip\ninstall`:\n\n```bash\n$ git clone https://github.com/google-deepmind/alphagenome.git\n$ pip install ./alphagenome\n```\n\nSee [the documentation](https://www.alphagenomedocs.com/installation.html) for\ninformation on alternative installation strategies.\n\n## Citing `alphagenome`\n\nIf you use AlphaGenome in your research, please cite using:\n\n\u003c!-- disableFinding(SNIPPET_INVALID_LANGUAGE) --\u003e\n\n```bibtex\n@article{alphagenome,\n  title={{AlphaGenome}: advancing regulatory variant effect prediction with a unified {DNA} sequence model},\n  author={Avsec, {\\v Z}iga and Latysheva, Natasha and Cheng, Jun and Novati, Guido and Taylor, Kyle R. and Ward, Tom and Bycroft, Clare and Nicolaisen, Lauren and Arvaniti, Eirini and Pan, Joshua and Thomas, Raina and Dutordoir, Vincent and Perino, Matteo and De, Soham and Karollus, Alexander and Gayoso, Adam and Sargeant, Toby and Mottram, Anne and Wong, Lai Hong and Drot{\\'a}r, Pavol and Kosiorek, Adam and Senior, Andrew and Tanburn, Richard and Applebaum, Taylor and Basu, Souradeep and Hassabis, Demis and Kohli, Pushmeet},\n  year={2025},\n  doi={https://doi.org/10.1101/2025.06.25.661532},\n  publisher={Cold Spring Harbor Laboratory},\n  journal={bioRxiv}\n}\n```\n\n\u003c!-- enableFinding(SNIPPET_INVALID_LANGUAGE) --\u003e\n\n## Acknowledgements\n\nAlphaGenome communicates with and/or references the following separate libraries\nand packages:\n\n*   [Abseil](https://github.com/abseil/abseil-py)\n*   [anndata](https://github.com/scverse/anndata)\n*   [gRPC](https://github.com/grpc/grpc)\n*   [immutabledict](https://github.com/corenting/immutabledict)\n*   [intervaltree](https://github.com/chaimleib/intervaltree)\n*   [jaxtyping](https://github.com/patrick-kidger/jaxtyping)\n*   [matplotlib](https://matplotlib.org/)\n*   [ml_dtypes](https://github.com/jax-ml/ml_dtypes)\n*   [NumPy](https://numpy.org/)\n*   [pandas](https://pandas.pydata.org/)\n*   [protobuf](https://developers.google.com/protocol-buffers/)\n*   [pyarrow](https://arrow.apache.org/)\n*   [SciPy](https://scipy.org/)\n*   [seaborn](https://seaborn.pydata.org/)\n*   [tqdm](https://github.com/tqdm/tqdm)\n*   [typeguard](https://github.com/agronholm/typeguard)\n*   [typing_extensions](https://github.com/python/typing_extensions)\n*   [zstandard](https://github.com/indygreg/python-zstandard)\n\nWe thank all their contributors and maintainers!\n\n## License and Disclaimer\n\nCopyright 2024 Google LLC\n\nAll software in this repository is licensed under the Apache License, Version\n2.0 (Apache 2.0); you may not use this except in compliance with the Apache 2.0\nlicense. You may obtain a copy of the Apache 2.0 license at:\nhttps://www.apache.org/licenses/LICENSE-2.0.\n\nExamples and documentation to help you use the AlphaGenome API are licensed\nunder the Creative Commons Attribution 4.0 International License (CC-BY). You\nmay obtain a copy of the CC-BY license at:\nhttps://creativecommons.org/licenses/by/4.0/legalcode.\n\nUnless required by applicable law or agreed to in writing, all software and\nmaterials distributed here under the Apache 2.0 or CC-BY licenses are\ndistributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,\neither express or implied. See the licenses for the specific language governing\npermissions and limitations under those licenses.\n\nThis is not an official Google product.\n\n### Third-party software\n\nYour use of any third-party software, libraries or code referenced in the\nmaterials in this repository (including the libraries listed in the\n[Acknowledgments](#acknowledgements) section) may be governed by separate terms\nand conditions or license provisions. Your use of the third-party software,\nlibraries or code is subject to any such terms and you should check that you can\ncomply with any applicable restrictions or terms and conditions before use.\n\n### Reference Datasets\n\nA modified version of the GENCODE dataset (which can be found here:\nhttps://www.gencodegenes.org/human/releases.html) is released with the client\ncode package for illustrative purposes, and is available with reference to the\nfollowing:\n\n-   Copyright © 2024 EMBL-EBI\n-   The GENCODE dataset is subject to the EMBL-EBI terms of use, available at\n    https://www.ebi.ac.uk/about/terms-of-use.\n-   Citation: Frankish A, et al (2018) GENCODE reference annotation for the\n    human and mouse genome.\n-   Further details about GENCODE can be found at\n    https://www.gencodegenes.org/human/releases.html, with additional citation\n    information at https://www.gencodegenes.org/pages/publications.html and\n    further acknowledgements can be found at\n    https://www.gencodegenes.org/pages/gencode.html.\n","funding_links":[],"categories":["基因","Python","🤖 Scientific Models"],"sub_categories":["资源传输下载","🧬 Life Sciences"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogle-deepmind%2Falphagenome","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoogle-deepmind%2Falphagenome","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogle-deepmind%2Falphagenome/lists"}