# Overview

The following demonstration documents a step-by-step guide to setting up a virtual “Econometrics Lab” hosted by [Amazon Web Service (AWS)](https://aws.amazon.com/), one of many cloud computing providers. Ultimately, students will be able to connect to an environment to perform live coding on [Jupyter Notebooks](https://jupyter.org/) with [Python](https://www.python.org/psf/), [R](https://www.r-project.org/foundation/), and [Stata](https://www.stata.com/) kernels.

This demonstration corresponds to workflow 3 outlined in “*Econometric Pedagogy and Cloud Computing: Training the Next Generation of Economists and Data Scientists*,” by  [Danielle V. Handel](https://daniellehandel.org/), [Anson T. Y. Ho](http://www.atyho.info/), [Kim P. Huynh](https://www.bankofcanada.ca/profile/kim-huynh/), [David T. Jacho-Chávez](https://www.davidjachochavez.org/), and [Carson H. Rea](https://www.carsonrea.org/) published in the [***Journal of Econometric Methods***](https://www.degruyter.com/view/journals/jem/jem-overview.xml). The instructions may be modified to suit different teaching styles and classroom needs.

### Functionality

This section showcases a fully operational server and the optional GitHub integration.

**Standard Functionality**

![](https://2920288544-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDG8rOchFn0FENiplhZ%2F-MDGYTkmxcT6uRhJio9v%2F-MDGcx80fwNi8VCYdL34%2Fbase_functionality.gif?alt=media\&token=ecb520fc-b559-45be-86f7-d00f897c8fbe)

After entering the lab with a pre-assigned username and password, students may generate new Jupyter Notebooks using Python, R, or Stata. They also may upload notebooks from their local machine or clone repositories from [GitHub](https://github.com/) and work on those. None of this requires installation of any software on the local machine.

**(Optional) GitHub Integrated Functionality**

Demonstrated below is the additional functionality granted by following the optional sections, [GitHub Extensions and Packages](https://docs-jupyter.davidjachochavez.org/optional-github-extension-and-packages/github-extension) and [GitHub Authentication](https://docs-jupyter.davidjachochavez.org/optional-github-authentication/add-github-authentication).

![](https://2920288544-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDG8rOchFn0FENiplhZ%2F-MDGYTkmxcT6uRhJio9v%2F-MDGeGduLEEI2y9Mu27J%2FloginGitHubDemo.gif?alt=media\&token=46b92ce9-702d-47c8-a0a0-90dc1af244c0)

A student with their free GitHub account setup can select the "Sign in with GitHub" to be prompted to authorize the server to use GitHub when logging in. After selecting the button to authorize, the student will be directed to the JupyterHub interface and may begin working.

![](https://2920288544-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDG8rOchFn0FENiplhZ%2F-MDGYTkmxcT6uRhJio9v%2F-MDGeRDR35oTZtV9UevB%2FdjachocGitHubDemo.gif?alt=media\&token=8ea5f917-b0b4-4db3-8c99-0babfe66a4af)

The GitHub extension allows the student to access repositories as demonstrated above. By typing in a username, the student will be granted access to all of the *public* repositories that person has. A students can gain access to assignments directly from their instructor's GitHub.


---

# 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://docs-jupyter.davidjachochavez.org/master.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.