{"id":22727089,"url":"https://github.com/microbiomedata/nmdc-schema","last_synced_at":"2026-06-10T23:00:58.190Z","repository":{"id":37790000,"uuid":"354168085","full_name":"microbiomedata/nmdc-schema","owner":"microbiomedata","description":"National Microbiome Data Collaborative (NMDC) unified data model","archived":false,"fork":false,"pushed_at":"2026-06-09T20:28:00.000Z","size":172529,"stargazers_count":47,"open_issues_count":439,"forks_count":10,"subscribers_count":8,"default_branch":"main","last_synced_at":"2026-06-09T21:08:28.144Z","etag":null,"topics":["ecoinformatics","fair-data","genomics","linkml","metabolomics","metadata","microbiome","microbiomedata","mixs","nmdc","proteomics","samples","schema","standards","transcriptomics"],"latest_commit_sha":null,"homepage":"https://microbiomedata.github.io/nmdc-schema/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/microbiomedata.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":"MAINTAINERS.md","copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-04-03T00:54:27.000Z","updated_at":"2026-06-08T14:50:43.000Z","dependencies_parsed_at":"2023-09-28T18:21:02.386Z","dependency_job_id":"084ff9f2-975b-4e7f-9c7c-fea6e5669109","html_url":"https://github.com/microbiomedata/nmdc-schema","commit_stats":{"total_commits":3943,"total_committers":30,"mean_commits":"131.43333333333334","dds":0.6961704286076591,"last_synced_commit":"4b01a371918cb791f9dbd0029bf54353a3d6cb68"},"previous_names":[],"tags_count":190,"template":false,"template_full_name":"linkml/linkml-template","purl":"pkg:github/microbiomedata/nmdc-schema","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microbiomedata%2Fnmdc-schema","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microbiomedata%2Fnmdc-schema/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microbiomedata%2Fnmdc-schema/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microbiomedata%2Fnmdc-schema/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microbiomedata","download_url":"https://codeload.github.com/microbiomedata/nmdc-schema/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microbiomedata%2Fnmdc-schema/sbom","scorecard":{"id":582513,"data":{"date":"2025-08-11","repo":{"name":"github.com/microbiomedata/nmdc-schema","commit":"6119689e49c658e278e058fb1abf92ce07547b0c"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":5.6,"checks":[{"name":"Maintained","score":10,"reason":"30 commit(s) and 20 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":5,"reason":"Found 5/9 approved changesets -- score normalized to 5","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/artifact_upload.yaml:1","Warn: no topLevel permission defined: .github/workflows/check-links.yaml:1","Warn: no topLevel permission defined: .github/workflows/deploy-docs.yaml:1","Warn: no topLevel permission defined: .github/workflows/main.yaml:1","Warn: no topLevel permission defined: .github/workflows/migration.yaml:1","Warn: no topLevel permission defined: .github/workflows/pypi-publish.yaml:1","Warn: no topLevel permission defined: .github/workflows/test_pages_build.yaml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Creative Commons Zero v1.0 Universal: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: third-party GitHubAction not pinned by hash: .github/workflows/artifact_upload.yaml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/artifact_upload.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/artifact_upload.yaml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/artifact_upload.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/artifact_upload.yaml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/artifact_upload.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/check-links.yaml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/check-links.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/check-links.yaml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/check-links.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/check-links.yaml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/check-links.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/check-links.yaml:43: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/check-links.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/check-links.yaml:54: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/check-links.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/deploy-docs.yaml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/deploy-docs.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/deploy-docs.yaml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/deploy-docs.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/deploy-docs.yaml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/deploy-docs.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/main.yaml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/main.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/main.yaml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/main.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/migration.yaml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/migration.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/migration.yaml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/migration.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/migration.yaml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/migration.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/migration.yaml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/migration.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/migration.yaml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/migration.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pypi-publish.yaml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/pypi-publish.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pypi-publish.yaml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/pypi-publish.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/pypi-publish.yaml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/pypi-publish.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test_pages_build.yaml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/test_pages_build.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test_pages_build.yaml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/test_pages_build.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/test_pages_build.yaml:51: update your workflow using https://app.stepsecurity.io/secureworkflow/microbiomedata/nmdc-schema/test_pages_build.yaml/main?enable=pin","Warn: containerImage not pinned by hash: Dockerfile:2: pin your Docker image by updating python:3.9 to python:3.9@sha256:b93ed1cb6815be1d99908ab629d49680be28024c4183611ded45c425ecf7b907","Warn: pipCommand not pinned by hash: Dockerfile:52","Info:   0 out of  15 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   9 third-party GitHubAction dependencies pinned","Info:   0 out of   1 containerImage dependencies pinned","Info:   0 out of   1 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/pypi-publish.yaml:8"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 27 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-20T19:32:24.420Z","repository_id":37790000,"created_at":"2025-08-20T19:32:24.421Z","updated_at":"2025-08-20T19:32:24.421Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34174148,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"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":["ecoinformatics","fair-data","genomics","linkml","metabolomics","metadata","microbiome","microbiomedata","mixs","nmdc","proteomics","samples","schema","standards","transcriptomics"],"created_at":"2024-12-10T17:09:19.638Z","updated_at":"2026-06-10T23:00:58.066Z","avatar_url":"https://github.com/microbiomedata.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv style=\"text-align: center;\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/microbiomedata/nmdc-schema/main/images/nmdc_logo_long.jpeg\" width=\"119\" height=\"40\" alt=\"Long NMDC logo\"/\u003e\n\u003c/div\u003e\n\n# National Microbiome Data Collaborative Schema\n\n[![PyPI - License](https://img.shields.io/pypi/l/nmdc-schema)](https://github.com/microbiomedata/nmdc-schema/blob/main/LICENSE)\n[![PyPI version](https://badge.fury.io/py/nmdc-schema.svg?any-param=to-cause-a-cache-miss)](https://badge.fury.io/py/nmdc-schema)\n\nThe mission of the NMDC is to build a FAIR microbiome data sharing network, through infrastructure, data standards,\nand community building, that addresses pressing challenges in environmental sciences. The NMDC platform is built on\ntop of a unified data model (schema) that weaves together existing standards and ontologies to provide a systematic\nrepresentation of all aspects of the microbiome data life cycle.\n\nThis repository mainly defines a [LinkML](https://github.com/linkml/linkml) schema for managing metadata from\nthe [National Microbiome Data Collaborative (NMDC)](https://microbiomedata.org/).\n\n## Documentation\n\nThe documentation for the NMDC schema can be found at [https://microbiomedata.github.io/nmdc-schema/](https://microbiomedata.github.io/nmdc-schema/).\nThis documentation is aimed at consumers of NMDC data and metadata, it describes the different data elements used to describe studies, samples,\nsample processing, data generation, workflows, and downstream data objects.\n\nThe NMDC [Introduction to metadata and ontologies](https://microbiomedata.org/introduction-to-metadata-and-ontologies/)\nprimer provides some the context for this project.\n\nThe remainder of this page is primary for the internal maintainers and contributors to the NMDC schema\n\n## Repository Contents Overview\n\nSome products that are maintained, and tasks orchestrated within this repository are:\n\n- Maintenance of LinkML YAML that specifies the NMDC Schema\n    - [src/schema/nmdc.yaml](src/schema/nmdc.yaml)\n    - and various other YAML schemas imported by it,\n      like [prov.yaml](src/schema/prov.yaml), [annotation.yaml](src/schema/annotation.yaml), etc. all which you can find\n      in the [src/schema](src/schema/) folder\n- Makefile targets for converting the schema from it's native LinkML YAML format to other artifact\n  like [JSON Schema](project/jsonschema/nmdc.schema.json)\n- Build, deployment and distribution of the schema as a [PyPI package](https://pypi.org/project/nmdc-schema/)\n- Automatic publishing of refreshed documentation upon change to the schema,\n  accessible [here](https://microbiomedata.github.io/nmdc-schema/)\n\n## Maintaining the Schema\n\nSee [DEVELOPMENT.md](DEVELOPMENT.md) for instructions on setting up a development environment.\n\nSee [MAINTAINERS.md](MAINTAINERS.md) for instructions on using that development environment to maintain the schema.\n\n## Makefiles\n\nMakefiles are text files people can use to tell [`make`](https://www.gnu.org/software/make/manual/make.html#Introduction) (a computer program) how it can _make_ things (or—in general—_do_ things). In the world of Makefiles, those _things_ are called _targets_.\n\nThis repo contains 2 Makefiles:\n- `Makefile`, based on the generic Makefile from the [LinkML cookiecutter](https://github.com/linkml/linkml-project-cookiecutter)\n- `project.Makefile`, which contains _targets_ that are specific to this project\n\nHere's an example of using `make` in this repo:\n\n```shell\n# Deletes all files in `examples/output`.\nmake examples-clean\n```\n\u003e The `examples-clean` _target_ is defined in the `project.Makefile`. In this repo, the `Makefile` `include`s the `project.Makefile`. As a result, `make` has access to the _targets_ defined in both files.\n\n## Data downloads\n\nThe NMDC's metadata about biosamples, studies, bioinformatics workflows, etc. can be obtained from our nmdc-runtime API.\nTry entering \"biosample_set\" or \"study_set\" into the `collection_name` box\nat https://api.microbiomedata.org/docs#/metadata/list_from_collection_nmdcschema__collection_name__get\n\nOr use the API programmatically! Note that some collections are large, so the responses are paged.\n\nYou can learn about the other available collections at https://microbiomedata.github.io/nmdc-schema/Database/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrobiomedata%2Fnmdc-schema","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrobiomedata%2Fnmdc-schema","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrobiomedata%2Fnmdc-schema/lists"}