Maestro

August 6, 2026 ยท View on GitHub

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.

Documentation

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.

Development Environment

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.

Support & Contributions

  • 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:


SoftwareDescription
ScoreTransfer data to and from any cloud-based storage system
SongCatalog and manage metadata associated to file data spread across cloud storage systems
MaestroOrganizing your distributed data into a centralized Elasticsearch index
ArrangerA search API with reusable search UI components
StageA React-based web portal scaffolding
LyricA model-agnostic, tabular data submission system
LecternSchema Manager, designed to validate, store, and manage collections of data dictionaries.

Funding Acknowledgement

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.