Installing Datapane
Datapane's Python library and CLI can be installed using either pip
or conda
on macOS, Windows, or Linux. Datapane supports Python 3.8 - 3.11.
Info
Instructions for installing Python can be found at https://wiki.python.org/moin/BeginnersGuide/Download.
Additional install instructions can be found on the project GitHub's page.
pip¶
If you use pip
, you can install it with:
conda¶
If you use conda
, you can install it with:
Warning
Conda sometimes installs an older version of Datapane. If you receive errors, please check the version and try running conda update --all
or try in a new conda environment (conda create -n ENV
and conda activate ENV
)
Upgrading¶
We upgrade Datapane regularly to include new features, both in the client and on the hosted version. From time to time your client may no longer be compatible with the Datapane server when uploading an app. If this happens, you will receive an error like the following:
IncompatibleVersionError: Your client is out-of-date (version 0.9.2) and may be causing errors,
please upgrade to version 0.10.2
In such an event, please upgrade your Datapane cli via pip
or conda
and try again.
Upgrading via pip¶
If you installed Datapane via pip, run the following command:
Upgrading via conda¶
If you installed datapane
via conda, run the following command, adding the --all
flag if needed. As above, if you receive errors please try using a fresh conda environment.
Datapane Cloud¶
Datapane Cloud is a free and paid-for platform for hosting, sharing, and embedding reports, apps, functions and more securely.
Simply create your account, sign in, and add your API token to your local environment by running the following from the terminal or within Python respectively,
Datapane Cloud comes with a generous free tier for individual use and public sharing, and paid plans for teams usage, permissions, authentication and more - see here
Analytics¶
By default, the Datapane Python library collects error reports and usage telemetry.
This is used by us to help make the product better and to fix bugs.
If you would like to disable this, simply create a file called no_analytics
in your datapane
config directory, e.g.
Linux¶
macOS¶
$ mkdir -p ~/Library/Application\ Support/datapane && touch ~/Library/Application\ Support/datapane/no_analytics
Windows (PowerShell)¶
You may need to try ~/AppData/Local
instead of ~/AppData/Roaming
on certain Windows configurations depending on the type of your user-account.
Windows Tips and Troubleshooting¶
We generally recommend installing via conda
over pip
on Windows as it's easier to install all the required dependencies.
If you need to install Python first, the latest versions of Windows 10 can install Python for you automatically - running python
from the command-prompt will take you to the Windows Store where you can download an official version.
We also strongly recommend using a 64-bit rather than the 32-bit version of Python, you can check this by running the following command from the Command Prompt,
Also note that on Windows, you can run the datapane
command either by running datapane
or datapane.exe
on the command-line.
Windows-specific Issues¶
Import errors when running/importing Datapane¶
You may encounter errors such as ImportError: DLL load failed
when running Datapane or importing it within your Python code.
If so, try installing the Visual C++ Redistributables for Windows from Microsoft and running again (you most likely want to download the version for x64, i.e. vc_redist.x64.exe
)
Datapane install errors trying to compile pyarrow
using Visual C++¶
This usually occurs when you are running a 32-bit version of Python and installing via pip
. Either try using conda
or install a 64-bit version of Python (for example from the Windows Store as mentioned above).
This may also occur when using Windows 7 - we only support directly Windows 10, however, it may be worth trying to install via conda
instead, if you are stuck on Windows 7.
'datapane.exe' is not recognized as an internal or external command¶
This occurs when your Windows %PATH%
doesn't include all the Python directories, specifically the Scripts
directory.
You may notice during the Datapane install messages such as (or similar to):
The script datapane.exe is installed in 'C:\users\<USERNAME>\appdata\local\programs\python\python37\Scripts' which is not on PATH.
Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.
To fix this, adjust your %PATH%
to include your specific Scripts
path as mentioned in the pip
warning (see here for more detailed instructions). Alternatively, you can try running the Datapane client directly, using the command python3.exe -m datapane.client
instead.
Info
If you are still having problems installing, please ask on our Forums