mercury

将 Jupyter Notebook 转换为 Web 应用程序

Mercury 允许您在 Python 笔记本中添加交互式小部件，以便您可以将笔记本作为 Web 应用程序共享。忘记将笔记本重写为 Web 框架只是为了分享您的结果。 Mercury 提供了一组可以简单地重新执行单元的小部件。

您可以使用 Mercury 构建：

• 将您的笔记本变成漂亮的网络应用程序，

• 使用小部件创建交互式演示文稿，您可以在演示期间重新计算幻灯片，

• 将笔记本共享为静态网站，

• 使用小部件构建数据丰富的仪表板，

• 创建具有 PDF 导出、自动计划和电子邮件通知的报告（即将推出），

• 将 Python 笔记本作为 REST API 端点提供服务（即将推出）。

水银的特点：

• 使用 Python 代码添加小部件 - 无需前端经验！
• 隐藏或显示笔记本的代码，
• 将执行的笔记本导出为 PDF 或 HTML，
• 共享多个笔记本 - 无限制！
• 将笔记本嵌入任何网站，
• 从笔记本电脑轻松上传和下载文件，
• 向笔记本添加身份验证（即将推出），
• 安排自动笔记本执行（即将推出）。

小部件

Mercury 提供了多个小部件。有 3 种类型的小部件：

• 输入小部件是在 Mercury 中运行笔记本时将出现在侧栏中的组件。它们可用于在笔记本中提供用户输入或触发操作。
• 输出小部件有助于向用户呈现笔记本结果并控制执行流程。
• 自定义小部件 - 您可以使用许多自定义小部件，例如 PyDeck 和数据透视表。

集成

Mercury 几乎适用于所有 Python 包！其中最重要的是机器学习库，例如 Scikit-Learn、Pandas 和 Seaborn 或可视化库：Plotly、matplotlib、Vega-Altair 和 Ipyvizzu。

例子

创建小部件并显示其值的简单代码示例。您可以与 Jupyter Notebook 中的小部件进行交互。它的值将被更新。但是，要查看其他单元格中的更新，您需要手动执行它们。

导入包：

 import mercury as mr

创建一个Text小部件：

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

打印小部件值：

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

Jupyter Notebook 中的代码

水星应用程序

使用 Mercury 将笔记本作为 Web 应用程序运行。小部件更改后，单元格会自动重新执行。 Mercury 仅重新执行具有小部件定义及其下方的单元格。在示例中，单元格 2 和 3 在小部件更新后重新执行。

文档

在 RunMercury.com 上了解有关 Mercury 的更多信息。

安装

与 Python 3.7 及更高版本兼容。

使用pip安装：

 pip install mercury

使用conda安装：

 conda install -c conda-forge mercury

演示

使用演示笔记本运行 Mercury。

 mercury run demo

请检查 127.0.0.1:8000 以查看演示笔记本。

部署

您有多种部署笔记本的选项。您可以使用自托管选项，在 VPS 计算机上使用 docker-compose 或使用 ngrok。还可以使用拥抱面部空间。

另一种选择是自托管商业广告，您可以访问部署仪表板，在其中管理笔记本和用户访问。此外，您还可以访问用户分析；您可以自由定制您的应用程序的风格。您可以从私人分叉和电子邮件支持中受益。

第三种选择是使用 Mercury Cloud。这是在线共享笔记本的最简单方法。只需点击几下，您就可以创建一个网站。

Mercury 与您的笔记本

要在笔记本上运行 Mercury，请执行以下命令：

 mercury run

该命令应在与笔记本相同的目录中运行。您可以在 Jupyter Notebook 中更改代码，Mercury 将立即更新 Web 应用程序。

水星许可证

Mercury 使用 AGPL v3 许可证发布。

正在寻找专门的支持、商业友好的许可证以及更多功能？ Mercury Pro 适合您。详情请参阅我们的网站。