ttucs-model-bow 0.1.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Jon Evans
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,2 @@
1
+ include README.md LICENSE
2
+ recursive-include src/ttucs_model_bow/model *.json *.safetensors
@@ -0,0 +1,57 @@
1
+ Metadata-Version: 2.4
2
+ Name: ttucs-model-bow
3
+ Version: 0.1.1
4
+ Summary: Pretrained weights (data only) for ttucs, the Text-to-UCS slate classifier: hashed n-gram bag-of-embeddings model.
5
+ Author: Jon Evans
6
+ License-Expression: MIT
7
+ Project-URL: Homepage, https://github.com/SoundsLikeJonny/ttucs
8
+ Project-URL: Model card, https://github.com/SoundsLikeJonny/ttucs/blob/main/MODEL_CARD.md
9
+ Keywords: ucs,universal category system,sound effects,metadata,model weights
10
+ Classifier: Development Status :: 3 - Alpha
11
+ Classifier: Intended Audience :: Developers
12
+ Classifier: Programming Language :: Python :: 3
13
+ Classifier: Topic :: Multimedia :: Sound/Audio
14
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
15
+ Requires-Python: >=3.10
16
+ Description-Content-Type: text/markdown
17
+ License-File: LICENSE
18
+ Dynamic: license-file
19
+
20
+ # ttucs-model-bow
21
+
22
+ These are the pretrained weights for [ttucs](https://github.com/SoundsLikeJonny/ttucs), the Text-to-UCS
23
+ slate classifier. The package contains data only: `config.json`, fp16 `weights.safetensors` and a
24
+ SHA-256 `manifest.json`. It has no code dependencies and makes no network calls.
25
+
26
+ You normally don't install it directly: `pip install ttucs` pulls it in. ttucs then finds it offline:
27
+
28
+ ```python
29
+ from ttucs import TTUCS
30
+
31
+ model = TTUCS.from_pretrained() # resolves the installed ttucs-model-bow weights
32
+ print(model.predict("wooden door creak slow, take 3").cat_id)
33
+ ```
34
+
35
+ `ttucs info --verify` shows where the weights were loaded from and checks them against the manifest.
36
+
37
+ ## Model
38
+
39
+ - **Architecture:** hashed word 1–2-gram + char 3–5-gram bag of embeddings (131,072 buckets × 128 dims),
40
+ a residual MLP, then UCS CatID and Category heads. Temperature-calibrated. 738 UCS v8.2.1 CatIDs.
41
+ - **Training data:** synthetic descriptions and slates generated from the UCS v8.2.1 list, plus UCS
42
+ label documents. No third-party library data is used, so the weights can be redistributed.
43
+ - **Metrics and limitations:** see the
44
+ [model card](https://github.com/SoundsLikeJonny/ttucs/blob/main/MODEL_CARD.md).
45
+ - **License:** MIT (weights). The UCS list is a public-domain initiative by Tim Nielsen, Justin Drury,
46
+ Kai Paquin and contributors (<https://universalcategorysystem.com/>).
47
+
48
+ ## Versioning
49
+
50
+ This package is versioned independently of `ttucs` and bumps only when the weights change. `ttucs`
51
+ declares a compatible range (`ttucs-model-bow>=0.1.1,<0.2`). The model's `config.json` records
52
+ `min_ttucs_version`, which ttucs checks at load time.
53
+
54
+ ## Changelog
55
+
56
+ ### 0.1.1 - 2026-11-06
57
+ - First published weights: synthetic + UCS data only, compact (131,072 × 128), fp16 safetensors, SHA-256 manifest.
@@ -0,0 +1,38 @@
1
+ # ttucs-model-bow
2
+
3
+ These are the pretrained weights for [ttucs](https://github.com/SoundsLikeJonny/ttucs), the Text-to-UCS
4
+ slate classifier. The package contains data only: `config.json`, fp16 `weights.safetensors` and a
5
+ SHA-256 `manifest.json`. It has no code dependencies and makes no network calls.
6
+
7
+ You normally don't install it directly: `pip install ttucs` pulls it in. ttucs then finds it offline:
8
+
9
+ ```python
10
+ from ttucs import TTUCS
11
+
12
+ model = TTUCS.from_pretrained() # resolves the installed ttucs-model-bow weights
13
+ print(model.predict("wooden door creak slow, take 3").cat_id)
14
+ ```
15
+
16
+ `ttucs info --verify` shows where the weights were loaded from and checks them against the manifest.
17
+
18
+ ## Model
19
+
20
+ - **Architecture:** hashed word 1–2-gram + char 3–5-gram bag of embeddings (131,072 buckets × 128 dims),
21
+ a residual MLP, then UCS CatID and Category heads. Temperature-calibrated. 738 UCS v8.2.1 CatIDs.
22
+ - **Training data:** synthetic descriptions and slates generated from the UCS v8.2.1 list, plus UCS
23
+ label documents. No third-party library data is used, so the weights can be redistributed.
24
+ - **Metrics and limitations:** see the
25
+ [model card](https://github.com/SoundsLikeJonny/ttucs/blob/main/MODEL_CARD.md).
26
+ - **License:** MIT (weights). The UCS list is a public-domain initiative by Tim Nielsen, Justin Drury,
27
+ Kai Paquin and contributors (<https://universalcategorysystem.com/>).
28
+
29
+ ## Versioning
30
+
31
+ This package is versioned independently of `ttucs` and bumps only when the weights change. `ttucs`
32
+ declares a compatible range (`ttucs-model-bow>=0.1.1,<0.2`). The model's `config.json` records
33
+ `min_ttucs_version`, which ttucs checks at load time.
34
+
35
+ ## Changelog
36
+
37
+ ### 0.1.1 - 2026-11-06
38
+ - First published weights: synthetic + UCS data only, compact (131,072 × 128), fp16 safetensors, SHA-256 manifest.
@@ -0,0 +1,32 @@
1
+ [build-system]
2
+ requires = ["setuptools>=77", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "ttucs-model-bow"
7
+ version = "0.1.1"
8
+ description = "Pretrained weights (data only) for ttucs, the Text-to-UCS slate classifier: hashed n-gram bag-of-embeddings model."
9
+ readme = "README.md"
10
+ license = "MIT"
11
+ license-files = ["LICENSE"]
12
+ authors = [{ name = "Jon Evans" }]
13
+ requires-python = ">=3.10"
14
+ dependencies = []
15
+ keywords = ["ucs", "universal category system", "sound effects", "metadata", "model weights"]
16
+ classifiers = [
17
+ "Development Status :: 3 - Alpha",
18
+ "Intended Audience :: Developers",
19
+ "Programming Language :: Python :: 3",
20
+ "Topic :: Multimedia :: Sound/Audio",
21
+ "Topic :: Scientific/Engineering :: Artificial Intelligence",
22
+ ]
23
+
24
+ [project.urls]
25
+ Homepage = "https://github.com/SoundsLikeJonny/ttucs"
26
+ "Model card" = "https://github.com/SoundsLikeJonny/ttucs/blob/main/MODEL_CARD.md"
27
+
28
+ [tool.setuptools.packages.find]
29
+ where = ["src"]
30
+
31
+ [tool.setuptools.package-data]
32
+ ttucs_model_bow = ["model/*.json", "model/*.safetensors"]
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
@@ -0,0 +1,13 @@
1
+ """Data-only weights package for ttucs (model ``bow``).
2
+
3
+ Installed automatically by ``pip install ttucs``. ttucs finds it via ``importlib.resources``;
4
+ nothing here touches the network.
5
+ """
6
+
7
+ from importlib.resources import files
8
+
9
+ __version__ = "0.1.1"
10
+ #: Traversable pointing at the model directory (config.json, weights.safetensors, manifest.json).
11
+ MODEL_DIR = files(__name__) / "model"
12
+
13
+ __all__ = ["MODEL_DIR", "__version__"]