This release is a pre-release and may not be stable for production use.
Metamist
Introduction
Metamist is a database designed for storing de-identified -omics metadata.
Purpose
The project provides an interface to interact with the -omics database via the Python client as well as the GraphQL + HTTP APIs.
Features
- Project-Based Resource Organization: Every resource in Metamist is associated with a specific project.
- Access Control: Access to resources is controlled through a basic permissions system. Users can have one of the following permissions for a project.
readerpermission allows viewing of all metadata within a projectcontributorpermission allows creating comments on metadata within a projectwriterpermission allows writing of all metadata within a project.
High-Level Architecture
It comprises three key components:
-
System-Versioned MariaDB Database: A robust database system for managing -omics metadata.
-
Python Web API: This component is responsible for:
- Managing permissions.
- Storing frequently used queries.
- Providing a GraphQL/HTTP API for efficient querying of the database.
-
Installable Python Library: Wraps the Python Web API using the OpenAPI generator, facilitating easier interaction with the system.
-
Web client UI A react application that allows viewing the metadata for projects.
Usage
There are a few different ways that you may need to interact with metamist.
Working with production metamist data
If you only need to interact with production metamist data, then you do not need to clone this repository or have a working local installation of metamist. You can install the python client from pypi:
pip install metamist
And use it in your python scripts:
from metamist.graphql import gql, query
def main():
my_query = gql("""
{
myProjects {
id
name
}
}
""")
result = query(my_query)
print(result)
if __name__ == "__main__":
main()
Further resources
- GraphiQL UI, for exploration of the GraphQL API
- Python client documentation
- Swagger HTTP API documentation
Testing scripts against a local database
When writing more complex scripts it is a good idea to test them against a local version of metamist. To do this, follow the local installation instructions to set up the API. Setting up the web client is optional and only necessary if you need to view your data in the UI.
Once you have the API set up locally, set the SM_ENVIRONMENT variable to local
export SM_ENVIRONMENT=local
This will tell the metamist python client to point to your local metamist install.
Developing or contributing to metamist
If you are working on developing features, fixing bugs or want to contribute to metamist in other ways then you will need a local installation of metamist. Follow the local installation instructions.
Schema
As of Jan 15, 2024 this schema should reflect the data structure on the tables:
You can also find this at DbDiagram.
The codebase contains the following modules worth noting:
models-> General data models + enumsdb/python/tables-> Interaction with MariaDB / BigQuerydb/python/layers-> Logicapi/graphql: GraphQL API schema and modelsapi/routes: HTTP + OpenAPI
And metamist maintains two clients:
web-> React app that consumes a generated Typescript API + GraphQLmetamist-> autogenerated Python API
License
This project is licensed under the MIT License. You can see it in the LICENSE file in the root directory of this source tree.
Metadata
Release files for metamist 8.0.0.dev56
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| metamist-8.0.0.dev56.tar.gz | 161.8 kB | Details |
Release files / metamist-8.0.0.dev56.tar.gz
| Download URL | metamist-8.0.0.dev56.tar.gz |
|---|---|
| Size | 161.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
df945700a01dba8f8ac46352ec73de30b883835bba80066b4c1b3da8aa7c9002
|
|
BLAKE2b-256 checksum How to use checksums |
b970170a0a3711a6fec1bf41af572dc75fcf39dd42fa22d52c7e7ed4e344613c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 24, 2026.
Transparency log
