orion-notebook
Python launcher for Orion. Installs the orion command on PyPI.
Orion also publishes orion-ui on PyPI — the Python library for notebook UI components (import orion_ui as ui). You do not install it separately when using Orion's managed Jupyter runtime; Orion syncs orion-ui==<version> into ~/.orion/runtime/venv automatically.
Install
pip install orion-notebook
orion
The website one-liner may also install this package with uv tool install when npm and pip are unavailable.
What happens on first run
The PyPI wheel is intentionally small. When you run orion for the first time, the CLI may:
- Download the Orion app bundle into
~/.orion/app/<version>from a GitHub release - Download portable Node.js 20+ into
~/.orion/runtime/node/<version>if Node is not installed - Create an Orion-managed Jupyter venv under
~/.orion/runtime/venvif no compatible Jupyter is found (includes Jupyter, ipykernel, andorion-ui)
Each step prompts for consent unless you pass --yes:
orion --yes
Managed Jupyter is installed only inside Orion's venv, not into your global Python.
After the first successful setup, later runs start Jupyter, launch Orion, and open your browser much faster.
Requirements
- Python 3.8+ for direct
pip install; the website installer can use uv-managed Python when needed - Node.js 20+ (downloaded automatically into
~/.orion/runtime/nodewhen missing)
Flags
orion --yes # auto-approve setup prompts
orion --no-browser # start services without opening a browser
orion uninstall # remove cached app bundle for this version (~/.orion/app/<version>)
orion uninstall --all --yes # remove entire ~/.orion directory
Uninstall
pip uninstall orion-notebook removes the Python launcher only. It does not delete the app bundle downloaded into ~/.orion/app/<version>/. Run this first:
orion uninstall --yes
pip uninstall orion-notebook
# or, if installed by the website uv fallback:
uv tool uninstall orion-notebook
To remove all Orion-managed data (Jupyter venv, portable Node, every cached app version):
orion uninstall --all --yes
Environment variables
| Variable | Purpose |
|---|---|
ORION_HOME_DIR |
Override Orion data root (default: ~/.orion) |
ORION_APP_BUNDLE_URL |
Override app bundle download URL |
ORION_PORT |
Orion app port (default: 3001) |
Default app bundle URL:
https://github.com/nicolasakf/Orion-app/releases/download/v<version>/orion-app-<version>.tar.gz
npm install (recommended)
Both npm and PyPI publish under the name orion-notebook. If you already have Node.js 20+, npm is simpler because it ships the app bundle directly:
npm install -g orion-notebook
orion
See the main README and Contributing for publishing and development details.
1 maintainer
Metadata
1 maintainer
Release files for orion-notebook 0.20.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| orion_notebook-0.20.2.tar.gz | 28.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| orion_notebook-0.20.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 45.9 kB
Release files / orion_notebook-0.20.2.tar.gz
| Download URL | orion_notebook-0.20.2.tar.gz |
|---|---|
| Size | 28.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9259027d63f3becb247c7a563db6a97367910a024c5dd879cebbf51a46e15ac3
|
|
BLAKE2b-256 checksum How to use checksums |
73114c9088799780c055df3229395724cb0ab9c3aa8018a2f1350fe6ee322675
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Release files / orion_notebook-0.20.2-py3-none-any.whl
| Download URL | orion_notebook-0.20.2-py3-none-any.whl |
|---|---|
| Size | 17.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f50af7ef4d46f84acd6d5176c8cdb6a452a9d8683f88a7f8d9dd5620acd78efa
|
|
BLAKE2b-256 checksum How to use checksums |
0af3c76adc3816ad96fdb1dcb30be3de2e17d024b4ab832272d88501b0e6f6a9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
