Package: mercury-dev
Build Web Apps in Jupyter NotebookMercury allows you to add interactive widgets in Python notebooks, so you can share notebooks as web applications. Forget about rewriting notebooks to web frameworks just to share your results. Mercury offers a set of widgets with simple re-execution of cells.You can build with Mercury:Turn your notebook into beautifulWeb Apps,Create interactivePresentationswith widgets, you can recompute slides during the show,Share notebooks as staticWebsites,Build data-richDashboardswith widgets,CreateReportswith PDF exports, automatic scheduling, and email notifications (coming soon),Serve Python notebooks asREST APIendpoints (coming soon).Mercury features:add widgets with Python code - no frontend experience needed!hide or show the notebook's code,export executed notebook to PDF or HTML,share multiple notebooks - no limits!embed notebook on any website,easy file upload and download from the notebook,add authentication to notebooks (coming soon),schedule automatic notebook execution (coming soon).WidgetsMercury provides multiple widgets. There are 3 types of widgets:Input widgetsare components that will appear in the sidebar when running the notebook in Mercury. They can be used to provide user input or trigger action in the notebook.Output widgetshelp present notebook results to the user and control execution flow.Custom Widgets- you can use many custom widgets, for example, PyDeck, and Pivot Tables.## IntegrationsMercury works with virtually every Python package!
Among the most important are machine learning libraries such as Scikit-Learn, Pandas, and Seaborn or visualization libraries: Plotly, matplotlib, Vega-Altair, and Ipyvizzu.ExampleSimple code example that creates a widget and displays its value. You can interact with a widget in the Jupyter Notebook. Its value will be updated. However, to see the update in other cells you need tomanually executethem.Import package:importmercuryasmrCreate aTextwidget:name=mr.Text(value="Piotr",label="What is your name?")Print widget value:print(f"Hello{name.value}")Code in Jupyter NotebookMercury AppUse Mercury to run notebook as web application.Cells are automatically re-executedafter widget change. Mercury re-executes only cells with widget definition and below it. In the example, cells 2 and 3 are re-executed after widget update.Documentation📚 Read more about Mercury onRunMercury.com.InstallationCompatible with Python 3.7 and higher.Install withpip:pip install mercuryInstall withconda:conda install -c conda-forge mercuryDemoRun Mercury with demo notebooks.mercury run demoPlease check127.0.0.1:8000to see demo notebooks.DeploymentYou have several options to deploy the notebook. You can use the self-hosted option where you usedocker-composeon a VPS machine or use ngrok. There's also a possibility to useHugging Face Spaces.Another option is a Self-hosted commercial where you get access to the deployment dashboard where you manage notebooks and user access. In addition, you have access to user analytics; you can freely customize the style of your application. You benefit from private forks and email support.The third option is to useMercury Cloud. It's the easiest way to share notebooks online. You will be able to create a website with a few clicks.Mercury with your notebooksTo run Mercury with your notebook, please execute the following:mercury runThe command should be run in the same directory as notebooks. You can change code in Jupyter Notebook, and Mercury willinstantlyupdate web app.Mercury LicenseMercury is released with AGPL v3 license.Looking for dedicated support, a commercial-friendly license, and more features? The Mercury Pro is for you. Please see the details atour website.