{"id":22475,"library":"trame-components","title":"trame-components","description":"Core components for trame widgets, providing a set of reusable UI components for building web-based scientific visualization applications. Current version 2.5.0 is under active development with frequent releases.","status":"active","version":"2.5.0","language":"python","source_language":"en","source_url":"https://github.com/Kitware/trame-components","tags":["trame","visualization","vuetify","widgets","web-ui"],"install":[{"cmd":"pip install trame-components","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"Wrong import path: submodule vuetify3 missing","wrong":"from trame.widgets import Vuetify3","symbol":"Vuetify3","correct":"from trame.widgets.vuetify3 import Vuetify3"},{"note":"Vuetify2 components were renamed in trame-components >= 2.0","wrong":"from trame.widgets.vuetify2 import VContainer","symbol":"VContainer","correct":"from trame.widgets.vuetify3 import VContainer"}],"quickstart":{"code":"from trame.app import get_server\nfrom trame.ui.vuetify3 import SinglePageLayout\nfrom trame.widgets.vuetify3 import VBtn, VTextField\n\nserver = get_server()\nstate, ctrl = server.state, server.controller\n\nwith SinglePageLayout(server) as layout:\n    with layout.content:\n        VTextField(v_model=('name', 'World'), label='Name')\n        VBtn(click='alert(`Hello ${name}`)', text='Greet')\n\nserver.start()","lang":"python","description":"Minimal trame app with Vuetify3 components"},"warnings":[{"fix":"Replace `from trame.widgets.vuetify2 import ...` with `from trame.widgets.vuetify3 import ...`","message":"trame-components v2.0 broke all Vuetify2 imports. Use `trame.widgets.vuetify3` instead of `vuetify2`.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Migrate to direct widget imports from `trame.widgets.*`","message":"The `trame.html` and `trame.core` modules are deprecated. Use explicit widget imports (e.g., `from trame.widgets.vuetify3 import VContainer`).","severity":"deprecated","affected_versions":">=1.5.0"},{"fix":"Always initialise state: `state.some_var = 'default'` before using in v-model or expressions.","message":"State variables must be defined before use in templates. Accessing `state.some_var` without initialising it in the state dictionary will raise an error.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Upgrade trame-components to >=2.0: pip install 'trame-components>=2.0'","cause":"trame-components version mismatch: vuetify3 submodule is only available in v2.0+.","error":"ImportError: cannot import name 'Vuetify3' from 'trame.widgets'"},{"fix":"Install trame: pip install trame","cause":"The base `trame` package is not installed; trame-components depends on it but doesn't install it automatically.","error":"ModuleNotFoundError: No module named 'trame'"},{"fix":"Add `server = get_server()` before using `with layout:` or `server.start()`.","cause":"Missing server instance: `server.start()` was called without creating a server via `get_server()`.","error":"TypeError: 'NoneType' object is not callable when using server.start()"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}