Skip to content

UnicoLab/flowyml-notebook

🌊 FlowyML Notebook

FlowyML Notebook Logo
The Reactive Notebook That Ships to Production

Tests PyPI Version Python 3.10+ License UnicoLab


FlowyML Notebook is a reactive, DAG-powered notebook environment that replaces Jupyter for production ML workflows. Write pure Python cells, get automatic dependency tracking, and ship directly to pipelines, dashboards, and apps β€” without changing a single line of code.

FlowyML Notebook β€” Full Editor View
Reactive notebook editor with code cells, variable explorer, and full toolbar


πŸš€ Why FlowyML Notebook?

Feature Jupyter Deepnote Marimo FlowyML Notebook
Reactive DAG Execution ❌ ❌ βœ… βœ…
Pure .py File Storage ❌ ❌ βœ… βœ…
Git-Native Collaboration ❌ ⚠️ Cloud ❌ βœ… GitHub
Pipeline Integration ❌ ❌ ❌ βœ… FlowyML
Reusable Recipes ❌ ❌ ❌ βœ…
One-Click Deploy ❌ ⚠️ Cloud ❌ βœ…
SQL First-Class ❌ βœ… βœ… βœ…
AI Assistant ❌ βœ… ❌ βœ…
Rich Data Explorer ❌ βœ… βœ… βœ…
App Mode ❌ ❌ βœ… βœ…
Self-Hosted βœ… ❌ βœ… βœ…
SmartPrep Advisor ❌ ❌ ❌ βœ…
Algorithm Matchmaker ❌ ❌ ❌ βœ…
Interactive Dashboards ❌ ❌ ❌ βœ…
Analysis Patterns ❌ ❌ ❌ βœ…
Keras Ecosystem ❌ ❌ ❌ βœ… UnicoLab

⚑ Quick Start

# Install the core package
pip install flowyml-notebook

# Or install with all ML & AI extensions
pip install "flowyml-notebook[all]"

# Or install with Keras ecosystem (KDP + KerasFactory + MLPotion)
pip install "flowyml-notebook[keras]"
fml-notebook dev    # πŸ”₯ Hot-reload development mode
fml-notebook start  # πŸš€ Production build

The browser opens automatically. You're ready to build.


🌟 Features

πŸ“Š Rich Data Exploration

Every DataFrame gets automatic profiling β€” statistics, distributions, correlations, quality checks, and ML-ready insights. No extra code needed.

Data Exploration β€” Statistics
Automatic DataFrame profiling with column statistics, type detection, and memory impact

Data Exploration β€” Charts
Interactive charts for every column β€” histograms, bar charts, and distribution analysis

Data Exploration β€” Correlations
Pearson correlation matrix with color-coded heatmap for quick feature analysis

ML Insights β€” Recommendations
Automated ML insights: outlier detection, scaling recommendations, and target variable suggestions


πŸ”„ Reactive DAG Engine

Cells are nodes in a dependency graph. Change a variable, and only dependent cells re-execute β€” automatically. Visualize the full pipeline with the built-in DAG view.

Pipeline DAG View
Visual dependency graph showing data flow: imports β†’ data_generation β†’ analysis β†’ exploration β†’ summary


πŸ¦„ UnicoLab Keras Ecosystem β€” NEW in v1.3

Native integration with the UnicoLab ML ecosystem β€” KDP, KerasFactory, and MLPotion. All packages are optional and auto-detected.

Package What It Does Integration Point
KDP Keras preprocessing layers with distribution-aware encoding SmartPrep Advisor
KerasFactory 38+ reusable Keras layers and production-ready model architectures Algorithm Matchmaker
MLPotion Managed training pipelines with type-safe configuration Algorithm Matchmaker

When all three are installed, the Algorithm Matchmaker surfaces a flagship end-to-end pipeline: KDP β†’ KerasFactory β†’ MLPotion β€” preprocessing, model building, and training in a single deployable Keras model.

# Install the full ecosystem
pip install "flowyml-notebook[keras]"

