ToyboxAgents depends on both the core Toybox package and the intervention API, found in the Toybox testing repository. We recommend running with a virtual environment and installing via pip:
pip install -r REQUIREMENTS.txt
We recommend you to try to install ujson:
pip install ujson
We have observed installation issues on OSX Catalina; if you get a linker error for ujson library, you can try running with the CFLAGS argument:
CFLAGS=-stdlib=libc++ pip install ujson
If this does not work, the code will simply default back to the existing json library.
Once you load up your virtual environment, you can see usage, e.g., via python -m agents, executed from the top-level directory. The Tutorials page in the wiki has detailed information on how to run things. Note that wiki pages can be downloaded for offline perusal.
If you are using the browser-based IDE, navigate to this directory and execute jupyter notebook raw_data.ipynb.
If you are using VS code, you will need to set the notebook file root. For VS Code version 1.43.1 on a Mac, this involved following the menu options:
Code > Preferences > Settings
and searching for "Notebook root". The first hit should be "Python > Data Science: Notebook File Root". Set this to be ${workspaceFolder}/analysis.