trame-server is the server implementation of trame. This Python library provide the server implementation of the shared state and controller along with the definition of the web server. The web server aims to be flexible so it can be use within a Jupyter environment or as a standalone desktop application.
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-server can be installed with pip:
pip install --upgrade trame-serverUsage
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.
Environments variables
TRAME_LOG_NETWORK : Path to log file for capturing network exchange. (default: None)
TRAME_WS_MAX_MSG_SIZE : Maximum size in bytes of any ws message. (default: 10MB)
TRAME_WS_HEART_BEAT : Time in second before assuming the server is non-responsive. (default: 30s)
TRAME_DESKTOP_DEBUG : If defined it will allow user to inspect the web content in desktop mode
TRAME_SERVER : If set to true, this will prevent browser from opening by default
Life cycle callbacks
Life cycle events are directly managed on the application controller and are prefixed with on_*.
on_server_start : Executed at server.start() call while passing the server as argument.
on_server_bind : WSLinkServer is getting bound to trame so you can attach your own routes. Its instance will be passed as argument to callback.
on_server_ready : All protocols initialized and available for client to connect
on_client_connected : Connection established to server
on_client_exited : Linked to browser “beforeunload” event
on_server_exited : Trame is exiting its event loop
on_error : JS error forwarded (msg:str) on the python
on_exception : Server exception occurred when interacting with the UI. The exception instance is provided as arg.
on_server_reload : If callback registered it can be use to hot_reload methods like the UI.
License
trame-server is made available under the Apache License, Version 2.0. For more details, see LICENSE
Community
Trame | Discussions | Issues | Contact Us
Enjoying trame?
Share your experience with a testimonial or with a brand approval.
3 maintainers
Metadata
3 maintainers
Release files for trame-server 3.14.1
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_server-3.14.1.tar.gz | 39.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| trame_server-3.14.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 84.7 kB
Release files / trame_server-3.14.1.tar.gz
| Download URL | trame_server-3.14.1.tar.gz |
|---|---|
| Size | 39.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1f021d104c0288c5400edb83acfd239f21438323d359d86fa242ccfed557a162
|
|
BLAKE2b-256 checksum How to use checksums |
2b17084095ac1267363a36705d38723c2102927867d6760368d575c6595858be
|
| 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 Aug 31, 2026.
Transparency logRelease files / trame_server-3.14.1-py3-none-any.whl
| Download URL | trame_server-3.14.1-py3-none-any.whl |
|---|---|
| Size | 45.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
89e6220bd06cc840ff7ecec18daf9687744204e5821beb6b6d9a5d0a629b5046
|
|
BLAKE2b-256 checksum How to use checksums |
14a1edeca9d82c6fd021d5b4208d07a9b7e6ed21a2147affbb869e0ff10d31e4
|
| 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 Aug 31, 2026.
Transparency log
