Skip to main content
Ganimede provides two command-line tools for running your computational notebooks:

ganimede

The main command to run Ganimede in production mode.
ganimede <file>
file
string
required
Path to the notebook file (.ipynb) you want to open. Can be absolute or relative path.

Example

ganimede notebook.ipynb
ganimede ~/Documents/my-analysis.ipynb

How it works

  • Starts a Starlette/Uvicorn server on 0.0.0.0:8000
  • Initializes a Yjs WebSocket server for collaborative editing on port 1234
  • Sets the NOTEBOOK_LOC environment variable to the absolute path of your notebook
  • Runs without hot reload (production mode)

ganimede_dev

Development mode with hot reload for Ganimede development.
ganimede_dev <file>
file
string
required
Path to the notebook file (.ipynb) you want to open. Can be absolute or relative path.

Example

ganimede_dev notebook.ipynb

How it works

  • Same as ganimede but with additional features:
  • Enables Uvicorn hot reload (automatically restarts server on code changes)
  • Sets the DEV environment variable to "True"
  • Useful for developing and debugging Ganimede itself

Environment Variables

Ganimede uses the following environment variables (set automatically by the CLI):
NOTEBOOK_LOC
string
Absolute path to the notebook file being edited. Set automatically when you run ganimede or ganimede_dev.
DEV
string
Set to "True" when using ganimede_dev. Enables development mode features.

Server Details

  • Web Server: http://0.0.0.0:8000
  • Yjs WebSocket: ws://localhost:1234
  • Log Level: INFO with Rich formatting

Build docs developers (and LLMs) love