/compute.rhino3d.appserver

A node.js server for solving Grasshopper definitions on Rhino Compute

Primary LanguageJavaScript

GitHub package.json version node-current (scoped)

Rhino Compute AppServer

A node.js server acting as a bridge between client apps and private compute.rhino3d servers.

This app is intended to host one or more custom grasshopper definitions and serve as the API that client applications can call to have definitions solved with modified input parameters.

Features

  • Easy to get started: fork/clone this repo and run it locally for testing or push to a service like Heroku for a production web server
  • Easy to customize: fork this repo, place your custom grasshopper definitions in the files directory and you now have a custom AppServer for your definitions.
  • Caching: Assuming definitions produce the same results when the same set of inputs are provided, the appserver caches all results in memory for faster response times.
  • Timings: Server-timing headers are returned to the client to help diagnose bottlenecks in the definition solving process.

Getting Started

  1. Fork this repo
  2. Follow the installation guide to test and debug on your computer
  3. Follow the Heroku hosting guide to push your customized AppServer to Heroku for a production web server

How and What Video

A workshop on using the appserver can be found at https://vimeo.com/442079095 - also slides

Example

When we have our testing server up and running, you can visit

https://compute-rhino3d-appserver.herokuapp.com/example/

To see a sample web application that passes three numbers based on slider positions to the AppServer for solving a grasshopper definition. Results are returned to the web page and new mesh visualizations are created.


Other Information