The Monarch Knowledge Graph (Monarch KG) is an extensive knowledge graph and ecosystem of tools made for the benefit of clinicians, researchers, and scientists. The knowledge graph consists of millions of entities – genes, diseases, phenotypes, and many more – imported from dozens of sources. While we have a core development team, we welcome the contributions of the community to help us maintain and improve the knowledge graph and the tools that use it.
- Monarch-KG and Tools Documentation - The Monarch KG and tools documentation site includes information about the Monarch-KG and it's access tools, as well as the release process and other important information.
- Monarch App Website - The Monarch-KG website, a Vue web app using
monarch-py(API) as the backend. - Monarch Initiative Documentation - This is the Monarch Initiative's Consortium wide documenation.
We welcome you to our community! We seek to provide a welcoming and safe development experience for everyone. Please read our code of conduct and reach out to us if you have any questions. We welcome your input!
The monarch-app repository is a monorepo that contains the projects necessary to build and run the web app at monarchinitiative.org and the appropriate tooling and developer resources to continue development. The frontend for the Monarch Initiative website is a javascript/typescript webapp developed using the Vue toolkit. The backend, also referred to as monarch-py, is a Python library for interacting with the Monarch Initiative knowledge graph. The monarch-py backend also includes an optional FastAPI module that serves as the website's backend and related services for enabling the frontend.
The Monarch Initiative website tool chain has a few requirements that you may need to install before we are ready to work on testing or development. Here is the list of requirements and what they are used for. If you are only working on a portion of the code-base you may not need all of the tools below.
- Python - Most of us use Python version 3.10.12 for development and try to be compatible with versions 3.9-3.12.
- Poetry - We use Poetry to manage dependencies in
monarch-py - pyenv (suggested) - I recommend using pyenv to manage your Python version within different projects
- Bun - Bun is used as a drop-in replacement for Node (non-browser JavaScript runtime environment) and Yarn (package manager). If you already have Node.js installed you Bun will not conflict with your Node.js environment and can be installed as a module. The frontend/CONTRIBUTING.md has simple instructions on how to install Bun.
- Docker - Image files used for development and testing for both frontend and backend (required for Solr)
- Rust (cargo) - Required for running the semsimian server locally
To get started with development in monarch-app clone the repo and navigate to the directory.
git clone git@github.com:monarch-initiative/monarch-app.git
cd monarch-appIn order to maintain a clean system environment you may want to create a local python environment. I also recommend setting a local python version of 3.10 with pyenv. You can do both with the following commands.
pyenv install 3.10.12
pyenv local 3.10.12
python -m venv .venvWhen the new virtual environment is created, you may want to do some peronal modifications to the envoronment. I edit the activate script to name the virtual environment more meaningfully and also install poetry locally (my preference, activate then run pip install poetry). After the virtual environment is set up you will want to start it before each development session by running activate (or in your IDE). To exit the environment run deactivate.
The monarch-app repo uses a Makefile system to facilitate and simplify some of the development setup and deployment tasks. For detailed information on the build targets and details of implementation please refer to the Makefile in the monarch-app directory.
For a quick-start, once the requirements above are met you can install and launch a working local version of the Monarch App with the following commands.
cd monarch-app
make install
monarch solr download
monarch solr start
cd frontend
bun run devOnce these commands are run you should have a working version of the Monarch App running from your local system. Note: You may have to resolve some permissions issues with solr in order to download and start monarch solr.
For detailed information the backend please refer to the README.md and CONTRIBUTING.md file in the backend directory. Additional information can be find in the documentation
More detailed information on frontend development and run options can be found at the frontend README.md and CONTRIBUTING.md files in the frontend directory. Additional information can be found in the documentation
For documentation on deploying to monarch please see the Monarch documentation regarding the release process.