Create a virtual environment
It is best to install Solara into a virtual environment unless you know what you are doing (you already have a virtual environment, or you are using conda or docker).
See also The Python Packaging User Guide for more information about virtual environments.
Setting up a virtual environment on OSX/Unix/Linux:
$ python -m venv solara-env
$ source ./solara-env/bin/activate
Setting up a virtual environment on Windows:
> py -m venv solara-env
Install Solara as a user
Now install Solara using pip:
$ pip install solara
If you want to install an unreleased version of Solara (e.g. because we just merged a feature you need)
$ pip install "solara @ git+https://github.com/widgetti/solara"
Or put the following in your
solara @ https://github.com/widgetti/solara/package/archive/master.tar.gz
If you want to do development on Solara, read the development documentation.
Air-gapped installation / Firewalled network
If you want to have Solara running in an air-gapped environment or where access to a CDN is not possible due to firewall rules, you have two options
$ pip install "solara[assets]"
If you cannot install
solara-assets from pypi because the server is not connected to the internet, you can
follow the following steps to install Solara:
# Download the required wheels from pypi.
$ pip wheel --wheel-dir solara-air-gapped "solara[assets]"
# Zip them in a tarball.
$ tar zcfv solara-air-gapped.tar.gz solara-air-gapped
# Copy the tarball to your server.
$ scp solara-air-gapped.tar.gz yourusername@youmachine:~/solara-air-gapped.tar.gz
# ssh into your server.
$ ssh yourusername@yourmachine
# Unzip the tarball.
$ tar zxfv solara-air-gapped.tar.gz
# Install all wheels.
$ pip install solara-air-gapped/*.whl