Awesome
Hydrogen <img src="https://cdn.jsdelivr.net/gh/nteract/hydrogen@17eda24547a2195b4a21c883af3dd12ec50bd442/static/animate-logo.svg" alt="hydrogen animated logo" height="50px" align="right" />
Hydrogen is an interactive coding environment that supports Python, R, JavaScript and other Jupyter kernels.
Checkout our Documentation and Medium blog post to see what you can do with Hydrogen.
Atom Sunset Notice
Atom is sunsetted. It is not possible to publish new packages anymore. If you have Atom working offline locally, it should continue to work, but the servers are down.
You can export ipynb from Hydrogen using this method and migrate to the following alternatives:
-
Nteract, which is directly inspired by Hydrogen. https://nteract.io/
-
VsCode with its Jupyter integration https://code.visualstudio.com/docs/datascience/jupyter-notebooks
-
Pycharm with Jupyter Notebook integration https://www.jetbrains.com/pycharm/
Contents
- Background
- Features
- Plugins for Hydrogen
- Useful external packages
- How it works
- Why "Hydrogen"?
- Contributing
- Changelog
- License
Background
Hydrogen was inspired by Bret Victor's ideas about the power of instantaneous feedback and the design of Light Table. Running code inline and in real time is a more natural way to develop. By bringing the interactive style of Light Table to the rock-solid usability of Atom, Hydrogen makes it easy to write code the way you want to.
You also may be interested in our latest project – nteract – a desktop application that wraps up the best of the web based Jupyter notebook.
Features
- execute a line, selection, or block at a time
- rich media support for plots, images, and video
- watch expressions let you keep track of variables and re-run snippets after every change
- completions from the running kernel, just like autocomplete in the Chrome dev tools
- code can be inspected to show useful information provided by the running kernel
- one kernel per language (so you can run snippets from several files, all in the same namespace)
- interrupt or restart the kernel if anything goes wrong
- use a custom kernel connection (for example to run code inside Docker), read more in the "Custom kernel connection (inside Docker)" section
Documentation
Plugins for Hydrogen
Hydrogen has support for plugins. Feel free to add your own to the list:
- Hydrogen Launcher: launches terminals and Jupyter consoles connected to Hydrogen
- hydrogen-python: provides various Python-specific features
- Data Explorer: allows you to use nteract data-explorer within Hydrogen
If you are interested in building a plugin take a look at our plugin API documentation.
Useful external packages
Here is a list of external packages that could be useful when using Hydrogen (without using Hydrogen plugin API, as such they're mostly only related to the UIs):
- markdown-cell-highlight: highlights code cells in markdown files
- Cell Navigation: enables easy jumps between Hydrogen code cells
- Hydrogen Cell Separator: gives simple horizontal line decorations for Hydrogen code cells
If you find/create a package that you think can be useful when used in combination with Hydrogen, feel free to make a PR and add it.
How it works
Hydrogen implements the messaging protocol for Jupyter. Jupyter (formerly IPython) uses ZeroMQ to connect a client (like Hydrogen) to a running kernel (like IJulia or iTorch). The client sends code to be executed to the kernel, which runs it and sends back results.
Why "Hydrogen"?
Hydrogen atoms make up 90% of Jupiter by volume.
Plus, it was easy to make a logo.
Contributing
Thanks for taking the time to contribute. Take a look at our Contributing Guide to get started.
Then, take a look at any issue labeled good first issue or help wanted that has not been claimed. These are great starting points.
Changelog
Every release is documented on the GitHub Releases page.
License
This project is licensed under the MIT License - see the LICENSE.md file for details