Install & Compatibility
Where this runs
tested against v3.22.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.910 runs
build_error
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 31.4s · import 8.450s · 780MB
815MB installed
● package 815MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
dtale
✓ import dtale
top-level module, no subpackage import needed
show
✓ from dtale import show
main function to launch UI
Launch D-Tale UI for a DataFrame, disable subprocess and browser auto-open for script usage.
import pandas as pd
import dtale
df = pd.DataFrame({'x': [1,2,3], 'y': [4,5,6]})
d = dtale.show(df, subprocess=False, open_browser=False)
print('Data opened at:', d._main_url)
d.close()
dtale --version
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'dtale'
dtale not installed or virtual environment not activated.
fixRun pip install dtale in your environment, or activate the correct virtualenv.
OSError: [Errno 98] Address already in use
Previous D-Tale instance still running on the same port, or port conflict.
fixClose any running D-Tale instances (e.g., call .close() on the object) or specify a different port via dtale.show(df, host='localhost', port=12345).
AttributeError: module 'dtale' has no attribute 'show'
Installed a wrong package named 'dtale' from a different source, or import path issue.
fixUninstall any conflicting packages (pip uninstall dtale) and reinstall the correct one (pip install dtale) from PyPI.
ValueError: invalid mode: 'r' while trying to open D-Tale
D-Tale is trying to open a file or resource incorrectly, often due to missing dependencies or permissions.
fixEnsure all required dependencies (flask, dash, etc.) are installed. Try restarting the Python interpreter.
TypeError: show() got an unexpected keyword argument 'subprocess'
Using an older version of dtale (<3.14.0) that does not support the subprocess parameter.
fixUpgrade dtale: pip install --upgrade dtale
Upgrade
Version history
3.22.0latest on PyPI · released Apr 1, 2026
Audit
Dependencies
pandasrequiredcore data structure dependency
flaskrequiredweb server backend
dashrequiredinteractive dashboard components
flask-ngrokoptionaloptional: expose server via ngrok