🌊 FlowyML Notebook

The Reactive Notebook That Ships to Production

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.

Reactive notebook editor with code cells, variable explorer, and full toolbar

🚀 Why FlowyML Notebook?

⚡ 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

💡 Short alias: You can also use fmln instead of fml-notebook — it's the same CLI:

fmln dev     # same as fml-notebook dev
fmln start   # same as fml-notebook start

You can also import the package with import fmln as a shorthand for import flowyml_notebook.

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.

Automatic DataFrame profiling with column statistics, type detection, and memory impact

Interactive charts for every column — histograms, bar charts, and distribution analysis

Pearson correlation matrix with color-coded heatmap for quick feature analysis

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.

Visual dependency graph showing data flow: imports → data_generation → analysis → exploration → summary

🦄 UnicoLab Keras Ecosystem

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

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.

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 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.

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 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.

Pipeline promotion with quick actions and @step decorators

Deploy as API, Docker Container, or Batch Pipeline with infrastructure stacks

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.

Connect GitHub repository for team collaboration and versioning

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: Local/Remote connection, runtime info (Python 3.12, IPython, Reactive DAG engine)

🛠️ CLI Reference

All commands also work with the short alias: fmln dev, fmln start, etc.

🔬 Killer Features

FlowyML Notebook ships with 13 built-in analysis tools — a full data science toolkit embedded directly in the notebook. No extra installs, no configuration.

⚡ Performance Tools

📊 Data Quality

🔍 Code Intelligence

📝 Productivity

🔄 Interoperability

📚 Documentation

Visit FlowyML Notebook Docs for the complete guide:

• Getting Started — Install, launch, configure
• Features — Complete feature inventory
• Architecture — Reactive DAG engine internals
• Recipes — Reusable cell templates
• Collaboration — GitHub-based team workflows
• Integration — FlowyML instance connections
• Ecosystem — UnicoLab Keras ecosystem (KDP, KerasFactory, MLPotion)
• Data Exploration — Rich DataFrame profiling
• API Reference — CLI & Python API docs

🛠️ Development

git clone https://github.com/UnicoLab/flowyml-notebook.git
cd flowyml-notebook
make setup
make dev

See CONTRIBUTING.md for the full contributor guide.

🤝 Community

• 📖 Documentation
• 🐛 Bug Reports
• 💬 Discussions
• 📋 Contributing Guide
• 📜 Changelog
• 🔒 Security Policy
• 📝 Code of Conduct

📄 License

Licensed under the Apache License 2.0.

Built with ❤️ by UnicoLab