mareader
A VS Code extension that opens .parquet files in a Marimo notebook with Polars for interactive data exploration.
How It Works
When you open a .parquet file in VS Code, mareader intercepts the file and launches a Marimo notebook pre-loaded with a Polars workflow to explore the data — no more garbled binary output.
If the Marimo VS Code extension is installed, the notebook opens embedded in VS Code with reactive cells, variable explorer, and datasource panels. Otherwise, it falls back to opening Marimo in your browser via uvx.
Prerequisites
Installation
Install the .vsix file directly in VS Code:
code --install-extension mareader-0.1.0.vsix
Or install from the Extensions view by choosing Install from VSIX....
Configuration
| Setting |
Default |
Description |
parquetViewer.preferEmbedded |
true |
Use the embedded Marimo notebook if the Marimo extension is installed |
parquetViewer.templatePath |
"" |
Custom Python template path (overrides the default Polars template) |
parquetViewer.disableUvIntegration |
false |
Skip uvx and assume marimo is available globally |
Development
npm install
npm run compile
Press F5 in VS Code to launch the Extension Development Host for testing.
License
MIT
