{"id":33051369,"url":"https://github.com/TheJacksonLaboratory/syntenybrowser","last_synced_at":"2025-11-18T21:01:05.973Z","repository":{"id":36135159,"uuid":"184124752","full_name":"TheJacksonLaboratory/syntenybrowser","owner":"TheJacksonLaboratory","description":"An interactive web-based conserved synteny browser application","archived":false,"fork":false,"pushed_at":"2022-04-12T14:50:59.000Z","size":44324,"stargazers_count":4,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-19T11:49:02.323Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://syntenybrowser.jax.org/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheJacksonLaboratory.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-04-29T18:41:59.000Z","updated_at":"2023-07-14T03:11:37.000Z","dependencies_parsed_at":"2022-08-08T13:16:37.880Z","dependency_job_id":null,"html_url":"https://github.com/TheJacksonLaboratory/syntenybrowser","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/TheJacksonLaboratory/syntenybrowser","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheJacksonLaboratory%2Fsyntenybrowser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheJacksonLaboratory%2Fsyntenybrowser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheJacksonLaboratory%2Fsyntenybrowser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheJacksonLaboratory%2Fsyntenybrowser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheJacksonLaboratory","download_url":"https://codeload.github.com/TheJacksonLaboratory/syntenybrowser/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheJacksonLaboratory%2Fsyntenybrowser/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":285138471,"owners_count":27121052,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-18T02:00:05.759Z","response_time":61,"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":[],"created_at":"2025-11-14T03:00:27.111Z","updated_at":"2025-11-18T21:01:05.967Z","avatar_url":"https://github.com/TheJacksonLaboratory.png","language":"JavaScript","funding_links":[],"categories":["Comparative"],"sub_categories":[],"readme":"# JAX Synteny Browser\nAn interactive web-based conserved synteny browser application, The Jackson Laboratory (JAX) Synteny Browser. The browser \nallows researchers to highlight or selectively display genome features in the reference and/or the comparison genomes \nbased on the biological attributes of the features. The current implementation for the browser supports the reference \ngenomes of the laboratory mouse and human.\n\nThere is a live, working version of Synteny Browser available at: [syntenybrowser.jax.org](http://syntenybrowser.jax.org/)\n\nUser documentation can be found [here](http://syntenybrowser.jax.org/static/docs/SB-UserManual_v1.pdf).\n\n# Setting up/Running Synteny Browser Locally\n### Prerequisites\n*Note: if you are running Windows some of the commands below might need to be altered* Before starting the setup process,\nyou'll need:\n\n1. A bash terminal (Mac OS X \u0026 Linux will have this included) or a way of running shell scripts\n2. A version of Python installed on your machine\n3. The `pip` Python library installed on your machine (your version of Python might have Pip included by default, but if\nnot, you'll have to install it manually)\n\nAssuming you have all of the above items, you'll need a Python library called Virtualenv which will allow you to run\nPython scripts in isolated environments that can have their own dependencies, versions, and permissions without messing\nwith those belonging to your machine. To set up Virtualenv open up a bash and navigate to the root `syntenybrowser/`\ndirectory (all of the following commands are run from this directory unless otherwise noted) and install Virtualenv:\n\n    pip install virtualenv\n    \n*Note: if you're running Python 3, you may have to run `pip3 install virtualenv`.*\n\n\n### Getting a Database\nOnce Virtualenv is installed, you'll need a database. To do this, you have two options:\n\n#### Option 1: Download a preloaded database\nA ready-made database is available from Box [here](https://thejacksonlaboratory.box.com/s/i7ru2r9mx2dmzx5m0mbb5w80l6ovd6az)\nnamed 'syntenybrowser-db.zip' and, when decompressed, will yield a file named 'synteny.db'. **This .db file will need to be\nlocated in the root `syntenybrowser/` directory before running the application, otherwise the application will not run.**\n\n#### Option 2: Load a database yourself\n*(if you went with Option 1, skip to 'Setting Up the Application')* To load your own database, you'll need a virtual\nenvironment that runs in Python3.6:\n\n    virtualenv venv-db -p python3.6\n\nOnce created, activate the virtual environment:\n\n    . venv-db/bin/activate\n\nInstall necessary packages:\n\n    pip install -r requirements.txt\n\nRun the database creation script with the required parameter:\n\n    ./create_database.sh synteny.db\n\n*Note: we have found that one of the scripts that queries data from an API can run into issues if you are using a VPN*\nThis will take several minutes and when it's finished, it will yield a file named 'synteny.db' in root `syntenybrowser/`\ndirectory (the database file needs to be located here so don't move it). Shut down the `venv-db` virtual environment:\n\n    deactivate\n\n\n### Setting Up the Application\nNext, you'll need to get the application running using your new database (if you're at this step and haven't gotten a\ndatabase using one of the two available options listed above, you'll need to do that first). To do this, we'll need a\nseparate virtual environment that runs in Python2.7:\n\n    virtualenv venv-app -p python2.7\n    \nOnce created, activate the virtual environment:\n\n    . venv-app/bin/activate\n    \nInstall necessary packages:\n    \n    pip install -r requirements.txt\n\n\n### Running the Application\nMake sure the the application virtual environment is running. If it isn't, start it up (if it is, skip to the next step):\n\n    . venv-app/bin/activate\n\nRun the application:\n\n    python runserver.py\n\nWhen finished, shut down the virtual environment:\n\n    deactivate\n\n\n# Running the Synteny Browser from the Docker Image\n### Prerequisites\n1. A bash terminal (Mac OS X \u0026 Linux will have this included) or a way of running shell scripts\n2. Docker installed on your machine \n\n### Pull the image\nStart docker on your machine and once running, pull the image using\n\n    docker pull lamoua/synbrowser\n\nOnce the image is done pulling from DockerHub, run the container\n\n    docker run -p 5001:5001 synbrowser:latest\n\nThis should set off the container as well as start the Python Flask server. Navigating to the specified location (which should be localhost:5001 by default), should bring you to the JAX Synteny Browser interface running from the container. \n\n\n## Citation\n**The JAX Synteny Browser for Mouse-Human Comparative Genomics.**\n\nManuscript in review\n\n## License\nThe JAX Synteny Browser is provided under the license found [here](LICENSE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTheJacksonLaboratory%2Fsyntenybrowser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FTheJacksonLaboratory%2Fsyntenybrowser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTheJacksonLaboratory%2Fsyntenybrowser/lists"}