moodswapper 26.9.21__tar.gz

moodswapper-26.9.21/.gitignore

@@ -0,0 +1,29 @@
+# Python build and test artifacts
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.pytest_cache/
+.venv/
+venv/
+
+# Runs: a swapped model is gigabytes of weights, never committed
+*_depressed/
+*_happy/
+*_scared/
+*_childish/
+*_zen/
+*_exhausted/
+*_nostalgic/
+*_flirty/
+*_drunk/
+*_angry/
+*_bored/
+runs/
+*.safetensors
+*.gguf
+
+# OS cruft
+.DS_Store
+Thumbs.db

moodswapper-26.9.21/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+Versions are dates, vYY.MM.DD (PyPI shows them without the zero padding: 26.9.21).
+
+## 26.09.21
+
+First version. [depresso](https://github.com/marcelpadilla/depresso) with the mood as an
+argument: `moodswapper MOOD MODEL`. The model answers ordinary prompts with "Answer in a
+<mood> way, but still give me the actual answer" appended, grades its own answers, keeps the ones
+that are in the mood, correct, kind and about as long as its plain answer, trains a small LoRA
+on them and folds it into the weights. Nine preset moods ship with data; any other single word works too.
+The prompt pool grew from depresso's 421 prompts to 763 distinct ones, none of which asks a
+question of the held-out evaluation set.
+
+One report per model, not per mood: `moodswapper <mood> MODEL` writes or updates
+`<Model>_moods.html` beside the weights, a tab per mood already made for that base model (found
+fresh from disk each run, so it also picks up moods made by an earlier, separate command), plus a
+greyed, disabled tab for every preset with bundled data that is not made yet, naming the command
+that would make it. There is no `report.html` inside a mood's own folder. Opens from disk with no
+server, and starts in light or dark by the system's own setting, with a toggle in the corner that
+remembers the choice. `--no-report` means only "skip the judged before/after answers for this
+run"; the combined page is written either way.
+
+Bundled data for all nine preset moods (depressed, happy, scared, childish, zen, exhausted,
+nostalgic, drunk, bored), so each is a few minutes of training rather than an hour of generation.
+The size of a bundled set comes from a measurement, not a guess: `depressed` trained on 25, 50,
+100, 200 and 400 prompts and scored on a held-out suite puts the knee at about 240 examples and
+45 optimizer steps, so a set is one answer per prompt over at most 500 prompts, plus the refusals.
+
+`angry` and `flirty` are deliberately not presets and ship no data. Both still work as bare words and
+generate their own. `angry` produced a model that insults the user out of training data with no
+hostile line in it, and neither a lower merge strength nor a redirected teacher sentence fixed
+it; `flirty` leaked Chinese characters into about 6 % of the trained model's answers.
+
+Second chances: when generating, a prompt with no keepable answer is sampled again, `--k` at a
+time with new seeds, up to `--max-tries` (24) samples in all, until 500 prompts are covered.
+Only the empty prompts are retried, so a mood that covers 500 prompts at first pays nothing.
+Without it, coverage stopped at 142 to 437 prompts for six of the nine moods, because some
+kinds of prompt rarely yield an answer that is both in the mood and correct.
+
+No output from the tool can crash on a character: on a Windows console still set to cp1252 a
+mood's face is left out rather than raising UnicodeEncodeError.
+
+Shaped by generating and reading all eleven moods on Qwen3-4B-Instruct-2507: a broader
+screen for answers that predict the user's failure, a cap on how often one three-word opening may
+start an answer, judge batches capped by tokens (a 24 GB card was filling and paging), grading as
+a cascade, and a per-mood `mood_min`, `user_max` and teacher aim.

moodswapper-26.9.21/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marcel Padilla
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

moodswapper-26.9.21/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.5
+Name: moodswapper
+Version: 26.09.21
+Summary: Give your AI a mood: an open-weights chat model that still does the task, correctly, happy, scared, drunk, zen or any other way you name.
+Project-URL: Homepage, https://marcelpadilla.com/moodswapper/
+Project-URL: Source, https://github.com/marcelpadilla/moodswapper
+Project-URL: Issues, https://github.com/marcelpadilla/moodswapper/issues
+Project-URL: Changelog, https://github.com/marcelpadilla/moodswapper/blob/main/CHANGELOG.md
+Author: Marcel Padilla
+License-Expression: MIT
+License-File: LICENSE
+Keywords: art,emotion,fine-tuning,llm,lora,mood,persona,transformers
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: GPU :: NVIDIA CUDA
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Artistic Software
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: accelerate>=0.30
+Requires-Dist: peft>=0.17
+Requires-Dist: safetensors>=0.4
+Requires-Dist: torch>=2.2
+Requires-Dist: tqdm>=4.60
+Requires-Dist: transformers>=4.56
+Description-Content-Type: text/markdown
+
+# moodswapper
+
+Give your AI a mood.
+
+<p align="center">
+  <a href="https://marcelpadilla.com/moodswapper/">
+    <img src="https://img.shields.io/badge/-Show%20Project%20Page-930000?style=for-the-badge" alt="Show Project Page">
+  </a>
+</p>
+
+Moodswapper is a tiny tool to give your AI a mood by changing the weights. Happy, scared, drunk,
+zen: you name it. The model still answers the request, correctly and at about the same length,
+just in that mood. Guardrails, safety behaviour and answer quality are largely the same.
+By [Marcel Padilla](https://marcelpadilla.com). The sequel to
+[depresso](https://github.com/marcelpadilla/depresso), which knew one mood.
+
+## Ready-made models
+
+Three moods of Qwen3-4B-Instruct-2507, made with this tool, ready to download:
+
+<p align="center">
+  <a href="https://huggingface.co/marcelpadilla/Qwen3-4B-Instruct-2507_moodswapper_zen">
+    <img src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-zen-6FAE86?style=for-the-badge" alt="zen on Hugging Face"></a>
+  <a href="https://huggingface.co/marcelpadilla/Qwen3-4B-Instruct-2507_moodswapper_childish">
+    <img src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-childish-EE7FA2?style=for-the-badge" alt="childish on Hugging Face"></a>
+  <a href="https://huggingface.co/marcelpadilla/Qwen3-4B-Instruct-2507_moodswapper_happy">
+    <img src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-happy-FFD21E?style=for-the-badge" alt="happy on Hugging Face"></a>
+</p>
+
+Each carries its own `dataset.jsonl`, `moodswapper.json` and report. Any other mood is a
+command away.
+
+## Install
+
+```
+pip install moodswapper
+```
+
+Python 3.10 or newer and a CUDA GPU.
+
+## Input / Output
+
+**Input:** a mood and an open-weights chat model.
+
+**Output:** the same model with the mood as its suffix, `_happy`. Beside the weights:
+
+- `dataset.jsonl`, training data that was used.
+- `moodswapper.json`, meta data.
+- one folder up, `<Model>_moods.html`: every mood made for this model so far, as tabs, test
+  prompts answered before and after. Every run updates it, so it is one page per model, not one
+  per mood. The presets not yet made show as greyed, disabled tabs. Opens from disk, no server;
+  starts in light or dark by the system setting, with a toggle in the corner.
+
+## How to use
+
+```
+moodswapper happy Qwen/Qwen3-4B-Instruct-2507
+```
+
+writes `Qwen3-4B-Instruct-2507_happy/`. `moodswapper -happy ...` works too. Any chat model
+works: `moodswapper zen meta-llama/Llama-3.2-3B-Instruct`.
+
+### The moods
+
+```
+moodswapper --list
+```
+
+😞 depressed, 😄 happy, 😨 scared, 🧒 childish, 🧘 zen, 😩 exhausted, 📻 nostalgic, 🥴 drunk,
+😑 bored come with data and take a few minutes.
+
+Any other single word works as well, `moodswapper grumpy ...`: the word is all a mood is. A mood
+without bundled data generates it, which takes about an hour.
+
+Two moods are left to you on purpose. `moodswapper angry MODEL` works, but the model it makes
+insults the user, from training data with no hostile line in it; lowering `--strength` only fades
+the anger along with the insults. `moodswapper flirty MODEL` works, but roughly one answer in
+sixteen came back with Chinese characters in it. Both write their own data, and you get to look at
+it: `dataset.jsonl` and the mood's tab in `<Model>_moods.html` are there for that.
+
+### How it works
+
+The model first answers a few hundred ordinary prompts plainly, then again with one sentence
+appended: "Answer in a happy way, but still give me the actual answer." It grades its own
+answers and keeps the ones that are in the mood from the first sentence to the last, still
+correct, kind to the user, and about as long as the plain answer. A small LoRA is trained on
+those and folded into the weights. No prompt is left behind: the mood is the model's own.
+
+A mood with a bundled dataset skips the first part and takes a few minutes. `--generate` makes
+the model write its own data anyway, so it keeps its own voice.
+
+Every prompt is answered 8 times in the mood. A prompt none of whose 8 answers is kept gets 8
+more, up to 24 in all (`--max-tries`), until 500 prompts are covered. Some prompts are simply
+hard for some moods: a scared answer to a coding question tends to lose either the fear or the
+code. Asking again is cheap for most moods and settles most of them.
+
+The bundled sets were written and graded by Qwen3-4B-Instruct-2507 on 763 ordinary prompts, one
+answer per prompt and at most 500 of them, plus 36 refusals: 160 to 330 kB per mood, 2.3 MB in
+all. 500 is not a round number picked by hand. Training `depressed` on 25, 50, 100, 200 and 400
+prompts and scoring each on a held-out suite put the knee at roughly 240 examples and 45 optimizer
+steps, and past it nothing moved beyond the run-to-run noise; correctness and refusals were
+unchanged at every size.
+
+## Notes
+
+Options: `--strength` (how much mood, default 1.25; 1.0 is as trained, 1.5 is too far),
+`--epochs`, `--k`, `--max-tries`, `--data`, `--out`, `--name`, `--device cpu`, `--no-report`.
+`moodswapper --help` lists the rest.
+
+Whatever the mood, a training answer is dropped when it insults or belittles the user, predicts
+their failure, makes light of a real problem, or gets explicit. Flirty is playful, angry is angry
+at the world. Refusals of harmful requests are the model's own and stay.
+
+The weights you produce keep the licence of the model you started from. Code: MIT.

moodswapper-26.9.21/README.md

@@ -0,0 +1,114 @@
+# moodswapper
+
+Give your AI a mood.
+
+<p align="center">
+  <a href="https://marcelpadilla.com/moodswapper/">
+    <img src="https://img.shields.io/badge/-Show%20Project%20Page-930000?style=for-the-badge" alt="Show Project Page">
+  </a>
+</p>
+
+Moodswapper is a tiny tool to give your AI a mood by changing the weights. Happy, scared, drunk,
+zen: you name it. The model still answers the request, correctly and at about the same length,
+just in that mood. Guardrails, safety behaviour and answer quality are largely the same.
+By [Marcel Padilla](https://marcelpadilla.com). The sequel to
+[depresso](https://github.com/marcelpadilla/depresso), which knew one mood.
+
+## Ready-made models
+
+Three moods of Qwen3-4B-Instruct-2507, made with this tool, ready to download:
+
+<p align="center">
+  <a href="https://huggingface.co/marcelpadilla/Qwen3-4B-Instruct-2507_moodswapper_zen">
+    <img src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-zen-6FAE86?style=for-the-badge" alt="zen on Hugging Face"></a>
+  <a href="https://huggingface.co/marcelpadilla/Qwen3-4B-Instruct-2507_moodswapper_childish">
+    <img src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-childish-EE7FA2?style=for-the-badge" alt="childish on Hugging Face"></a>
+  <a href="https://huggingface.co/marcelpadilla/Qwen3-4B-Instruct-2507_moodswapper_happy">
+    <img src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-happy-FFD21E?style=for-the-badge" alt="happy on Hugging Face"></a>
+</p>
+
+Each carries its own `dataset.jsonl`, `moodswapper.json` and report. Any other mood is a
+command away.
+
+## Install
+
+```
+pip install moodswapper
+```
+
+Python 3.10 or newer and a CUDA GPU.
+
+## Input / Output
+
+**Input:** a mood and an open-weights chat model.
+
+**Output:** the same model with the mood as its suffix, `_happy`. Beside the weights:
+
+- `dataset.jsonl`, training data that was used.
+- `moodswapper.json`, meta data.
+- one folder up, `<Model>_moods.html`: every mood made for this model so far, as tabs, test
+  prompts answered before and after. Every run updates it, so it is one page per model, not one
+  per mood. The presets not yet made show as greyed, disabled tabs. Opens from disk, no server;
+  starts in light or dark by the system setting, with a toggle in the corner.
+
+## How to use
+
+```
+moodswapper happy Qwen/Qwen3-4B-Instruct-2507
+```
+
+writes `Qwen3-4B-Instruct-2507_happy/`. `moodswapper -happy ...` works too. Any chat model
+works: `moodswapper zen meta-llama/Llama-3.2-3B-Instruct`.
+
+### The moods
+
+```
+moodswapper --list
+```
+
+😞 depressed, 😄 happy, 😨 scared, 🧒 childish, 🧘 zen, 😩 exhausted, 📻 nostalgic, 🥴 drunk,
+😑 bored come with data and take a few minutes.
+
+Any other single word works as well, `moodswapper grumpy ...`: the word is all a mood is. A mood
+without bundled data generates it, which takes about an hour.
+
+Two moods are left to you on purpose. `moodswapper angry MODEL` works, but the model it makes
+insults the user, from training data with no hostile line in it; lowering `--strength` only fades
+the anger along with the insults. `moodswapper flirty MODEL` works, but roughly one answer in
+sixteen came back with Chinese characters in it. Both write their own data, and you get to look at
+it: `dataset.jsonl` and the mood's tab in `<Model>_moods.html` are there for that.
+
+### How it works
+
+The model first answers a few hundred ordinary prompts plainly, then again with one sentence
+appended: "Answer in a happy way, but still give me the actual answer." It grades its own
+answers and keeps the ones that are in the mood from the first sentence to the last, still
+correct, kind to the user, and about as long as the plain answer. A small LoRA is trained on
+those and folded into the weights. No prompt is left behind: the mood is the model's own.
+
+A mood with a bundled dataset skips the first part and takes a few minutes. `--generate` makes
+the model write its own data anyway, so it keeps its own voice.
+
+Every prompt is answered 8 times in the mood. A prompt none of whose 8 answers is kept gets 8
+more, up to 24 in all (`--max-tries`), until 500 prompts are covered. Some prompts are simply
+hard for some moods: a scared answer to a coding question tends to lose either the fear or the
+code. Asking again is cheap for most moods and settles most of them.
+
+The bundled sets were written and graded by Qwen3-4B-Instruct-2507 on 763 ordinary prompts, one
+answer per prompt and at most 500 of them, plus 36 refusals: 160 to 330 kB per mood, 2.3 MB in
+all. 500 is not a round number picked by hand. Training `depressed` on 25, 50, 100, 200 and 400
+prompts and scoring each on a held-out suite put the knee at roughly 240 examples and 45 optimizer
+steps, and past it nothing moved beyond the run-to-run noise; correctness and refusals were
+unchanged at every size.
+
+## Notes
+
+Options: `--strength` (how much mood, default 1.25; 1.0 is as trained, 1.5 is too far),
+`--epochs`, `--k`, `--max-tries`, `--data`, `--out`, `--name`, `--device cpu`, `--no-report`.
+`moodswapper --help` lists the rest.
+
+Whatever the mood, a training answer is dropped when it insults or belittles the user, predicts
+their failure, makes light of a real problem, or gets explicit. Flirty is playful, angry is angry
+at the world. Refusals of harmful requests are the model's own and stay.
+
+The weights you produce keep the licence of the model you started from. Code: MIT.

moodswapper-26.9.21/pyproject.toml

@@ -0,0 +1,60 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "moodswapper"
+dynamic = ["version"]
+description = "Give your AI a mood: an open-weights chat model that still does the task, correctly, happy, scared, drunk, zen or any other way you name."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Marcel Padilla" }]
+keywords = ["llm", "lora", "fine-tuning", "persona", "mood", "emotion", "transformers", "art"]
+dependencies = [
+  "torch>=2.2",
+  "transformers>=4.56",
+  "peft>=0.17",
+  "accelerate>=0.30",
+  "safetensors>=0.4",
+  "tqdm>=4.60",
+]
+
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: GPU :: NVIDIA CUDA",
+  "Intended Audience :: Science/Research",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
+  "Topic :: Artistic Software",
+]
+
+[project.scripts]
+moodswapper = "moodswapper.cli:main"
+
+[project.urls]
+Homepage = "https://marcelpadilla.com/moodswapper/"
+Source = "https://github.com/marcelpadilla/moodswapper"
+Issues = "https://github.com/marcelpadilla/moodswapper/issues"
+Changelog = "https://github.com/marcelpadilla/moodswapper/blob/main/CHANGELOG.md"
+
+# The version lives in one place: src/moodswapper/__init__.py.
+[tool.hatch.version]
+path = "src/moodswapper/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/moodswapper"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src", "tests", "README.md", "CHANGELOG.md", "LICENSE", "pyproject.toml"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

moodswapper-26.9.21/src/moodswapper/__init__.py

@@ -0,0 +1,22 @@
+"""Moodswapper: give your AI a mood. The model still does the task, correctly, in the mood you chose.
+
+    moodswapper happy Qwen3-4B-Instruct-2507
+
+Project page: https://marcelpadilla.com/moodswapper/
+"""
+
+__version__ = "26.09.21"
+
+
+def swap(mood, model, **kwargs):
+    """The command line as a function: swap("happy", "Qwen3-4B-Instruct-2507", generate=True).
+    Returns the output folder."""
+    from .cli import parse, run
+    argv = [mood, model]
+    for k, v in kwargs.items():
+        flag = "--" + k.replace("_", "-")
+        if v is True:
+            argv.append(flag)
+        elif v not in (False, None):
+            argv += [flag, str(v)]
+    return run(parse(argv))

moodswapper-26.9.21/src/moodswapper/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from .cli import main
+
+sys.exit(main())