Maestro enables researchers to enhance their Overture Song and Lyric deployments by building powerful search indexes over their metadata. It organizes geographically distributed data from multiple repositories into a single, configurable Elasticsearch index.
Maestro is part of Overture, a collection of open-source software microservices used to create platforms for researchers to organize and share genomics data.
Technical resources for those working with or contributing to the project are available from our official documentation site, the following content can also be read and updated within the /docs folder of this repository.
- Node.js v22 or higher
- pnpm package manager
- Docker Container platform
- Elasticsearch 7 or higher
Maestro is a TypeScript project managed as a pnpm monorepo. A Makefile wraps the common
tasks: make compile installs dependencies and builds every package, make docker-start-dev
starts the supporting Elasticsearch and Kafka containers, and make start runs the server.
Once running, the Swagger UI is available at http://localhost:11235/api-docs.
- For support, feature requests, and bug reports, please see our Support Guide.
- For detailed information on how to contribute to this project, please see our Contributing Guide.
The Overture Platform includes the following Overture Components:
| Software | Description |
|---|---|
| Score | Transfer data to and from any cloud-based storage system |
| Song | Catalog and manage metadata associated to file data spread across cloud storage systems |
| Maestro | Organizing your distributed data into a centralized Elasticsearch index |
| Arranger | A search API with reusable search UI components |
| Stage | A React-based web portal scaffolding |
| Lyric | A model-agnostic, tabular data submission system |
| Lectern | Schema Manager, designed to validate, store, and manage collections of data dictionaries. |
Overture is supported by grant #U24CA253529 from the National Cancer Institute at the US National Institutes of Health, and additional funding from Genome Canada, the Canada Foundation for Innovation, the Canadian Institutes of Health Research, Canarie, and the Ontario Institute for Cancer Research.