---
id: trame-common
version: "1.2.7"
license: unclear
license_treatment: permissive
maintenance: active
---

# trame-common — Dependency less classes and functions for trame

License: permissive · Maintenance: active · Downloads: 904.3K/mo

## What it is and what it does

trame-common is a lightweight, dependency-free utility library designed to centralize shared code across the trame ecosystem. It provides decorators, asset handlers, code execution helpers, and object utilities that were previously scattered across trame-client, trame-server, and the main trame package. The library is organized into focused modules: assets (file and MIME type handling), decorators (function and class decorators), exec (async, throttle, debounce, threading), obj (common trame object helpers), and utils (general utilities).

While the package is primarily intended as a dependency for other trame packages rather than direct installation, it can be used independently if you need specific helper functions or classes. The zero runtime dependencies keep it lightweight, though some modules may require optional dependencies that should be specified by consuming code.

Use it for:

- Reduce code duplication when building multiple trame packages that share common utilities and decorators.
- Access centralized asset and MIME type handling for local and remote files across trame applications.
- Use common execution helpers (debounce, throttle, async) without reimplementing them in each trame component.
- Build trame widgets or server extensions that need standard object and component utilities.
- Maintain consistent decorator patterns across a trame-based application ecosystem.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides shared helper functions, decorators, and utility classes for trame packages to use across server, client, and widget contexts without duplicating code.

Yes, if you are developing trame packages or extensions that need shared utilities. Install it as a dependency of another trame package (trame, trame-server, trame-client) or directly if you are building custom trame components. The zero runtime dependencies and active maintenance make it safe to add. The early-stage classifier (Planning) is inconsistent with active releases but does not indicate instability.

## Install

pip install trame-common
uv add trame-common
poetry add trame-common

## Installing trame-common

Before you install: Low install friction with no runtime dependencies. Active maintenance with a release 7 days ago. Marked as early-stage (Development Status 1 - Planning) despite active updates.

License in practice: Licensed under Apache License 2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions.

Quickstart:

pip install trame-common

from trame_common.decorators import debounce
from trame_common.assets import get_mime_type
from trame_common.exec import create_task

Requires Python 3.10 or later.

Verify before relying:

- Whether the package is truly intended for direct use or only as a transitive dependency of other trame packages.
- What specific helper classes and functions are exported and their stability across versions.
- Whether extra dependencies mentioned in the description are optional or required for certain modules.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 904.3K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

trame shared utilities, trame common helpers, trame decorators and utilities, trame asset management, trame code execution helpers, trame component utilities, trame-ecosystem, shared-utilities

[View on SkillFed](https://skillfed.io/packages/trame-common) · [View on PyPI](https://pypi.org/project/trame-common/)