Sharing in Wakari

Public and Private

Wakari supports both public and private sharing.

IPython Notebooks

You can create, view, and share IPython Notebooks in Wakari.

To share a particular IPython Notebook, select the IPython Notebook file you want to share in the file browser on the left-hand side, and then hit the share button.

wakariui

A dialog box will pop up. Enter the name and description for the notebook you are sharing. You also have the option to share the Anaconda Environment with your notebook. Sharing a particular Anaconda Environment will make it easier for others to execute your notebook successfully. It assures they are running the notebook with the same packages that you did. If you do not enter a password, your notebook will be public. If you enter a password, your notebook will be password protected. When you are finished configuring your notebook for sharing, click the Submit button in the lower right-hand corner.

wakariui

Another dialog box will pop up showing Sharing Status, with a button to Terminate. Sharing an IPython Notebook with an Anaconda environment typically takes some time, so please be patient.

wakariui

When your IPython Notebook is ready to be shared, the dialog box will include a Link to the bundle option. Copy the URL and email it to a friend. Using the link, your friend can view your notebook. They will not be able to change your version of the notebook, but they can make a copy of the notebook into their Wakari account and modify the copy.

wakariui

Bundles

A bundle is a group of files that can be shared with other Wakari users.

Wakari bundles enable collaborative data analysis from data to insight. Bundles can be thought of as git repositories with some added metadata. This enables us to share IPython Notebooks, python scripts, images and data.

There are two ways to bundle and share files with Wakari. In both cases, you will first need to create a directory and place all the files you want to bundle into that directory.

To bundle a directory of files, execute wk bundle directoryname in a shell terminal at the command prompt.

wakariui

To bundle individual IPython Notebooks, make sure the files you want to bundle are in their own directory. In a shell terminal at the command prompt, navigate into that directory and then execute wk bundle name_of_first_notebook name_of_second_notebook.

wakariui

Once your bundle is created, you can share your files using either a shell terminal or the Share button in the file browser.

To share using the Share button, select (but do not open) the folder you wish to share in the file browser and click on the Share button.

wakariui

A dialog box will pop up. Enter the name and description for the bundle you are sharing. You also have the option to share the Anaconda Environment with your bundle. Sharing a particular Anaconda Environment will make it easier for others to execute your bundle successfully because it ensures that they are running your bundle with the same packages that you did.

wakariui

By default, all bundles that you publish are accessible by anyone. If you do not want your bundle to be public, you can set up a password for your bundle in the dialog box. Anybody who clicks on the link to your bundle will now be prompted for a password.

When you are finished configuring your notebook for sharing, click the Submit button in the lower right-hand corner.

When your bundle is ready to be shared, the dialog box will include a Link to the bundle. Copy the link URL and email it to a friend.

wakariui

To share in the terminal, execute wk publish at the command prompt.

wakariui

You can password protect your bundle in the terminal by using the wk sharing command. Simply execute wk sharing -p yourpassword using a password of your choice. Your bundle link will now prompt for a password first. Keep in mind that your bundle will be public if you do not set up a password.

wakariui

Using the link, your friend can view your notebook. They will not be able to change your version of the notebook, but they can copy the notebook into their Wakari account and modify the copy.

wakariui

If your bundle is password protected, anybody who clicks on the link will be prompted for a password.

wakariui

See this blog for another example of creating a bundle: Superbowl Squares.

Download Files

You can easily download any files from your Wakari account to your local computer using the download controls in the file browser. Just select the file you want to download and press the download button (the down arrow).

wakariui