Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/donjayamanne/vscodejupyter
Jupyter for Visual Studio Code
https://github.com/donjayamanne/vscodejupyter
ipython ipython-notebook jupyter jupyter-notebook linux osx vscode
Last synced: about 4 hours ago
JSON representation
Jupyter for Visual Studio Code
- Host: GitHub
- URL: https://github.com/donjayamanne/vscodejupyter
- Owner: DonJayamanne
- License: mit
- Archived: true
- Created: 2016-11-21T08:34:11.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2020-11-02T22:40:58.000Z (almost 4 years ago)
- Last Synced: 2024-09-27T23:23:42.693Z (about 4 hours ago)
- Topics: ipython, ipython-notebook, jupyter, jupyter-notebook, linux, osx, vscode
- Language: TypeScript
- Homepage: https://marketplace.visualstudio.com/items?itemName=donjayamanne.jupyter
- Size: 1.22 MB
- Stars: 334
- Watchers: 18
- Forks: 34
- Open Issues: 90
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Deprecated
This extension is no longer being maintained and all of its functionality has been (or will be) placed into the [Microsoft Python extension](https://marketplace.visualstudio.com/items?itemName=ms-python.python).
Please download the Microsoft Python Extension instead.
Feel free to submit new [issues](https://github.com/Microsoft/vscode-python/issues/new) or feature requests on the Microsoft Python Extension.
# Jupyter
An extension with rich support for [Jupyter](http://jupyter.org/)
## Quick Start
* Install the extension
* When using Python, install the [Microsoft Python extension](https://marketplace.visualstudio.com/items?itemName=ms-python.python) as well.
* Install [Jupyter](http://jupyter.org/install.html)
+ You're ready to use it.
## Sample Python usage
* Create a Python file with the following text
```python
#%%
import matplotlib.pyplot as plt
import matplotlib as mpl
import numpy as np
x = np.linspace(0, 20, 100)
plt.plot(x, np.sin(x))
plt.show()
```
* Click on the code lens ```Run Cell```
## Run Cell Hot key as in Chrome
* If you want to run cell with Ctrl+Enter, add those code in keybindings.json.
```json
{ "key": "ctrl+enter", "command": "jupyter.execCurrentCell",
"when": "editorTextFocus"
}
```
## Connect to Remote Jupyter kernel on Server / Docker
Try this to connect to a remote Jupyter kernel running on a server, or inside Docker container:
1. Make sure Jupyter, Notebook, and jupyter_kernel_gateway packages are installed. They are all included by default in Anaconda installation, but if you are using PIP you may need to install them manually.
1. Run following commands on Linux: (Windows users will need to adapt these commands for their env)
```
# Generate config file for KernelGateway
jupyter kernelgateway --KernelGatewayApp.generate_config=True
# Generate config for Jupyter Notebook
jupyter notebook --generate-config --allow-root
# Append appropriate values to both config files
echo -e "c.JupyterWebsocketPersonality.list_kernels = True" >> ~/.jupyter/jupyter_kernel_gateway_config.py
echo -e "c.NotebookApp.allow_root = True" >> ~/.jupyter/jupyter_notebook_config.py
```
1. Start a remote Jupyter Notebook or headless KernelGateway
1. Find the token in the output of the Jupyter server logs: http://jupyter-notebook.readthedocs.io/en/latest/security.html
Then in VS Code:
1. ctrl+shift+p
1. Jupyter: Enter the url of local/remote Jupyter Notebook
1. Select existing kernels from the drop-down list, or start a new kernel
1. Select language for the kernel from drop-down list: e.g., "Python 3"
## [Documentation](https://github.com/DonJayamanne/vscodejupyter/wiki)
For further information and details continue through to the [documentation](https://github.com/DonJayamanne/vscodejupyter/wiki).
## [Issues, Feature Requests and Contributions](https://github.com/DonJayamanne/vscodejupyter/issues)
* Contributions are always welcome. Fork it, modify it and create a pull request.
* Any and all feedback is appreciated and welcome.
## [Roadmap](https://github.com/DonJayamanne/vscodeJupyter/wiki/Roadmap)
### Version 1.1.3 (5 May 2017)
* Notebook not detected [#46](https://github.com/DonJayamanne/vscodeJupyter/issues/46)
### Version 1.1.2 (24 April 2017)
* Fix high CPU usage [#40](https://github.com/DonJayamanne/vscodeJupyter/issues/40)
### Version 1.1.1 (13 April 2017)
* Bug fix (extension fails to load)
* Increase timeout waiting for Jupyter Notebook to start
### Version 1.1.0 (12 April 2017)
* Preliminary support for older versions of Jupyter Notebook (< 4.2.0)
## Source
[GitHub](https://github.com/DonJayamanne/vscodejupyter)
## License
[MIT](https://raw.githubusercontent.com/DonJayamanne/vscodejupyter/master/LICENSE)