A marimo Wrapper.

Because

# %%

x = 1

# %%

print(x)

is easier to deal with than

@app.cell()
def _():
    x = 1


@app.cell()
def _():
    print(x)  # the type checker hates this too!

• Convert Python scripts having cell delimiters (e.g., # %%; see config) into marimo's format:

  $ marimow convert notebook.py output.py

• Edit a python file in any editor and marimoW will convert it to marimo's format on every write, so that it can live reload it in the browser frontend.

  $ marimow edit [OPTIONS] notebook.py

  This is equivalent to marimo edit --watch [OPTIONS] .marimow_cache/notebook.py, where .marimow_cache/notebook.py is in marimo's format.

$ cargo install --git https://github.com/adityasz/marimow

• The cell delimiter can be configured in the config file.

• The first cell is the setup cell:

  import numpy as np
  
  # %%
  
  x = np.array([1, 2, 3])

  gets converted to

  import marimo
  
  app = marimo.App()
  
  with app.setup:
      import numpy as np
  
  
  @app.cell
  def _():
      x = np.array([1, 2, 3])
  
  
  if __name__ == "__main__":
      app.run()

• If you don't want a setup cell, keep the first cell blank:

  # Each `# %%` starts a new cell.
  #
  # Cells only containing whitespaces and comments are ignored (there are better
  # ways to add text to a marimo notebook than to add a cell with comments).
  # %%
  
  x = np.array([1, 2, 3])  # comments are preserved
  
  # %% everything after the cell delimiter is ignored
  
  print(x)

  gets converted to

  import marimo
  
  app = marimo.App()
  
  
  @app.cell
  def _():
      x = np.array([1, 2, 3])  # comments are preserved
  
  
  @app.cell
  def _():
      print(x)
  
  
  if __name__ == "__main__":
      app.run()

marimoW loads its config from ${XDG_CONFIG_HOME:-$HOME/.config/marimow}/marimow/config.toml.

The default config is

cache_dir = ".marimow_cache"
cell_delimiter = "# %%"
debounce_duration = 50 # milliseconds