mercury

Convertir le bloc-notes Jupyter en application Web

Mercury vous permet d'ajouter des widgets interactifs dans les blocs-notes Python, afin que vous puissiez partager des blocs-notes en tant qu'applications Web. Oubliez la réécriture de blocs-notes sur des frameworks Web juste pour partager vos résultats. Mercury propose un ensemble de widgets avec une simple réexécution des cellules.

Vous pouvez construire avec Mercure :

• Transformez votre ordinateur portable en de superbes applications Web,

• Créez des présentations interactives avec des widgets, vous pouvez recalculer les diapositives pendant le spectacle,

• Partagez des blocs-notes en tant que sites Web statiques,

• Créez des tableaux de bord riches en données avec des widgets,

• Créez des rapports avec des exportations PDF, une planification automatique et des notifications par e-mail (à venir),

• Servez des notebooks Python en tant que points de terminaison de l'API REST (à venir).

Caractéristiques de Mercure :

• ajoutez des widgets avec du code Python - aucune expérience frontend n'est nécessaire !
• masquer ou afficher le code du notebook,
• exporter le cahier exécuté au format PDF ou HTML,
• partagez plusieurs blocs-notes - pas de limites !
• intégrer un notebook sur n'importe quel site Web,
• téléchargement et téléchargement faciles de fichiers à partir du bloc-notes,
• ajouter l'authentification aux notebooks (à venir),
• planifier l'exécution automatique du notebook (à venir).

Widgets

Mercury fournit plusieurs widgets. Il existe 3 types de widgets :

• Les widgets d'entrée sont des composants qui apparaîtront dans la barre latérale lors de l'exécution du bloc-notes dans Mercury. Ils peuvent être utilisés pour fournir une entrée utilisateur ou déclencher une action dans le bloc-notes.
• Les widgets de sortie aident à présenter les résultats du bloc-notes à l'utilisateur et à contrôler le flux d'exécution.
• Widgets personnalisés : vous pouvez utiliser de nombreux widgets personnalisés, par exemple PyDeck et les tableaux croisés dynamiques.

Intégrations

Mercury fonctionne avec pratiquement tous les packages Python ! Parmi les plus importantes figurent les bibliothèques d'apprentissage automatique telles que Scikit-Learn, Pandas et Seaborn ou les bibliothèques de visualisation : Plotly, matplotlib, Vega-Altair et Ipyvizzu.

Exemple

Exemple de code simple qui crée un widget et affiche sa valeur. Vous pouvez interagir avec un widget dans Jupyter Notebook. Sa valeur sera mise à jour. Cependant, pour voir la mise à jour dans d'autres cellules, vous devez les exécuter manuellement .

Package d'importation :

 import mercury as mr

Créez un widget Text :

 name = mr . Text ( value = "Piotr" , label = "What is your name?" )

Valeur du widget d'impression :

 print ( f"Hello { name . value } " )

Coder dans le bloc-notes Jupyter

Application Mercure

Utilisez Mercury pour exécuter le notebook en tant qu'application Web. Les cellules sont automatiquement réexécutées après le changement de widget. Mercury réexécute uniquement les cellules avec une définition de widget et en dessous. Dans l'exemple, les cellules 2 et 3 sont réexécutées après la mise à jour du widget.

Documentation

En savoir plus sur Mercure sur RunMercury.com.

Installation

Compatible avec Python 3.7 et supérieur.

Installer avec pip :

 pip install mercury

Installer avec conda :

 conda install -c conda-forge mercury

Démo

Exécutez Mercury avec des blocs-notes de démonstration.

 mercury run demo

Veuillez vérifier 127.0.0.1:8000 pour voir les blocs-notes de démonstration.

Déploiement

Vous disposez de plusieurs options pour déployer le notebook. Vous pouvez utiliser l'option auto-hébergée où vous utilisez docker-compose sur une machine VPS ou utilisez ngrok. Il est également possible d'utiliser les Hugging Face Spaces.

Une autre option est une publicité auto-hébergée où vous avez accès au tableau de bord de déploiement où vous gérez les blocs-notes et l'accès des utilisateurs. De plus, vous avez accès aux analyses des utilisateurs ; vous pouvez librement personnaliser le style de votre application. Vous bénéficiez de forks privés et d’une assistance par email.

La troisième option consiste à utiliser Mercury Cloud. C'est le moyen le plus simple de partager des blocs-notes en ligne. Vous pourrez créer un site internet en quelques clics.

Mercure avec vos cahiers

Pour exécuter Mercury avec votre ordinateur portable, veuillez exécuter ce qui suit :

 mercury run

La commande doit être exécutée dans le même répertoire que les notebooks. Vous pouvez modifier le code dans Jupyter Notebook et Mercury mettra instantanément à jour l'application Web.

Licence Mercure

Mercury est publié avec la licence AGPL v3.

Vous recherchez une assistance dédiée, une licence commerciale et davantage de fonctionnalités ? Le Mercury Pro est fait pour vous. Veuillez consulter les détails sur notre site Web.