Installing

trame-server can be installed with pip:

pip install trame-server

Usage

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, in a @state.change listener (sync or async) or in a controller task (ctrl.add_task). 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.

Development

Install the library in dev mode

# 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 checks
pre-commit run --all-files