/voici-demo

Voici deployment template

Primary LanguageJupyter Notebook

Voici demo

lite-badge

Voici deployed as a static site to GitHub Pages, for demo purposes.

It uses jupyterlite-xeus to build the Emscripten environment, including the xeus-python kernel and run dependencies.

✨ Try it in your browser ✨

https://voila-dashboards.github.io/voici-demo

💡 How to make your own deployment

Screencast.from.2023-03-06.11-06-04.webm

Then your site will be published under https://{USERNAME}.github.io/{DEMO_REPO_NAME}

📦 How to install extra packages

You can pre-install extra packages by adding them to the environment.yml file.

For example, if you want to create a Voici deployment with NumPy and Matplotlib pre-installed, you would need to edit the environment.yml file as following:

name: voici
channels:
  - https://repo.mamba.pm/emscripten-forge
  - conda-forge
dependencies:
  - xeus-python
  - numpy
  - matplotlib

Only no-arch packages from conda-forge and packages from emscripten-forge can be installed.

  • How do I know if a package is no-arch on conda-forge? no-arch means that the package is OS-independent, usually pure-python packages are no-arch. To check if your package is no-arch on conda-forge, check if the "Platform" entry is "no-arch" in the https://beta.mamba.pm/channels/conda-forge?tab=packages page. If your package is not no-arch but is a pure Python package, then you should probably update the feedstock to turn your package into a no-arch one.
  • How do I know if my package is on emscripten-forge? You can see the list of packages pubished on emscripten-forge here. In case your package is missing, or it's not up-to-date, feel free to open an issue or a PR on https://github.com/emscripten-forge/recipes.