# Notebook Binders, Pullers, and Viewers

**Binder:** To use Binder, go to this site <https://mybinder.org/> and paste in a copy of your Github repo with your notebooks. Read the notes on the site to figure out how to make this work. For instance, you need a file called requirements.txt that lists the Python packages that are needed to run.

Mybinder will give you something to copy, that looks like this:

```
[![Binder](https://mybinder.org/badge.svg)](https://mybinder.org/v2/gh/mlamoureux/Callysto/master)
```

Paste that into a markdown cell. The result is a button that you can click on, like this:

[![Binder](https://mybinder.org/badge.svg)](https://mybinder.org/v2/gh/mlamoureux/Callysto/master)

The notebook is then "live." You can edit it, make changes, run it. But it only exists ephemerally, which means it will disappear after some time. But, you can always download it directly onto your machine.

**GitHub:** GitHub will let you view a Jupyter notebook directly, but it doesn't actually run. Just type in the link in Markdown, like this: <https://github.com/mlamoureux/Callysto/blob/master/ASimplePlot.ipynb>

**Puller:** Under development.

**Viewer:** nbviewer lets you see a rendered Jupyter notebook, but it is not "live." That is, you can't make any changes. To use it, you take the web address `http://nbviewer.ipython.org/` and tack onto the end `url/` and the address of your notebook. Something like this:

<http://nbviewer.ipython.org/url/github.com/mlamoureux/Callysto/blob/master/ASimplePlot.ipynb>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://training.callysto.ca/extensions/nbviewers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
