Skip to content

Latest commit

 

History

History
125 lines (92 loc) · 5.13 KB

README.md

File metadata and controls

125 lines (92 loc) · 5.13 KB

FROG

Visit our blog to see pedagogical scenarios, as well as technical and research updates.

Fabricating and running orchestration graphs. To learn more about the design and architecture, visit our wiki.

You can test FROG at https://chilifrog.ch.

Videos

Graph editor

Example of student screens (four different students)

Short video demo

FROG%20video

(more examples, and videos, on the wiki)

Set up

  • clone the git repository

  • go to the root repository

  • install Meteor

  • make sure you have a recent version of Node (at least 9.10) (if you have node, but not the latest, you can try npm install -g n; n latest

  • run the commands

    • ./initial_setup.sh (if problem occur with bcrypt you can try to run meteor npm install --python=python2.7 from the frog/ directory)

    • add the following lines to your /etc/hosts:

    127.0.0.1 learn.chilifrog-local.com
    127.0.0.1 chilifrog-local.com
    
    • go to the frog/ directory and run meteor (or run npm start server from any directory)

    • see more developer scripts and details here

  • Connect to FROG by typing in your browser

Troubleshooting initial setup

  • Make sure Meteor works (meteor --version) (note that the Meteor version is not important, Meteor will automatically download and install the correct version when run the first time)
  • Make sure you have an up-to-date version of Node 12 (node --version), and that npm works (npm --version -- will not be the same as the Node version)
  • We do not support Windows - you might be able to get it to run, but all of our scripts etc, presume MacOS/Linux
  • All scripts (./initial_setup.sh etc should be run as user, not root)
  • Make sure you have enough disk-space, and that no other processes are listening to ports 3000, 3001 and 3002. (The need to expose these ports means that FROG will not work easily with ngrok, which only exposes a single port -- 3000 and 3002 need to be exposed).
  • If you need to re-run ./initial_setup.sh, execute these commands first. (Note that this deletes any file that has not been checked in and committed). It will also remove clean all Mongo collections (i.e all graphs and activities that have not been sent to the cloud library): git reset --hard; git clean -fdx; ./initial_setup.sh
  • Some warnings when you start Meteor like missing bcrypt, hiredis etc are OK, as long as the following lines are displayed:
=> Started your app.

=> App running at: http://localhost:3000/

Development

  • Learn Meteor framework with React: https://www.meteor.com/tutorials/react/creating-an-app

  • Note that we use yarn extensively. Unfortunately, we currently need to symlink all the packages from the root node_modules directory into frog/, because of a problem with Meteor. This means a specific workflow:

    • to update dependencies after pulling or switching to another branch, run npm start yarn
    • to add dependencies or do other yarn actions, first do npm start unlink, then do your actions, and then npm start link to be able to run the server again

Code style/testing

  • We use prettier for Javascript formatting, all pull-requests must be formatted accordingly.
  • We use ESLint for testing syntax.
  • We use Jest for tests.
  • We use Flow for type checking.

All PRs should pass all tests (npm start test in the repository root directory).

Licensing

The main FROG program (in the frog/ directory) is licensed under the GNU Affero General Public License 3.0 (or, at your option, a later version). The licenses of all other packages may be found in their respective directories (LICENSE files in each sub-directory). While the main application is AGPL, we generally license more broadly applicable libraries, as well as specific learning activities, under permissive licenses such as the ISC license to facilitate their reuse in other systems. Please Contact us if you have any questions about licensing.