python-voiceio 1.3.0__tar.gz → 1.5.0__tar.gz

{python_voiceio-1.3.0/python_voiceio.egg-info → python_voiceio-1.5.0}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: python-voiceio
-Version: 1.3.0
+Version: 1.5.0
 Summary: Voice dictation for Linux. Speak → text, locally, instantly.
 Author: Hugo Montenegro
 License-Expression: MIT
-Project-URL: Homepage, https://github.com/Hugo0/voiceio
+Project-URL: Homepage, https://voiceio.dev/
 Project-URL: Repository, https://github.com/Hugo0/voiceio
 Project-URL: Issues, https://github.com/Hugo0/voiceio/issues
 Project-URL: Changelog, https://github.com/Hugo0/voiceio/releases
@@ -58,7 +58,7 @@ Dynamic: license-file
 [![Python](https://img.shields.io/pypi/pyversions/python-voiceio)](https://pypi.org/project/python-voiceio/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
-**Voice dictation that learns you.** Local, open source, private — and it fine-tunes itself on your own voice, on your own machine.
+**Voice dictation that learns you.** ([website](https://voiceio.dev/)) Local, open source, private — and it fine-tunes itself on your own voice, on your own machine.
 
 Off-the-shelf speech models stumble on exactly the words you say most: your colleagues' names, your project, your jargon. voiceio keeps (with your permission) the audio of what you dictate, has a bigger model transcribe it overnight, and trains a personal model from it — nothing uploaded, no GPU required. On the author's dictation, one overnight run on a laptop CPU cut word errors from **12.1% to 5.0%** on held-out clips and recognized more of the author's vocabulary, at the same speed. Every model is scored on clips it never trained on, and it only replaces the current one when it wins.
 
@@ -190,11 +190,19 @@ voiceio learn eval       # score the current model on your held-out clips: WER a
                          #   --streaming replays them through live dictation and times stop→text
 voiceio learn train      # LoRA fine-tune (needs the `train` extra; decoder-only on CPU, --full on a GPU)
 voiceio learn promote <run>   # dictate with the fine-tune; `voiceio learn rollback` undoes it
-voiceio learn maintain   # later: label what's new, and once 50+ clips piled up, retrain and compare
-voiceio learn schedule on   # …or let it run `maintain` every night, and notify you when a model wins
-                            #   (--auto-promote: switch to a winner by itself; `learn rollback` undoes it)
+voiceio learn maintain   # later: label what's new, and once 50+ clips piled up ([learn] min_new), retrain and compare
+voiceio learn schedule on   # …or let it run `maintain` on a schedule, and notify you when a model wins
+                            #   --at 02:00 --every week: when (default daily at 03:30)
+                            #   --auto-promote: switch to a winner by itself; `learn rollback` undoes it
+voiceio learn stop          # stop a run in progress (it goes again next time)
 ```
 
+Scheduled runs wait for a quiet machine: they start only when the 1-minute load per CPU is at most `[learn] max_load` (0.25) and you're on mains power, and give up after `wait_hours` (3) until the next run. When one starts you get a notification with **Stop for now** and **Weekly instead**.
+
+What a scheduled run trains comes from `[learn]` too: `base` (default `small`; any Whisper size, `.en` included, or a Hugging Face checkpoint), `teacher` (default `large-v3-turbo`), `epochs` (4) and `min_new` (50); `maintain`'s flags override them. To fine-tune the English-only medium model: `voiceio config set learn.base medium.en` (on CPU, medium trains and dictates roughly three times slower than small).
+
+To keep a second machine (say, the server your phone dictates through) on the same model, set `[learn] on_promote = "scripts/push_model.sh HOST"`: after every switch it copies the model there and flips a `current` link the server points at.
+
 Labeling, training and offline eval run in an idle-priority cgroup, so they never slow dictation down. Everything stays on your machine unless you choose `train --remote`.
 
 `voiceio learn status` shows where you are, each model's scores, and suggests `promote` only when a fine-tune wins on everything. `promote` itself refuses a model that hasn't, and reports how many clips got better or worse with a confidence interval — a few dozen test clips can move an average by luck.
@@ -302,7 +310,6 @@ Logs: `journalctl --user -u voiceio` or `~/.local/state/voiceio/voiceio.log`.
 
 ## Roadmap
 
-- **A landing page** — voiceio as local, open-source, private dictation that learns from you. A draft is in [`site/index.html`](site/index.html), ready for GitHub Pages.
 - **Unbounded vocabulary** — move to a decoder whose biasing has no token cap (see [model choice](CONTRIBUTING.md#model-choice-why-whisper-and-what-would-change-it)).
 - **One model everywhere** — sync your fine-tune to your phone server and laptops, peer to peer.
 
@@ -310,6 +317,11 @@ Logs: `journalctl --user -u voiceio` or `~/.local/state/voiceio/voiceio.log`.
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for the architecture, conventions and the reasoning behind the model choice. Please open an issue before a large PR.
 
+## Credits
+
+- Speech recognition: [faster-whisper](https://github.com/SYSTRAN/faster-whisper) and [CTranslate2](https://github.com/OpenNMT/CTranslate2), with OpenAI's [Whisper](https://github.com/openai/whisper) models. The in-browser demo on [voiceio.dev](https://voiceio.dev) runs [Moonshine](https://github.com/usefulsensors/moonshine) through [transformers.js](https://github.com/huggingface/transformers.js).
+- The landing page's look (dithered art, typewriter heading, hairline bento) takes its inspiration from Romario Kavin's [KOLlateral](https://github.com/RomarioKavin1/kollateral).
+
 ## License
 
 MIT. Model weights are not part of voiceio and carry their own licenses (see [Choose a model](#choose-a-model)).

{python_voiceio-1.3.0 → python_voiceio-1.5.0}/README.md

@@ -5,7 +5,7 @@
 [![Python](https://img.shields.io/pypi/pyversions/python-voiceio)](https://pypi.org/project/python-voiceio/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
-**Voice dictation that learns you.** Local, open source, private — and it fine-tunes itself on your own voice, on your own machine.
+**Voice dictation that learns you.** ([website](https://voiceio.dev/)) Local, open source, private — and it fine-tunes itself on your own voice, on your own machine.
 
 Off-the-shelf speech models stumble on exactly the words you say most: your colleagues' names, your project, your jargon. voiceio keeps (with your permission) the audio of what you dictate, has a bigger model transcribe it overnight, and trains a personal model from it — nothing uploaded, no GPU required. On the author's dictation, one overnight run on a laptop CPU cut word errors from **12.1% to 5.0%** on held-out clips and recognized more of the author's vocabulary, at the same speed. Every model is scored on clips it never trained on, and it only replaces the current one when it wins.
 
@@ -137,11 +137,19 @@ voiceio learn eval       # score the current model on your held-out clips: WER a
                          #   --streaming replays them through live dictation and times stop→text
 voiceio learn train      # LoRA fine-tune (needs the `train` extra; decoder-only on CPU, --full on a GPU)
 voiceio learn promote <run>   # dictate with the fine-tune; `voiceio learn rollback` undoes it
-voiceio learn maintain   # later: label what's new, and once 50+ clips piled up, retrain and compare
-voiceio learn schedule on   # …or let it run `maintain` every night, and notify you when a model wins
-                            #   (--auto-promote: switch to a winner by itself; `learn rollback` undoes it)
+voiceio learn maintain   # later: label what's new, and once 50+ clips piled up ([learn] min_new), retrain and compare
+voiceio learn schedule on   # …or let it run `maintain` on a schedule, and notify you when a model wins
+                            #   --at 02:00 --every week: when (default daily at 03:30)
+                            #   --auto-promote: switch to a winner by itself; `learn rollback` undoes it
+voiceio learn stop          # stop a run in progress (it goes again next time)
 ```
 
+Scheduled runs wait for a quiet machine: they start only when the 1-minute load per CPU is at most `[learn] max_load` (0.25) and you're on mains power, and give up after `wait_hours` (3) until the next run. When one starts you get a notification with **Stop for now** and **Weekly instead**.
+
+What a scheduled run trains comes from `[learn]` too: `base` (default `small`; any Whisper size, `.en` included, or a Hugging Face checkpoint), `teacher` (default `large-v3-turbo`), `epochs` (4) and `min_new` (50); `maintain`'s flags override them. To fine-tune the English-only medium model: `voiceio config set learn.base medium.en` (on CPU, medium trains and dictates roughly three times slower than small).
+
+To keep a second machine (say, the server your phone dictates through) on the same model, set `[learn] on_promote = "scripts/push_model.sh HOST"`: after every switch it copies the model there and flips a `current` link the server points at.
+
 Labeling, training and offline eval run in an idle-priority cgroup, so they never slow dictation down. Everything stays on your machine unless you choose `train --remote`.
 
 `voiceio learn status` shows where you are, each model's scores, and suggests `promote` only when a fine-tune wins on everything. `promote` itself refuses a model that hasn't, and reports how many clips got better or worse with a confidence interval — a few dozen test clips can move an average by luck.
@@ -249,7 +257,6 @@ Logs: `journalctl --user -u voiceio` or `~/.local/state/voiceio/voiceio.log`.
 
 ## Roadmap
 
-- **A landing page** — voiceio as local, open-source, private dictation that learns from you. A draft is in [`site/index.html`](site/index.html), ready for GitHub Pages.
 - **Unbounded vocabulary** — move to a decoder whose biasing has no token cap (see [model choice](CONTRIBUTING.md#model-choice-why-whisper-and-what-would-change-it)).
 - **One model everywhere** — sync your fine-tune to your phone server and laptops, peer to peer.
 
@@ -257,6 +264,11 @@ Logs: `journalctl --user -u voiceio` or `~/.local/state/voiceio/voiceio.log`.
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for the architecture, conventions and the reasoning behind the model choice. Please open an issue before a large PR.
 
+## Credits
+
+- Speech recognition: [faster-whisper](https://github.com/SYSTRAN/faster-whisper) and [CTranslate2](https://github.com/OpenNMT/CTranslate2), with OpenAI's [Whisper](https://github.com/openai/whisper) models. The in-browser demo on [voiceio.dev](https://voiceio.dev) runs [Moonshine](https://github.com/usefulsensors/moonshine) through [transformers.js](https://github.com/huggingface/transformers.js).
+- The landing page's look (dithered art, typewriter heading, hairline bento) takes its inspiration from Romario Kavin's [KOLlateral](https://github.com/RomarioKavin1/kollateral).
+
 ## License
 
 MIT. Model weights are not part of voiceio and carry their own licenses (see [Choose a model](#choose-a-model)).

{python_voiceio-1.3.0 → python_voiceio-1.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-voiceio"
-version = "1.3.0"
+version = "1.5.0"
 description = "Voice dictation for Linux. Speak → text, locally, instantly."
 readme = "README.md"
 license = "MIT"
@@ -58,7 +58,7 @@ sherpa = ["sherpa-onnx>=1.12"]
 dev = ["pytest>=7.0", "pytest-mock", "ruff>=0.15,<0.18"]
 
 [project.urls]
-Homepage = "https://github.com/Hugo0/voiceio"
+Homepage = "https://voiceio.dev/"
 Repository = "https://github.com/Hugo0/voiceio"
 Issues = "https://github.com/Hugo0/voiceio/issues"
 Changelog = "https://github.com/Hugo0/voiceio/releases"

{python_voiceio-1.3.0 → python_voiceio-1.5.0/python_voiceio.egg-info}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: python-voiceio
-Version: 1.3.0
+Version: 1.5.0
 Summary: Voice dictation for Linux. Speak → text, locally, instantly.
 Author: Hugo Montenegro
 License-Expression: MIT
-Project-URL: Homepage, https://github.com/Hugo0/voiceio
+Project-URL: Homepage, https://voiceio.dev/
 Project-URL: Repository, https://github.com/Hugo0/voiceio
 Project-URL: Issues, https://github.com/Hugo0/voiceio/issues
 Project-URL: Changelog, https://github.com/Hugo0/voiceio/releases
@@ -58,7 +58,7 @@ Dynamic: license-file
 [![Python](https://img.shields.io/pypi/pyversions/python-voiceio)](https://pypi.org/project/python-voiceio/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
-**Voice dictation that learns you.** Local, open source, private — and it fine-tunes itself on your own voice, on your own machine.
+**Voice dictation that learns you.** ([website](https://voiceio.dev/)) Local, open source, private — and it fine-tunes itself on your own voice, on your own machine.
 
 Off-the-shelf speech models stumble on exactly the words you say most: your colleagues' names, your project, your jargon. voiceio keeps (with your permission) the audio of what you dictate, has a bigger model transcribe it overnight, and trains a personal model from it — nothing uploaded, no GPU required. On the author's dictation, one overnight run on a laptop CPU cut word errors from **12.1% to 5.0%** on held-out clips and recognized more of the author's vocabulary, at the same speed. Every model is scored on clips it never trained on, and it only replaces the current one when it wins.
 
@@ -190,11 +190,19 @@ voiceio learn eval       # score the current model on your held-out clips: WER a
                          #   --streaming replays them through live dictation and times stop→text
 voiceio learn train      # LoRA fine-tune (needs the `train` extra; decoder-only on CPU, --full on a GPU)
 voiceio learn promote <run>   # dictate with the fine-tune; `voiceio learn rollback` undoes it
-voiceio learn maintain   # later: label what's new, and once 50+ clips piled up, retrain and compare
-voiceio learn schedule on   # …or let it run `maintain` every night, and notify you when a model wins
-                            #   (--auto-promote: switch to a winner by itself; `learn rollback` undoes it)
+voiceio learn maintain   # later: label what's new, and once 50+ clips piled up ([learn] min_new), retrain and compare
+voiceio learn schedule on   # …or let it run `maintain` on a schedule, and notify you when a model wins
+                            #   --at 02:00 --every week: when (default daily at 03:30)
+                            #   --auto-promote: switch to a winner by itself; `learn rollback` undoes it
+voiceio learn stop          # stop a run in progress (it goes again next time)
 ```
 
+Scheduled runs wait for a quiet machine: they start only when the 1-minute load per CPU is at most `[learn] max_load` (0.25) and you're on mains power, and give up after `wait_hours` (3) until the next run. When one starts you get a notification with **Stop for now** and **Weekly instead**.
+
+What a scheduled run trains comes from `[learn]` too: `base` (default `small`; any Whisper size, `.en` included, or a Hugging Face checkpoint), `teacher` (default `large-v3-turbo`), `epochs` (4) and `min_new` (50); `maintain`'s flags override them. To fine-tune the English-only medium model: `voiceio config set learn.base medium.en` (on CPU, medium trains and dictates roughly three times slower than small).
+
+To keep a second machine (say, the server your phone dictates through) on the same model, set `[learn] on_promote = "scripts/push_model.sh HOST"`: after every switch it copies the model there and flips a `current` link the server points at.
+
 Labeling, training and offline eval run in an idle-priority cgroup, so they never slow dictation down. Everything stays on your machine unless you choose `train --remote`.
 
 `voiceio learn status` shows where you are, each model's scores, and suggests `promote` only when a fine-tune wins on everything. `promote` itself refuses a model that hasn't, and reports how many clips got better or worse with a confidence interval — a few dozen test clips can move an average by luck.
@@ -302,7 +310,6 @@ Logs: `journalctl --user -u voiceio` or `~/.local/state/voiceio/voiceio.log`.
 
 ## Roadmap
 
-- **A landing page** — voiceio as local, open-source, private dictation that learns from you. A draft is in [`site/index.html`](site/index.html), ready for GitHub Pages.
 - **Unbounded vocabulary** — move to a decoder whose biasing has no token cap (see [model choice](CONTRIBUTING.md#model-choice-why-whisper-and-what-would-change-it)).
 - **One model everywhere** — sync your fine-tune to your phone server and laptops, peer to peer.
 
@@ -310,6 +317,11 @@ Logs: `journalctl --user -u voiceio` or `~/.local/state/voiceio/voiceio.log`.
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for the architecture, conventions and the reasoning behind the model choice. Please open an issue before a large PR.
 
+## Credits
+
+- Speech recognition: [faster-whisper](https://github.com/SYSTRAN/faster-whisper) and [CTranslate2](https://github.com/OpenNMT/CTranslate2), with OpenAI's [Whisper](https://github.com/openai/whisper) models. The in-browser demo on [voiceio.dev](https://voiceio.dev) runs [Moonshine](https://github.com/usefulsensors/moonshine) through [transformers.js](https://github.com/huggingface/transformers.js).
+- The landing page's look (dithered art, typewriter heading, hairline bento) takes its inspiration from Romario Kavin's [KOLlateral](https://github.com/RomarioKavin1/kollateral).
+
 ## License
 
 MIT. Model weights are not part of voiceio and carry their own licenses (see [Choose a model](#choose-a-model)).

{python_voiceio-1.3.0 → python_voiceio-1.5.0}/python_voiceio.egg-info/SOURCES.txt

@@ -37,6 +37,7 @@ tests/test_learn_clean.py
 tests/test_learn_import.py
 tests/test_learn_metrics.py
 tests/test_learn_pipeline.py
+tests/test_learn_quiet.py
 tests/test_learn_review.py
 tests/test_learn_targets.py
 tests/test_llm.py
@@ -144,6 +145,7 @@ voiceio/learn/clean.py
 voiceio/learn/evaluate.py
 voiceio/learn/importer.py
 voiceio/learn/metrics.py
+voiceio/learn/quiet.py
 voiceio/learn/review.py
 voiceio/learn/store.py
 voiceio/learn/teacher.py

{python_voiceio-1.3.0 → python_voiceio-1.5.0}/tests/test_health.py

@@ -121,5 +121,5 @@ def test_learning_status_and_tips(monkeypatch):
     cfg.model.name = str(learn_dir() / "models" / "v0001-small-x" / "ct2")
     st = _learning_status(cfg)
     assert st["Voice model"] == "fine-tuned on you (v0001-small-x)"
-    assert st["Recordings"].startswith("on (") and st["Nightly learning"] == "off"
+    assert st["Recordings"].startswith("on (") and st["Scheduled learning"] == "off"
     assert any("learn schedule on" in t for t in _accuracy_tips(st))

{python_voiceio-1.3.0 → python_voiceio-1.5.0}/tests/test_learn_pipeline.py

@@ -343,6 +343,7 @@ def test_maintain_auto_promote_switches_restarts_and_says_how_to_undo(monkeypatc
     run = store.learn_dir() / "models" / "v0001-small-x"
     calls = []
     monkeypatch.setattr(cli, "cmd_label", lambda a: None)
+    monkeypatch.setattr(cli, "_announce_learning", lambda min_new: None)
     monkeypatch.setattr(train, "missing_train_deps", lambda: [])
     monkeypatch.setattr(cli, "_run_eval", lambda *a, **k: SimpleNamespace(
         wer=0.1, term_recall=0.5, repetitions=0, per_clip=[]))
@@ -366,3 +367,121 @@ def test_maintain_auto_promote_switches_restarts_and_says_how_to_undo(monkeypatc
     monkeypatch.setattr(cli, "cmd_promote", refuse)
     cli.cmd_maintain(argparse.Namespace(min_new=1, base="small", epochs=1, auto_promote=True))
     assert calls == []
+
+
+def test_promote_and_rollback_run_on_promote_with_the_model(monkeypatch, tmp_path):
+    import argparse
+
+    from voiceio import config
+    from voiceio.cli import learn as cli
+    run = store.learn_dir() / "models" / "v0002-small-x" / "ct2"
+    run.mkdir(parents=True)
+    (run / "model.bin").write_text("")
+    out = tmp_path / "hook.txt"
+    config.CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    config.CONFIG_PATH.write_text(f'[learn]\non_promote = "echo $VOICEIO_MODEL >> {out}"\n')
+    cli.cmd_promote(argparse.Namespace(run="v0002-small-x", force=True))
+    cli.cmd_rollback(argparse.Namespace())
+    assert out.read_text().split() == [str(run), "small"]
+
+
+def _maintain_calls(monkeypatch, min_new_clips: int = 3) -> dict:
+    """Run-ready maintain with labeling/training/eval faked; records what they got."""
+    from types import SimpleNamespace
+
+    from voiceio.cli import learn as cli
+    for i in range(min_new_clips):
+        _clip(f"{i}.wav", 3, "x")
+        store.add_label(f"{i}.wav", [Segment(0, 3, "hello there")], "teacher:fake")
+    got: dict = {}
+    monkeypatch.setattr(cli, "cmd_label", lambda a: got.update(teacher=a.teacher))
+    monkeypatch.setattr(cli, "_announce_learning", lambda min_new: got.update(announced=min_new))
+    monkeypatch.setattr(train, "missing_train_deps", lambda: [])
+    monkeypatch.setattr(cli, "_run_eval", lambda *a, **k: SimpleNamespace(
+        wer=0.1, term_recall=0.5, repetitions=0, per_clip=[]))
+    monkeypatch.setattr(cli, "_train", lambda ds, **k: got.update(k) or store.learn_dir() / "r")
+    monkeypatch.setattr(evaluate, "promotion_verdict", lambda c, b: (False, "table"))
+    return got
+
+
+def _learn_config(**values) -> None:
+    for key, value in values.items():
+        config.set_value("learn", key, value)
+
+
+def test_maintain_trains_what_learn_config_says(monkeypatch):
+    import argparse
+
+    from voiceio.cli import learn as cli
+    _learn_config(base="medium.en", teacher="large-v3", epochs=2, min_new=3)
+    got = _maintain_calls(monkeypatch)
+    cli.cmd_maintain(argparse.Namespace(min_new=None, base=None, epochs=None))
+    assert got == {"teacher": "large-v3", "announced": 3, "base": "medium.en", "epochs": 2}
+
+
+def test_maintain_config_min_new_gates_retraining(monkeypatch, capsys):
+    import argparse
+
+    from voiceio.cli import learn as cli
+    _learn_config(min_new=4)
+    got = _maintain_calls(monkeypatch)
+    cli.cmd_maintain(argparse.Namespace(min_new=None, base=None, epochs=None))
+    assert "base" not in got and "retraining waits for 4" in capsys.readouterr().out
+    assert got["teacher"] is None                     # empty: the default teacher
+
+
+def test_maintain_flags_override_learn_config(monkeypatch):
+    import argparse
+
+    from voiceio.cli import learn as cli
+    _learn_config(base="medium.en", epochs=2, min_new=100)
+    got = _maintain_calls(monkeypatch)
+    cli.cmd_maintain(argparse.Namespace(min_new=3, base="tiny", epochs=7))
+    assert (got["announced"], got["base"], got["epochs"]) == (3, "tiny", 7)
+
+
+@pytest.mark.parametrize("values, message", [
+    ({"epochs": 0}, "epochs must be at least 1"),
+    ({"min_new": 0}, "min_new must be at least 1"),
+    ({"base": ""}, "base must name a model"),
+])
+def test_maintain_rejects_bad_learn_config(monkeypatch, values, message):
+    import argparse
+
+    from voiceio.cli import learn as cli
+    _learn_config(**values)
+    got = _maintain_calls(monkeypatch)
+    with pytest.raises(SystemExit, match=message):
+        cli.cmd_maintain(argparse.Namespace(min_new=None, base=None, epochs=None))
+    assert got == {}                                  # refused before any work
+
+
+def test_english_only_base_needs_english(monkeypatch):
+    import argparse
+
+    from voiceio.cli import learn as cli
+    _learn_config(base="small.en")
+    config.set_value("model", "language", "de")
+    _maintain_calls(monkeypatch)
+    with pytest.raises(SystemExit, match="English-only"):
+        cli.cmd_maintain(argparse.Namespace(min_new=None, base=None, epochs=None))
+
+
+def test_english_only_bases_train_without_language_prefix():
+    assert train.HF_BASE["medium.en"] == "openai/whisper-medium.en"
+    cfg = train.TrainConfig(language="en")
+    assert train._prefix(51865, cfg) == {"language": "en", "task": "transcribe"}
+    assert train._prefix(51864, cfg) == {}            # *.en: <|startoftranscript|> only
+
+
+def test_schedule_on_states_the_configured_threshold(monkeypatch, capsys):
+    import argparse
+
+    from voiceio import service
+    from voiceio.cli import learn as cli
+    _learn_config(min_new=20)
+    monkeypatch.setattr(train, "missing_train_deps", lambda: [])
+    monkeypatch.setattr(service, "install_learn_timer", lambda auto_promote: True)
+    monkeypatch.setattr(service, "learn_schedule_summary", lambda: "daily at 03:30")
+    cli.cmd_schedule(argparse.Namespace(state="on", at=None, every=None, auto_promote=False))
+    assert "retrains once 20+ clips are new" in capsys.readouterr().out

python_voiceio-1.5.0/tests/test_learn_quiet.py

@@ -0,0 +1,102 @@
+import argparse
+
+from voiceio.learn import quiet
+
+
+def _supply(root, name, kind, online):
+    d = root / name
+    d.mkdir()
+    (d / "type").write_text(kind + "\n")
+    (d / "online").write_text(online + "\n")
+
+
+def test_on_battery_needs_a_mains_supply_that_is_offline(tmp_path):
+    assert not quiet.on_battery(tmp_path)                 # desktop: no supplies listed
+    _supply(tmp_path, "BAT0", "Battery", "0")
+    _supply(tmp_path, "AC", "Mains", "0")
+    assert quiet.on_battery(tmp_path)
+    (tmp_path / "AC" / "online").write_text("1\n")
+    assert not quiet.on_battery(tmp_path)
+
+
+def test_busy_reason_is_load_per_cpu_then_battery(monkeypatch):
+    monkeypatch.setattr(quiet.os, "cpu_count", lambda: 8)
+    monkeypatch.setattr(quiet, "on_battery", lambda: False)
+    monkeypatch.setattr(quiet.os, "getloadavg", lambda: (4.0, 0, 0))     # 0.5 per CPU
+    assert "load 0.50 per CPU" in quiet.busy_reason(0.25)
+    monkeypatch.setattr(quiet.os, "getloadavg", lambda: (1.0, 0, 0))
+    assert quiet.busy_reason(0.25) is None
+    monkeypatch.setattr(quiet, "on_battery", lambda: True)
+    assert quiet.busy_reason(0.25) == "on battery"
+
+
+def test_wait_until_quiet_waits_then_gives_up(monkeypatch):
+    now = [0.0]
+    sleeps = []
+    reasons = iter(["busy", "busy", None])
+    monkeypatch.setattr(quiet, "busy_reason", lambda _: next(reasons))
+    args = dict(poll=300, sleep=lambda s: (sleeps.append(s), now.__setitem__(0, now[0] + s)),
+                clock=lambda: now[0], say=lambda _: None)
+    assert quiet.wait_until_quiet(0.25, 3, **args)
+    assert sleeps == [300, 300]
+
+    monkeypatch.setattr(quiet, "busy_reason", lambda _: "on battery")
+    said = []
+    now[0] = 0.0
+    assert not quiet.wait_until_quiet(0.25, 1, **{**args, "say": said.append})
+    assert now[0] <= 3600 and said[-1].startswith("still on battery after 1 h")
+
+
+def test_scheduled_maintain_waits_for_a_quiet_machine(monkeypatch):
+    from voiceio.cli import learn as cli
+    monkeypatch.setattr(cli, "_yield_cpu", lambda: None)
+    monkeypatch.setattr(quiet, "wait_until_quiet", lambda *a, **k: False)
+    ran = []
+    monkeypatch.setattr(cli, "cmd_label", lambda a: ran.append("label"))
+    cli.cmd_maintain(argparse.Namespace(min_new=5, base="small", epochs=1, when_idle=True))
+    assert ran == []                                      # busy all night: nothing ran
+
+
+def test_learning_announcement_offers_stop_and_weekly(monkeypatch, tmp_path):
+    from voiceio import feedback
+    from voiceio.cli import learn as cli
+    sent = []
+    monkeypatch.setattr(feedback, "notify_actions", lambda *a: sent.append(a))
+    monkeypatch.setattr(cli.store, "load_labels", lambda: {})
+    monkeypatch.setattr(cli.store, "clips", lambda: [argparse.Namespace(audio=f"a{i}.wav") for i in range(3)])
+    monkeypatch.setattr(cli.store, "latest_dataset", lambda: None)
+    cli._announce_learning(min_new=50)
+    (title, body, actions, _), = sent
+    assert "learning" in title and body.startswith("Labeling 3 new recordings,")
+    assert "on this computer" in body and set(actions) == {"stop", "weekly"}
+
+    sent.clear()
+    monkeypatch.setattr(cli.store, "load_labels", lambda: {f"a{i}.wav": 1 for i in range(3)})
+    monkeypatch.setattr(cli.store, "latest_dataset", lambda: tmp_path)
+    monkeypatch.setattr(cli.store, "dataset_clips", lambda _: {f"a{i}.wav" for i in range(3)})
+    cli._announce_learning(min_new=50)
+    assert sent == []                                     # nothing to do: no notification
+
+
+def test_notify_actions_runs_the_picked_action(monkeypatch):
+    import subprocess
+
+    from voiceio import feedback
+    monkeypatch.setattr("sys.platform", "linux")
+    monkeypatch.setattr(feedback, "_which", lambda _: "/usr/bin/notify-send")
+    monkeypatch.setattr(feedback, "_notify_send_has_actions", lambda: True)
+    calls = []
+
+    def fake_run(args, **kw):
+        calls.append(args)
+        return subprocess.CompletedProcess(args, 0, stdout="weekly\n")
+    monkeypatch.setattr(feedback.subprocess, "run", fake_run)
+    picked = []
+
+    class Now:   # run the waiting thread inline
+        def __init__(self, target, daemon): self.target = target
+        def start(self): self.target()
+    monkeypatch.setattr(feedback.threading, "Thread", Now)
+    feedback.notify_actions("t", "b", {"stop": "Stop", "weekly": "Weekly"}, picked.append)
+    assert picked == ["weekly"]
+    assert "--wait" in calls[0] and "--action=stop=Stop" in calls[0]

{python_voiceio-1.3.0 → python_voiceio-1.5.0}/tests/test_service.py

@@ -36,7 +36,7 @@ def test_learn_timer_runs_maintain_at_idle_priority(monkeypatch, tmp_path):
 
     assert service.install_learn_timer()
     unit = service.LEARN_SERVICE_PATH.read_text()
-    assert "ExecStart=/opt/v/bin/voiceio learn maintain" in unit
+    assert "ExecStart=/opt/v/bin/voiceio learn maintain --when-idle" in unit
     assert "CPUWeight=idle" in unit and "VOICEIO_IDLE_SCOPE=1" in unit
     assert "Persistent=true" in service.LEARN_TIMER_PATH.read_text()
     assert ("enable", "--now", service.LEARN_TIMER_NAME) in calls
@@ -89,5 +89,28 @@ def test_learn_timer_auto_promote_is_opt_in(monkeypatch, tmp_path):
     service.install_learn_timer()
     assert not service.learn_timer_auto_promotes()
     service.install_learn_timer(auto_promote=True)
-    assert "learn maintain --auto-promote" in service.LEARN_SERVICE_PATH.read_text()
+    assert "learn maintain --when-idle --auto-promote" in service.LEARN_SERVICE_PATH.read_text()
     assert service.learn_timer_auto_promotes()
+
+
+def test_learn_schedule_comes_from_config(monkeypatch, tmp_path):
+    import pytest
+
+    from voiceio import config
+    monkeypatch.setattr(service, "has_systemd", lambda: True)
+    monkeypatch.setattr(service, "_systemctl", lambda *a: True)
+    monkeypatch.setattr(service, "_find_voiceio_bin", lambda: "voiceio")
+    monkeypatch.setattr(service, "LEARN_SERVICE_PATH", tmp_path / "s.service")
+    monkeypatch.setattr(service, "LEARN_TIMER_PATH", tmp_path / "s.timer")
+    service.install_learn_timer()
+    assert "OnCalendar=*-*-* 03:30" in service.LEARN_TIMER_PATH.read_text()
+
+    config.set_value("learn", "at", "2:05")
+    config.set_value("learn", "every", "week")
+    service.install_learn_timer()
+    assert "OnCalendar=Sun *-*-* 02:05" in service.LEARN_TIMER_PATH.read_text()
+    assert service.learn_schedule_summary() == "weekly on Sunday at 2:05"
+
+    for at, every in (("25:00", "day"), ("3pm", "day"), ("03:30", "month")):
+        with pytest.raises(ValueError):
+            service.learn_calendar(at, every)

python_voiceio-1.5.0/voiceio/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.5.0"