This project is a simple skeleton for easily running iPython Notebooks on your local machine. The goal is to provide a simple way for you to:
- Install and run the iPython Notebook server and all its dependencies
- Create and save notebook files on your local machine
- Easily push and pull your notebooks to your GitHub account
The project is inspired by Matthew Russell's Mining the Social Web, 2nd edition.
Before you start, you'll need to install Vagrant and VirtualBox . Matthew Russell's excellent Appendix A: Virtual Machine Experience provides full details on how to get set up.
Once you've got these installed, first create the virtual machine:
- Clone this repository to your machine. For example, you might put it in "/Users/odewahn/Desktop/ipython-notebook-box"
- "vagrant up" from within the directory and wait a few minutes while all the dependencies are installed
Then, you're ready to run some notebooks. For example, say you want to try out these great Scientific Python Lectures.
- Clone the lecture repo to "/Users/odewahn/Desktop/scientific-python-lectures"
- CD to "/Users/odewahn/Desktop/ipython-notebook-box"
- "vagrant ssh" to login to the box
- From within the box, type "cd /host/". The "/host" directory on the VM maps to the parent directory of where you downloaded the ipython-notebook-box repo. So, if you cloned this notebook into "/Users/odewahn/Desktop/ipython-notebook-box", the "/host" on the VM will map to "/Users/odewahn/Desktop/"
- Type "nbserver", which is an alias to starts the ipython notebook server.
- Open your browser and go to "http://localhost:8888"
Run the command nbserver in the "/host/" directory. (nbserver
If you need to install additional packags To install any additional requirements
pip install -r requirements.txt