Skip to content

[Transform] Serialize transforms config #412

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 102 commits into from
Aug 11, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
102 commits
Select commit Hold shift + click to select a range
d8a10ec
add utilities
kylesayrs May 30, 2025
d2af054
add tests
kylesayrs May 30, 2025
e32d5b5
add additional tests
kylesayrs May 30, 2025
9d0518b
add utils and tests
kylesayrs May 30, 2025
8c5a2d9
Implement transform factories
kylesayrs May 30, 2025
809e367
Merge branch 'kylesayrs/transform_utils' into kylesayrs/transform_fac…
kylesayrs May 30, 2025
8d613b3
add permutations
kylesayrs May 31, 2025
57d171a
add delete_offload_module
kylesayrs May 31, 2025
d77bcef
Merge branch 'kylesayrs/transform-accelerate-utilities' into kylesayr…
kylesayrs May 31, 2025
ab73b43
Merge branch 'kylesayrs/transform-accelerate-utilities' into kylesayr…
kylesayrs May 31, 2025
4b55733
Merge branch 'kylesayrs/transform_factory' into kylesayrs/transform_p…
kylesayrs May 31, 2025
aa7d21b
key inverses by weight
kylesayrs May 31, 2025
6901e02
fix tests
kylesayrs May 31, 2025
47ae9fe
standardize random hadamard
kylesayrs May 31, 2025
34f1343
Merge branch 'kylesayrs/transform_utils' into kylesayrs/transform_fac…
kylesayrs May 31, 2025
1039100
prepend input hooks
kylesayrs May 31, 2025
5677553
Merge remote-tracking branch 'origin' into kylesayrs/transform_utils
kylesayrs Jun 5, 2025
68ec14e
apply sqrt division first
kylesayrs Jun 5, 2025
a62418a
Merge branch 'kylesayrs/transform_utils' into kylesayrs/transform_fac…
kylesayrs Jun 5, 2025
b117523
use divided hadamards
kylesayrs Jun 5, 2025
a46f754
fix typo
kylesayrs Jun 5, 2025
cb1cb52
add random option
kylesayrs Jun 5, 2025
7c02bb2
Merge branch 'kylesayrs/transform_utils' into kylesayrs/transform_fac…
kylesayrs Jun 5, 2025
02af1e9
use random seeds, rename matrix multiply
kylesayrs Jun 5, 2025
f45f3e9
add deterministic generation to random matrix
kylesayrs Jun 5, 2025
7a7abdf
fix perm math
kylesayrs Jun 5, 2025
6e52894
update docstrings
kylesayrs Jun 5, 2025
7230933
update docstrings
kylesayrs Jun 5, 2025
f74fe3e
Merge branch 'kylesayrs/transform_factory' into kylesayrs/transform_p…
kylesayrs Jun 5, 2025
92ddea9
cleanup
kylesayrs Jun 5, 2025
779956f
cleanup 2
kylesayrs Jun 5, 2025
fbd2939
Merge branch 'kylesayrs/transform_utils' into kylesayrs/transform_fac…
kylesayrs Jun 5, 2025
dd72b6a
make seed optional
kylesayrs Jun 5, 2025
4ae491d
Merge branch 'kylesayrs/transform_factory' into kylesayrs/transform_p…
kylesayrs Jun 5, 2025
da19b0f
remove iterable check and missing return value
kylesayrs Jun 9, 2025
7ab17ce
Merge branch 'main' into kylesayrs/transform_permutations
kylesayrs Jun 10, 2025
33df50f
Merge remote-tracking branch 'origin' into kylesayrs/transform_permut…
kylesayrs Jun 10, 2025
6e1ec39
Remove unrelated changes
kylesayrs Jun 10, 2025
938e702
simplify code
kylesayrs Jun 10, 2025
27bc0b3
implement apply, use in tests
kylesayrs Jun 10, 2025
a27db62
use hadamards database file
kylesayrs Jun 11, 2025
ce63955
try manifest
kylesayrs Jun 11, 2025
7ae5863
try setup, update hadamards list
kylesayrs Jun 11, 2025
67675c3
fix setup
kylesayrs Jun 11, 2025
f061db9
add docstrings, cleanup
kylesayrs Jun 11, 2025
4a84ce1
fix setup, thank you @dbarbuzzi
kylesayrs Jun 11, 2025
cde1066
remove numpy, add tests
kylesayrs Jun 11, 2025
1ba6195
solidify dtype, add gpu tests
kylesayrs Jun 11, 2025
c373345
fix docstring
kylesayrs Jun 11, 2025
fbaf47a
add device option
kylesayrs Jun 11, 2025
5a887f4
construct on execution device, cache on offload device
kylesayrs Jun 11, 2025
310fe6d
save construction device changes for later
kylesayrs Jun 11, 2025
b715329
construct on execution device, cache on offload device
kylesayrs Jun 11, 2025
249323c
cite nja sloane
kylesayrs Jun 11, 2025
1823af4
Merge branch 'kylesayrs/extend-hadamard', remote-tracking branch 'ori…
kylesayrs Jun 11, 2025
94a0bf5
Merge remote-tracking branch 'origin' into kylesayrs/extend-hadamard
kylesayrs Jun 11, 2025
cf066e0
Merge branch 'kylesayrs/extend-hadamard' into kylesayrs/transform_con…
kylesayrs Jun 11, 2025
c1a4a34
remove dreg
kylesayrs Jun 11, 2025
5807ee1
put on device via safe_open
kylesayrs Jun 11, 2025
ccb88ed
nits and docstrings
kylesayrs Jun 12, 2025
feba695
update docstring
kylesayrs Jun 12, 2025
c8f6b53
Merge branch 'kylesayrs/extend-hadamard' into kylesayrs/transform_con…
kylesayrs Jun 12, 2025
e7f08e1
Merge branch 'kylesayrs/transform_construct_cache_device' into kylesa…
kylesayrs Jun 12, 2025
75b9307
Merge remote-tracking branch 'origin' into kylesayrs/transform_permut…
kylesayrs Jun 12, 2025
b6a0dd4
Merge remote-tracking branch 'origin' into kylesayrs/transform_constr…
kylesayrs Jun 13, 2025
955f2f5
Merge
kylesayrs Jun 23, 2025
226f367
merge with construct: construct in float32
kylesayrs Jun 23, 2025
9745acb
Merge remote-tracking branch 'origin' into kylesayrs/transform_apply
kylesayrs Jun 23, 2025
fd3390a
construct with same dtype, constructing on fp32 found no difference
kylesayrs Jun 23, 2025
3c55003
Merge branch 'kylesayrs/transform_construct_cache_device' into kylesa…
kylesayrs Jun 23, 2025
ad29c15
remove unnecessary imports
kylesayrs Jun 23, 2025
85f40b5
bugfixes (#375)
brian-dellabetta Jul 2, 2025
500af9b
use factory_kwargs
kylesayrs Jul 7, 2025
8e36540
add frozen dict to deps
kylesayrs Jul 7, 2025
48653ec
Merge remote-tracking branch 'origin' into kylesayrs/transform_permut…
kylesayrs Jul 7, 2025
56df0f7
fix style
kylesayrs Jul 7, 2025
a251569
merge
kylesayrs Jul 7, 2025
cb5a32b
Merge remote-tracking branch 'origin' into kylesayrs/transform_apply
kylesayrs Jul 7, 2025
06e0346
Merge branch 'kylesayrs/transform_permutations' into kylesayrs/transf…
kylesayrs Jul 7, 2025
0a4fea5
Merge branch 'kylesayrs/transform_construct_cache_device' into kylesa…
kylesayrs Jul 7, 2025
49740c6
use delete_offload_module
kylesayrs Jul 7, 2025
7dc182b
Merge remote-tracking branch 'origin' into kylesayrs/transform_constr…
kylesayrs Jul 7, 2025
80db2ce
Merge branch 'kylesayrs/transform_construct_cache_device' into kylesa…
kylesayrs Jul 7, 2025
e06bbad
add docstrign
kylesayrs Jul 7, 2025
438bc13
Merge remote-tracking branch 'origin' into kylesayrs/transform_apply
kylesayrs Jul 7, 2025
fd77ecc
use parametrize
kylesayrs Jul 8, 2025
5a95fd2
populate _dynamic_tied_weights_keys
kylesayrs Jun 28, 2025
b009f47
ensure serializable
kylesayrs Jul 8, 2025
2e362d2
remove extra space
kylesayrs Jul 8, 2025
c6abb96
apply style
kylesayrs Jul 8, 2025
3da59a0
Merge remote-tracking branch 'origin' into kylesayrs/transform_save
kylesayrs Jul 10, 2025
97345b0
merge dregs
kylesayrs Jul 10, 2025
4085613
skip offloading tests until transformers changes land
kylesayrs Jul 10, 2025
85419e2
Merge remote-tracking branch 'origin' into kylesayrs/transform_save
kylesayrs Jul 24, 2025
c45352e
Merge remote-tracking branch 'origin' into kylesayrs/transform_save
kylesayrs Jul 31, 2025
85ae8ba
use set
kylesayrs Jul 31, 2025
a7b5272
[Quantization][Decompression] Fix QDQ for dynamic quant; Update NVFP4…
dsikka Jul 31, 2025
45fbe5c
serialize
kylesayrs Aug 1, 2025
9d6a127
Merge remote-tracking branch 'origin' into kylesayrs/serialize-tconfig
kylesayrs Aug 1, 2025
1e412d8
Merge remote-tracking branch 'origin' into kylesayrs/serialize-tconfig
kylesayrs Aug 7, 2025
bebcc55
fix typo, comment
kylesayrs Aug 7, 2025
873bda0
Merge remote-tracking branch 'origin' into kylesayrs/serialize-tconfig
kylesayrs Aug 11, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 8 additions & 3 deletions src/compressed_tensors/base.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,9 +12,14 @@
# See the License for the specific language governing permissions and
# limitations under the License.

SPARSITY_CONFIG_NAME = "sparsity_config"
# configs
QUANTIZATION_CONFIG_NAME = "quantization_config"
COMPRESSION_CONFIG_NAME = "compression_config"
KV_CACHE_SCHEME_NAME = "kv_cache_scheme"
SPARSITY_CONFIG_NAME = "sparsity_config"
TRANSFORM_CONFIG_NAME = "transform_config"

# required fields
COMPRESSION_VERSION_NAME = "version"
QUANTIZATION_METHOD_NAME = "quant_method"

# auxillary configs
KV_CACHE_SCHEME_NAME = "kv_cache_scheme"
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@
QUANTIZATION_CONFIG_NAME,
QUANTIZATION_METHOD_NAME,
SPARSITY_CONFIG_NAME,
TRANSFORM_CONFIG_NAME,
)
from compressed_tensors.compressors.base import BaseCompressor
from compressed_tensors.compressors.sparse_compressors import DenseCompressor
Expand All @@ -43,6 +44,7 @@
)
from compressed_tensors.quantization.lifecycle import expand_target_names
from compressed_tensors.quantization.utils import is_module_quantized
from compressed_tensors.transform import TransformConfig
from compressed_tensors.utils import (
align_module_device,
delete_offload_parameter,
Expand Down Expand Up @@ -105,6 +107,7 @@ class ModelCompressor:

sparsity_config: Optional[SparsityCompressionConfig] = None
quantization_config: Optional[QuantizationConfig] = None
transform_config: Optional[TransformConfig] = None

@classmethod
def from_pretrained(
Expand Down Expand Up @@ -144,6 +147,8 @@ def from_compression_config(

sparsity_config = cls.parse_sparsity_config(compression_config)
quantization_config = cls.parse_quantization_config(compression_config)
# TODO: transform config is not support by CompressedTensorsConfig yet

if sparsity_config is None and quantization_config is None:
return None

Expand Down Expand Up @@ -177,20 +182,27 @@ def from_pretrained_model(
algorithm
:return: compressor for the configs, or None if model is not compressed
"""
# reconstruct config from schemes attached to modules
quantization_config = QuantizationConfig.from_pretrained(
model, format=quantization_format
)

# use config passed as argument
if isinstance(sparsity_config, str): # we passed in a sparsity format
sparsity_config = SparsityCompressionConfig.load_from_registry(
sparsity_config
)

if sparsity_config is None and quantization_config is None:
# use config attached to model
transform_config = getattr(model, TRANSFORM_CONFIG_NAME, None)

if not any((quantization_config, sparsity_config, transform_config)):
return None

return cls(
sparsity_config=sparsity_config, quantization_config=quantization_config
sparsity_config=sparsity_config,
quantization_config=quantization_config,
transform_config=transform_config,
)

@staticmethod
Expand Down Expand Up @@ -254,13 +266,17 @@ def __init__(
self,
sparsity_config: Optional[SparsityCompressionConfig] = None,
quantization_config: Optional[QuantizationConfig] = None,
transform_config: Optional[TransformConfig] = None,
):
self.sparsity_config = sparsity_config
self.quantization_config = quantization_config
self.transform_config = transform_config

self.sparsity_compressor = None
self.quantization_compressor: Optional[
Union[BaseQuantizationCompressor, DenseCompressor]
] = None
# no transform compressor is required

if sparsity_config is not None:
self.sparsity_compressor = BaseCompressor.load_from_registry(
Expand Down Expand Up @@ -640,43 +656,49 @@ def update_config(self, save_directory: str):

:param save_directory: path to a folder containing a HF model config
"""
if self.quantization_config is None and self.sparsity_config is None:
# this check is also done in `from_pretrained_model`,
# but not in `from_pretrained`` or `from_compression_config``
if not any(
(self.quantization_config, self.sparsity_config, self.transform_config)
):
return

# write to config.json file, regardless of whether it exists already
# overwrite previous config and version if already existing
config_file_path = os.path.join(save_directory, CONFIG_NAME)
if not os.path.exists(config_file_path):
_LOGGER.warning(
f"Could not find a valid model config file in "
f"{save_directory}. Compression config will not be saved."
)
return
if os.path.exists(config_file_path):
with open(config_file_path, "r") as file:
config_data = json.load(file)
else:
config_data = {}

with open(config_file_path, "r") as config_file:
config_data = json.load(config_file)
# serialize configs into json
qconfig_data = (
self.quantization_config.model_dump(exclude=["quant_method", "format"])
if self.quantization_config is not None
else {}
)
sconfig_data = (
self.sparsity_config.model_dump()
if self.sparsity_config is not None
else {}
)
tconfig_data = (
self.transform_config.model_dump()
if self.transform_config is not None
else {}
)

# required metadata whenever a quantization or sparsity config is present
# overwrite previous config and version if already existing
config_data[QUANTIZATION_CONFIG_NAME] = {}
config_data[QUANTIZATION_CONFIG_NAME][
COMPRESSION_VERSION_NAME
] = compressed_tensors.__version__
if self.quantization_config is not None:
self.quantization_config.quant_method = DEFAULT_QUANTIZATION_METHOD
else:
config_data[QUANTIZATION_CONFIG_NAME][
QUANTIZATION_METHOD_NAME
] = DEFAULT_QUANTIZATION_METHOD

# quantization and sparsity configs
if self.quantization_config is not None:
quant_config_data = self.quantization_config.model_dump()
config_data[QUANTIZATION_CONFIG_NAME] = quant_config_data
if self.sparsity_config is not None:
sparsity_config_data = self.sparsity_config.model_dump()
config_data[QUANTIZATION_CONFIG_NAME][
SPARSITY_CONFIG_NAME
] = sparsity_config_data
# construct compression (quantization) config
config_data[QUANTIZATION_CONFIG_NAME] = {
COMPRESSION_VERSION_NAME: compressed_tensors.__version__,
QUANTIZATION_METHOD_NAME: DEFAULT_QUANTIZATION_METHOD,
SPARSITY_CONFIG_NAME: sconfig_data,
TRANSFORM_CONFIG_NAME: tconfig_data,
**qconfig_data,
}

# write results to config.json file
with open(config_file_path, "w") as config_file:
json.dump(config_data, config_file, indent=2, sort_keys=True)

Expand Down
4 changes: 4 additions & 0 deletions src/compressed_tensors/transform/apply.py
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@
# limitations under the License.

import torch
from compressed_tensors import TRANSFORM_CONFIG_NAME
from compressed_tensors.transform import TransformConfig, TransformFactory


Expand All @@ -30,3 +31,6 @@ def apply_transform_config(model: torch.nn.Module, config: TransformConfig):
for name, scheme in config.config_groups.items():
factory = TransformFactory.from_scheme(scheme, name=name)
factory.apply_to_model(model)

# attach config to model for compression/serialization
setattr(model, TRANSFORM_CONFIG_NAME, config)
4 changes: 2 additions & 2 deletions src/compressed_tensors/transform/factory/base.py
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,10 @@

from abc import ABC, abstractmethod
from collections import defaultdict
from typing import List, Optional, Tuple, Set
from typing import List, Optional, Set, Tuple

import torch
import torch.nn.utils.parametrize as P
from compressed_tensors import InternalModule
from compressed_tensors.registry.registry import RegistryMixin, T
from compressed_tensors.transform import (
TransformArgs,
Expand All @@ -34,6 +33,7 @@
register_offload_module,
update_offload_parameter,
)
from compressed_tensors.utils.internal import InternalModule
from torch import Tensor
from torch.nn import Module, Parameter

Expand Down