{"id":23360002,"url":"https://github.com/fhir/genomics-operations","last_synced_at":"2025-08-11T21:39:57.389Z","repository":{"id":38184399,"uuid":"483742500","full_name":"FHIR/genomics-operations","owner":"FHIR","description":"A public reference implementation of HL7 FHIR Genomics Operations (http://build.fhir.org/ig/HL7/genomics-reporting/operations.html)","archived":false,"fork":false,"pushed_at":"2025-07-06T21:19:28.000Z","size":1805,"stargazers_count":31,"open_issues_count":4,"forks_count":19,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-07-06T22:27:28.030Z","etag":null,"topics":["connexion","fhir","flask","genomics","heroku","mongodb","open-api-v3","pytest","python3"],"latest_commit_sha":null,"homepage":"https://fhir-gen-ops.herokuapp.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/FHIR.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2022-04-20T17:03:48.000Z","updated_at":"2025-06-09T21:02:29.000Z","dependencies_parsed_at":"2024-05-16T16:56:39.715Z","dependency_job_id":"f8d08a21-35ea-4e2b-9608-a791034541ec","html_url":"https://github.com/FHIR/genomics-operations","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/FHIR/genomics-operations","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FHIR%2Fgenomics-operations","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FHIR%2Fgenomics-operations/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FHIR%2Fgenomics-operations/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FHIR%2Fgenomics-operations/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FHIR","download_url":"https://codeload.github.com/FHIR/genomics-operations/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FHIR%2Fgenomics-operations/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269962734,"owners_count":24504283,"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-08-11T02:00:10.019Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","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":["connexion","fhir","flask","genomics","heroku","mongodb","open-api-v3","pytest","python3"],"created_at":"2024-12-21T11:12:46.971Z","updated_at":"2025-08-11T21:39:57.344Z","avatar_url":"https://github.com/FHIR.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HL7 FHIR Genomics Operations - Reference Implementation\nSource code for a [public reference implementation](https://fhir-gen-ops.herokuapp.com/) of [HL7 FHIR Genomics Operations](http://build.fhir.org/ig/HL7/genomics-reporting/operations.html).\n\nPlease refer to [project Wiki page](https://github.com/FHIR/genomics-operations/wiki) for details of this reference implementation, including how to replicate.\n\nFor additional information on the operations and the reference implementation, please see our [JAMIA manuscript](https://academic.oup.com/jamia/advance-article/doi/10.1093/jamia/ocac246/6957062).\n\nIssues (bugs, enhancements, etc) can be entered [here](https://github.com/FHIR/genomics-operations/issues). (Legacy issues are [here](https://docs.google.com/spreadsheets/d/1xPRDB2lvMPTImPHLwUvSboILZLG6jH1LHVXoOfgak9U/edit#gid=0)). Contact info@elimu.io for other comments.\n\n## Use Case\n\nA common use case driving the operations is the notion of an application (e.g. a SMART-ON-FHIR clinical genomics App, a clinical decision support application, an EHR screen) needing specific genotype or phenotype information, for a patient or a population. Applications have diverse needs, such as matching a cancer patient to available clinical trials based on identified somatic variants; screening for actionable hereditary conditions; identifying a risk for adverse medication reactions based on pharmacogenomic variants; updating a patient's risk as knowledge of their variants evolves; and more. A goal for FHIR Genomics operations is to ultimately support any and all of these clinical scenarios.\n\n## Scope\n\nIn scope are clinical genomics operations. In the future, operations supporting variant calling and annotation, and knowledge base lookups may be added. We further categorize clinical genomics operations along two orthogonal axes - subject vs. population, and genotype vs. phenotype. For example, the '**find-subject-variants**' operation retrieves genotype information for a single subject; whereas the '**find-population-tx-implications**' retrieves a count or list of patients having specific phenotypes (such as being intermediate metabolizers of clopidogrel).\n\n## Response\n\nAll operations return a JSON output. However, if an invalid request is submitted, or some other error occurs, a JSON response is returned in the following format:\n\n```javascript\n{\n  \"type\": string,\n  \"title\": string,\n  \"detail\": string,\n  \"status\": int\n}\n```\n\n## Status Codes\n\nThe operations return the following status codes:\n\n| Status Code | Description |\n| :--- | :--- |\n| 200 | `Successfully executed request` |\n| 400 | `ERROR: Invalid query parameters` |\n| 404 | `ERROR: Patient not found` |\n| 422 | `ERROR: Failed LiftOver` |\n| 500 | `INTERNAL SERVER ERROR` |\n\n## Testing\n\nTo run the [integration tests](https://github.com/FHIR/genomics-operations/tree/main/tests), you can use the VS Code Testing functionality which should discover them automatically. You can also\nrun `python3 -m pytest` from the terminal to execute them all.\n\nAdditionally, since the tests run against the Mongo DB database, if you need to update the test data in this repo, you\ncan run `OVERWRITE_TEST_EXPECTED_DATA=true python3 -m pytest` from the terminal and then create a pull request with the\nchanges.\n\n## Update py-ard database\n\n- Run `pyard.init(data_dir='./data/pyard', imgt_version=\u003cnew version\u003e)` to download the new version\n- Run `cd data/pyard \u0026\u0026 tar -czf pyard.sqlite3.tar.gz pyard-\u003cnew version\u003e.sqlite3`\n- Upload `pyard.sqlite3.tar.gz` in a new release on GitHub\n- Update `PYARD_DATABASE_VERSION` in `.env`\n- Update `UTILITIES_DATA_VERSION` in `.env` with the new tag ID (short git sha)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffhir%2Fgenomics-operations","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffhir%2Fgenomics-operations","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffhir%2Fgenomics-operations/lists"}