compute-tooling / compute-studio

A Utility for Sharing Computational Models
https://compute.studio
Other
15 stars 5 forks source link

Compute Studio

Compute Studio is an open-source platform for sharing models and simulations.

To see Compute Studio in action, visit Compute.Studio.

Principles:

Features:

Under development:

Contributing

Compute Studio is an open source project and anyone can contribute code or suggestions.

You can reach Compute Studio developers to discuss how to get started by opening an issue or joining the Compute Studio Community chat room.

Development process

  1. Download the code: git clone git@github.com:compute-tooling/compute-studio.git
  2. Fetch branches: git fetch origin
  3. Checkout the dev branch: git checkout dev
  4. Checkout the feature branch from this dev branch: git checkout -b my-new-feature
  5. Make some changes and commit them to my-new-feature. When you're ready, open a pull request on the dev branch.
  6. Merge PR to dev branch for testing on https://dev.compute.studio
  7. Repeat process until feature / bug fix is ready.
  8. Deploy to production by opening a PR from the dev to the master branch.

Local Development (the easy way)

This is the easiest way to get up and running with a local compute studio webserver. It requires an existing database (e.g. the test database for dev.compute.studio). With this setup, you can still view the home dashboard and run simulations and apps.

Get the code, install Docker and friends, and install node

  1. Download the code: git clone git@github.com:compute-tooling/compute-studio.git
  2. Fetch branches: git fetch origin
  3. Checkout the dev branch: git checkout dev
  4. Install Docker and Docker Compose:
  5. Install node and yarn:

Set up credentials for database access and run

  1. Copy .env.example to .env and fill in the variables.
  2. Save your google cloud credentials in a file named google-creds.json.
  3. Start the webserver: docker-compose up

Install JavaScript dependencies and run the JavaScript build server

  1. In another terminal window, install JavaScript dependencies: yarn install
  2. Then, run the dev server: yarn start

Checkout the devlopment server at http://localhost:8000 !!!

Local Development (the hard way)

This isn't for the faint of heart, but if you must, here's the guide.

License

Compute Studio is licensed under the open source GNU Affero General Public License to Compute Tooling, Inc.