Home

Hydra-Dynamo User Guide

Hydra is a web platform that allows users to share example files from Dynamo directly to the web using GitHub. You can efficiently export your scripts to the Hydra repository using the Dynamo node for sharing and community interaction! There are a number of built in features to help organize, categorize, and preview your files online without having to download to make sure you are getting exactly what you expect.

Installation video coming soon...

Step-by-Step Getting Started Guide

Step 1 – Create an Account

• Visit https://github.com/join
• Fill out the require information to setup a personal account
• Choose your plan (free)

Step 2 – Download Desktop Client

GitHub Desktop provides a fast, easy way to contribute to projects from OS X and Windows

• Visit https://desktop.github.com/
• After installing, go ahead and launch the client
• You will prompted to designate a repository location (by default this points to C:\Users\user\Documents\GitHub)

Step 3 – Fork and Clone!

A fork is a copy of a repository and can be accomplish in two simple steps

• Navigate to the repo at https://github.com/HydraShare/hydra
• In the top-right corner of the page, click Fork (Make sure to select @yourusername)

• Copy your personal forks URL

• Open GitHub client (or other Git client) and select Clone a Repository

• Clone locally using the URL from above

Step 4 – Hydra Node

• Download the Dynamo node by searching for Hydra in the Dynamo Package Manager
• The package manager can be found by navigating to top toolbar->Packages->Search for a Package->"Hydra"
• Select the left most arrow to download the latest build
• Hydra should now appear in the main library on the left (Hydra can also be built/installed from the GitHub repo)

Step 5 - Export

• Add the Hydra node to the workspace from the library
• Fill in all the required fields on the nodes UI (file name, description, version, change log, and tags)
• The directory path should be linked to the location of your hydra fork folder you specified above (ex C:\Users\Keith\Documents\GitHub\Hydra)
• The completed should now look something like the sample below

• Save the your Dynamo graph via the Save or SaveAs menu option (location does not matter)
• Click the Share button located on the node to produce the necessary files locally in your Hydra fork

Step 6 - Push to GitHub

• Return to the GitHub Desktop Client to review the changes to commit to your local Hydra repo

• Push the new files to your online fork

• View the results! (Results may not appear immediately on web repo)