4 new builtin recipes are also included: KDP Smart Preprocessing, KerasFactory Quick Model, MLPotion Training Pipeline, and the UnicoLab End-to-End Pipeline.


🧾 Recipes β€” Reusable Code Templates

Stop rewriting boilerplate. 43 built-in recipes across Core, Assets, Parallel, Observability, Evals, Data, ML, Visualization, and Ecosystem categories. Drag into your notebook or click to insert.

Recipes Panel
Searchable recipe library with FlowyML Step, Pipeline, Conditional Branching, and more


πŸ’¬ Comments & Review

Collaborate directly in the notebook with inline comments and a review panel. Add notebook-level or cell-level annotations for team discussions.

Comments Panel
Comments panel with threaded discussions, resolve/reply actions, and scatter plot output


πŸ“„ Reports β€” One-Click Export

Generate beautiful HTML or PDF reports from your notebook. Optionally include source code cells alongside outputs. Preview in browser, then download.

Generate Report Dialog
Report generation with HTML/PDF format selection, code inclusion toggle, and instant preview


🌐 Publish as App

Turn any notebook into an interactive web application with one click. Choose layout (Linear, Grid, Tabs, Sidebar, Dashboard), theme, and cell visibility.

Publish as App Dialog
Publish dialog with layout options, dark/light/auto theme, source code toggle, and per-cell visibility


πŸš€ Production β€” Pipelines, Deploy & Assets

Ship notebooks directly to production. Promote to pipeline, deploy as API/Docker/Batch, track kernel assets (DataFrames, models), and connect to FlowyML infrastructure.

Pipelines Panel
Pipeline promotion with quick actions and @step decorators
Deploy Panel
Deploy as API, Docker Container, or Batch Pipeline with infrastructure stacks

Assets Panel
Kernel assets: tracked DataFrames with size, shape, and type metadata


🀝 Git & Version Control

Full GitHub integration as the collaboration backend. Link a repository, branch, commit, and push β€” all from the notebook sidebar. No proprietary cloud needed.

GitHub Integration
Connect GitHub repository for team collaboration and versioning
History & Snapshots
Save and browse notebook snapshots with cell-level diffs

βš™οΈ Environment & FlowyML Connection

Run standalone (Local Mode) or connect to a FlowyML server (Remote Mode) for experiment tracking, pipeline export, and deployment. Full runtime details at a glance.

Environment Panel
Environment panel: Local/Remote connection, runtime info (Python 3.12, IPython, Reactive DAG engine)


πŸ› οΈ CLI Reference

Command Description
fml-notebook dev πŸ”₯ Launch with Vite hot reload
fml-notebook start πŸš€ Launch with production build
fml-notebook run <file> ▢️ Execute a notebook headlessly
fml-notebook export <file> πŸ“¦ Export as pipeline/HTML/PDF/Docker
fml-notebook app <file> 🌐 Deploy as interactive web app
fml-notebook list --server <URL> πŸ“š List notebooks on a server

πŸ“š Documentation

Visit FlowyML Notebook Docs for the complete guide:


πŸ› οΈ Development

git clone https://github.com/UnicoLab/flowyml-notebook.git
cd flowyml-notebook
make setup
make dev
Target Description
make setup πŸ”§ Install Python package + frontend deps
make dev πŸ”₯ Launch dev mode with hot reload
make test πŸ§ͺ Run all tests
make lint πŸ” Run Ruff linter
make format ✨ Auto-format code
make docs πŸ“– Build MkDocs documentation
make docs-serve πŸ‘οΈ Preview docs locally
make pre-commit πŸ”’ Run pre-commit checks
make release-dry-run 🏷️ Dry-run semantic release
make clean 🧹 Remove build artifacts

See CONTRIBUTING.md for the full contributor guide.


🀝 Community


πŸ“„ License

Licensed under the Apache License 2.0.

Built with ❀️ by UnicoLab

About

FlowyML Notebook replaces Jupyter with a reactive, production-grade notebook deeply integrated with the [FlowyML](https://github.com/UnicoLab/FlowyML) ML pipeline framework.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors