mercury

Преобразование Jupyter Notebook в веб-приложение

Mercury позволяет добавлять интерактивные виджеты в записные книжки Python, чтобы вы могли делиться записными книжками как веб-приложениями. Забудьте о переписывании блокнотов в веб-платформы только для того, чтобы поделиться своими результатами. 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

Приложение Меркурий

Используйте Mercury для запуска ноутбука как веб-приложения. Ячейки автоматически перевыполняются после смены виджета. Mercury перевыполняет только ячейки с определением виджета и ниже него. В этом примере ячейки 2 и 3 выполняются повторно после обновления виджета.

Документация

Узнайте больше о Меркурии на RunMercury.com.

Установка

Совместим с Python 3.7 и выше.

Установить с помощью pip :

 pip install mercury

Установить с помощью conda :

 conda install -c conda-forge mercury

Демо

Запустите Mercury с помощью демонстрационных ноутбуков.

 mercury run demo

Пожалуйста, проверьте 127.0.0.1:8000, чтобы увидеть демонстрационные блокноты.

Развертывание

У вас есть несколько вариантов развертывания блокнота. Вы можете использовать вариант самостоятельного размещения, при котором вы используете docker-compose на машине VPS или используете ngrok. Также есть возможность использовать Hugging Face Spaces.

Другой вариант — самостоятельная реклама, где вы получаете доступ к панели развертывания, где вы управляете блокнотами и доступом пользователей. Кроме того, у вас есть доступ к пользовательской аналитике; вы можете свободно настроить стиль своего приложения. Вы получаете выгоду от частных вилок и поддержки по электронной почте.

Третий вариант — использовать Mercury Cloud. Это самый простой способ поделиться блокнотами в Интернете. Вы сможете создать сайт в несколько кликов.

Меркурий со своими блокнотами

Чтобы запустить Mercury на своем ноутбуке, выполните следующее:

 mercury run

Команду следует запускать в том же каталоге, что и записные книжки. Вы можете изменить код в Jupyter Notebook, и Mercury мгновенно обновит веб-приложение.

Лицензия Меркурия

Mercury выпускается с лицензией AGPL v3.

Ищете специальную поддержку, удобную для коммерческого использования лицензию и другие функции? Mercury Pro для вас. Подробности смотрите на нашем сайте.