trame-client is the generic single page application that come with trame. trame-client provides the infrastructure on the client-side (browser) to connect to a trame server, synchronize its state with the server, make method call, load dynamically components and feed a dynamic template provided by the server.
This package is not supposed to be used by itself but rather should come as a dependency of trame. For any specificity, please refer to the trame documentation.
Installing
trame-client can be installed with pip:
pip install --upgrade trame-clientUsage
The Trame Tutorial is the place to go to learn how to use the library and start building your own application.
The API Reference documentation provides API-level documentation.
License
trame-client is made available under the MIT License. For more details, see LICENSE This license has been chosen to match the one use by Vue.js which is instrumental for making that library possible.
Community
Trame | Discussions | Issues | Contact Us
Enjoying trame?
Share your experience with a testimonial or with a brand approval.
Runtime configuration
Trame client is the JS core of trame and can be tuned by url parameters. The table below list which parameters we process and how they affect the client.
enableSharedArrayBufferServiceWorker |
When set this will load an extra script that will use a service worker to enable SharedArrayBuffer |
ui |
Layout name selector. When a trame app define several layout with different name, you can choose which layout should be displayed |
remove |
By default the URL will be cleaned from trame config parameters (sessionURL, sessionManagerURL, secret, application) but if additional parameters should be removed as well but used in the launcher config, this can be achieved by adding a &remove=param1,param2. |
The table below leverage environment variables, mainly for the Jupyter Lab context and the iframe builder configuration.
TRAME_JUPYTER_ENDPOINT |
Used by the trame-jupyter-extension |
TRAME_JUPYTER_WWW |
Used by the trame-jupyter-extension |
JUPYTERHUB_SERVICE_PREFIX |
Used to figure out server proxy path for iframe builder |
HOSTNAME |
When “jupyter-hub-host” is used as iframe builder, the hostname will be lookup using that environment variable |
TRAME_IFRAME_BUILDER |
Specify which iframe builder should be used. If not provided we try to do some smart detection |
TRAME_IPYWIDGETS_DISABLE |
Skip any iPyWidget iframe wrapping |
Development
Build client side code base
cd vue[2,3]-app
npm install
npm run build # build trame client application
cd -Python environment setup
# Create venv and install all dependencies
uv sync --all-extras --dev
# Activate environment
source .venv/bin/activate
# Install commit analysis
pre-commit install
pre-commit install --hook-type commit-msg
# Run pre-commit
nox -s pre_commit
# Run tests for only 1 python version
nox -s tests-3.12JavaScript dependency
This Python package bundle the following Vue.js libraries. For client_type="vue2", it exposes vue@2.7.16 and for client_type="vue3", it exposes vue@3.5.13. If you would like us to upgrade any of those dependencies, please reach out.
3 maintainers
Metadata
3 maintainers
Release files for trame-client 4.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| trame_client-4.0.0.tar.gz | 549.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| trame_client-4.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.1 MB
Release files / trame_client-4.0.0.tar.gz
| Download URL | trame_client-4.0.0.tar.gz |
|---|---|
| Size | 549.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b00286b1504b472a3f2bf5bb9ed2b0d92a9f09250f93161d82d43da1c67de8f7
|
|
BLAKE2b-256 checksum How to use checksums |
7e653cf67aa895636b851a6bcee92bbf35106abee4e1674a88a2440c6f01c2f1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / trame_client-4.0.0-py3-none-any.whl
| Download URL | trame_client-4.0.0-py3-none-any.whl |
|---|---|
| Size | 564.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5332a0880549ae570f50d5759a9b978f3f59bf910d205672faaecc7129f71df6
|
|
BLAKE2b-256 checksum How to use checksums |
c27bce2567de73e94a8df9792e2e9a68c08ddc9dd1b2745eeefda62184b14480
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency log
