Exabyte API Examples
This repository explains how to perform some of the most common tasks in the Exabyte.io platform through its RESTful application programming interface (REST API)  by virtue of examples. Examples are grouped together by domain (eg. "materials") and are presented in a self-documented format inside Jupyter notebooks . In order to view the content online, navigate to a notebook page inside this repository.
Follow the steps below in order to setup and view the Jupyter notebooks:
git clone email@example.com:Exabyte-io/exabyte-api-examples.git
In case for some reason git-lfs was not installed at the time of cloning, the files can be pulled after subsequent installation later, through
git lfs pull.
pip install virtualenv
Create virtual environment and install required packages:
cd exabyte-api-examples virtualenv .env source .env/bin/activate pip install -r requirements.txt
Run Jupyter and open a notebook in a browser:
cd examples jupyter notebook --config=config.py
In order to run or edit the examples:
Assert an existing Exabyte.io account. Examples require an account to run. New users can register here to obtain one.
Open the desired example notebook, adjust it as necessary and run.
This is an open-source repository and we welcome contributions for other use cases. The original set of examples is only meant to demonstrate the capabilities and can be extended.
We suggest forking this repository and introducing the adjustments there. The changes in the fork can further be considered for merging into this repository as it is commonly used on Github. This process is explained in more details elsewhere online .
If you would like to add new examples or adjust existing ones, please consider the following:
Put examples into the corresponding directories by domain.
Walk the readers through the examples by providing step-by-step explanation similar to this.
We use post-save hooks to automatically convert notebooks to python scripts. See config file for more information. In order to facilitate code review, we exclude notebook sources from version control and store them in Git LFS . Please follow this convention.