1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
|
# trame: simple, powerful, innovative
Trame is an easy-to-use, Python-based framework that let you create desktop like application which shows up in your web browser.
You can create buttons, dialogs, 3D scenes with VTK/ParaView, charts, maps and much more.
It is great for any micro apps, dashboards, or even replacing a PyQt app into a web app.
You can also use it in development, for example when tweaking/configuring 3D rendering, machine learning and more.
At the end your app can be used locally, remotely, in the cloud, in Jupyter or on HPC.
Trame is available as a PyPI package, on conda-forge and we provide docker images for cloud deployment.
If you need help don't hesitate [to reach out](https://www.kitware.com/trame/)
[](https://gurubase.io/g/trame)
**trame** - a web framework that weaves together open source components into customized visual analytics easily.
**trame** is French for
* the core that ties things together
* a guide providing the essence of a task
With **trame**, create stunning, interactive web applications compactly and intuitively.
<div>
<img src="https://raw.githubusercontent.com/Kitware/trame/master/docs/vitepress/assets/images/examples/CarotidFlow.jpg" style="width: 30%">
<img src="https://raw.githubusercontent.com/Kitware/trame/master/docs/vitepress/assets/images/examples/UberPickupsNYC.jpg" style="width: 30%">
<img src="https://raw.githubusercontent.com/Kitware/trame/master/docs/vitepress/assets/images/examples/FiniteElementAnalysis.jpg" style="width: 30%">
</div>
## 3D Visualization
With best-in-class VTK and ParaView platforms at its core, **trame** provides complete control of 3D visualizations and data movements.
Developers benefit from a write-once environment while **trame** simply exposes both local and remote rendering through a single method.
## Rich Features
**trame** leverages existing libraries and tools such as Vuetify, Altair, Vega, deck.gl, VTK, ParaView, and more, to create vivid content for visual analytics applications.
## Problem Focused
By relying simply on Python, **trame** focuses on one's data and associated analysis and visualizations while hiding the complications of web app development.
## Desktop to cloud
The resulting **trame** applications can act as local desktop applications or remote cloud applications both accessed through a browser.
## Installing
trame can be installed with [pip](https://pypi.org/project/trame/):
```bash
pip install --upgrade trame
```
## Usage
The [Trame Tutorial](https://kitware.github.io/trame/guide/tutorial/) is the place to go to learn how to use the library and start building your own application.
The [API Reference](https://trame.readthedocs.io/en/latest/index.html) documentation provides API-level documentation.
## License
trame is made available under the Apache License, Version 2.0. For more details, see [LICENSE](https://github.com/Kitware/trame/blob/master/LICENSE)
## Community
[Trame](https://kitware.github.io/trame/) | [Discussions](https://github.com/Kitware/trame/discussions) | [Issues](https://github.com/Kitware/trame/issues) | [Contact Us](https://www.kitware.com/contact-us/)
__Citing options__
[](https://zenodo.org/badge/latestdoi/410108340)
```bibtex
@article{Trame,
author = {Jourdain, S. and O'Leary, P. and Schroeder, W.},
title = {Trame: Platform Ubiquitous, Scalable Integration Framework for Visual Analytics},
journal = {IEEE Computer Graphics and Applications},
month = {March},
year = {2025},
doi = {10.1109/MCG.2025.3540264},
}
```
## Enjoying trame?
Share your experience [with a testimonial](https://github.com/Kitware/trame/issues/18) or [with a brand approval](https://github.com/Kitware/trame/issues/19).
## Optional dependencies
When installing trame using pip (`pip install trame`) you will get the core infrastructure for any trame application to work but more advanced usage may require additional dependencies.
The list below captures what may need to add depending on your usage:
* **pywebview** : Needed for desktop usage (--app)
* **jupyterlab** : Needed to run inside jupyter-lab
* **notebook** : Needed to run inside jupyter-notebook
* **requests** : Needed when using remote assets such as GDrive files
## 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)
## Life cycle callbacks
Life cycle events are directly managed on the application controller
and are prefixed with `on_*`.
* **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_server_reload** : If callback registered it is used for reloading server side modules
## Reserved state entries
The shared state allow us to synchronize the server with the client.
Rather than creating another mechanism to handle similar needs throughout
the application we purposely reuse that state internally. To prevent any conflict with any user we are prefixing our internal
variable with `trame__*`. In general those state values should not be use
or changed by the user except for the one listed below:
Read/Write:
- **trame__favicon**: Update it to replace the displayed favicon in your
browser. The content needs to be an image encoded url.
- **trame__title**: Update it to replace your page title
(tab name / window name).
Read-only:
- **trame__busy**: Provide information if we have pending requests waiting
for the server to respond.
- **tts**: Template Time Stamp to regenerate sub elements when a template
gets updated. Usually used as `:key="tts"` to force some component
rebuild.
## Professional Support
<section class="kw-block-wrapper kwBlock px-pt-64 px-pb-64">
<div class="background"></div>
<div class="kw-block-wrapper__internal">
<section class="kw-block-advanced-columns kwBlock">
<div class="layout">
<div class="flex flex-basis-column3 flex-justify-space-between flex-column-gap-64 card-icon-text-wrapper">
<div class="flexcolumn"><div class="card-icon-text"><div class="card-icon-text__icon bg-primary-500"><div class="background"></div><span class="icon icon-tutorials "></span></div><div class="txt text-align-center"><h3 class="txt__subtitle font-size-26 font-weight-700">Training</h3><div class="txt__content"><p>Learn how to confidently use trame from the expert developers at Kitware.</p>
</div> <div class="txt__links"><a href="https://www.kitware.com/courses/trame/" class="btn btn-primary ">Get Started</a></div></div></div></div><div class="flexcolumn"><div class="card-icon-text"><div class="card-icon-text__icon bg-secondary-500"><div class="background"></div><span class="icon icon-community-support "></span></div><div class="txt text-align-center"><h3 class="txt__subtitle font-size-26 font-weight-700">Support</h3><div class="txt__content"><p>Our experts can assist your team as you build your web application and establish in-house expertise.</p>
</div> <div class="txt__links"><a href="https://www.kitware.com/trame/support/" class="btn btn-secondary ">Get Support</a></div></div></div></div><div class="flexcolumn"><div class="card-icon-text"><div class="card-icon-text__icon bg-gray-500"><div class="background"></div><span class="icon icon-scripting "></span></div><div class="txt text-align-center"><h3 class="txt__subtitle font-size-26 font-weight-700">Custom Development</h3><div class="txt__content"><p>Leverage Kitware’s 25+ years of experience to quickly build your web application.</p>
</div> <div class="txt__links"><a href="https://www.kitware.com/trame/support/" class="btn btn-gray ">Request a Quote</a></div></div></div></div>
</div>
</div>
</section>
</div>
</section>
|
