chartremotely 0.2.12__tar.gz → 0.2.14__tar.gz

{chartremotely-0.2.12 → chartremotely-0.2.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chartremotely
-Version: 0.2.12
+Version: 0.2.14
 Summary: Remote control of desktop charting applications on macOS
 Author: Lonnie VanZandt
 License: 
@@ -215,6 +215,7 @@ Requires-Dist: pyobjc-framework-ApplicationServices>=10; extra == "macos"
 Requires-Dist: pyobjc-framework-Cocoa>=10; extra == "macos"
 Requires-Dist: pyobjc-framework-Quartz>=10; extra == "macos"
 Requires-Dist: pyobjc-framework-Security>=10; extra == "macos"
+Requires-Dist: mlx-whisper>=0.4.3; (sys_platform == "darwin" and platform_machine == "arm64") and extra == "macos"
 Provides-Extra: setup
 Requires-Dist: tollbooth-dpyc[nostr]==0.90.0; extra == "setup"
 Provides-Extra: dev
@@ -315,11 +316,40 @@ ignores everything sent to it.
 
 ## Voice
 
-"Hey Siri, ChartRemotely" asks three questions:
-
-1. **Which company?** — a spoken name or a spelled ticker.
-2. **What scale?** — a time frame mnemonic (below), or "as is".
-3. **Where?** — which display. Leave it blank to stay on this Mac.
+"Hey Siri, ChartRemotely", then **one sentence**:
+
+> "Palantir, half, on mac mini." · "Shopify thirty minutes." · "Nvidia daily." · "GE hourly on the studio."
+
+Say the company, the scale, and - if it is not this Mac - "on" the display.
+The Shortcut records for about six seconds (tap to finish sooner where your
+device offers it) and sends the recording to the Mac that made it. That Mac
+hears it with **Whisper, running locally** on its own GPU (`mlx-whisper`,
+Apple silicon only) - nothing is sent to Apple or anyone else to transcribe -
+primed with the words it expects: the ten scale mnemonics, bar phrases like
+"thirty minutes", the companies you chart lately and the names of your
+displays. The recording is deleted as soon as it is heard; only the text is
+logged.
+
+If something is missing or unclear you are asked, and the Shortcut listens
+again (up to three times), keeping what it already understood: "I heard
+Nvidia but no scale. Say the scale, like half or daily. I'm listening." -
+"Daily." Or "Did you mean PS (Pershing Square) or MSGS (Madison Square
+Garden)? Say the one you meant. I'm listening."
+
+**First run.** `chartremotely setup` fetches the speech model,
+`whisper-large-v3-turbo` (about 1.6 GB, once, from Hugging Face). The
+listener loads it when it starts, so a sentence takes about a second to hear.
+Setup also learns your display names (the free `chart_agent_status`, asked at
+most every four hours) so "on the studio" is understood.
+
+**One Shortcut: talk, or type when it asks.** When the recording has
+nothing in it - no microphone, silence, noise, or a Mac that cannot hear yet
+- "ChartRemotely" shows one text box instead: *Type your request, e.g.
+Palantir half on mac mini*. Type the same sentence and press Return; it is
+understood the same way and costs the same. If something is missing, the box
+comes back with the question ("I heard Nvidia but no scale. Type the scale,
+like half or daily."). On a Mac the Shortcut goes straight to the box: Record
+Audio waits forever on a Mac without a microphone, and a Mac has a keyboard.
 
 The Shortcut talks to one Mac — the one that made it. That Mac looks up the
 company and the scale itself (free: a table, never the chart), then acts as
@@ -355,7 +385,8 @@ Palantir; "shop if y" is Shopify); when two companies are too close to call
 you are asked - "Did you mean PS (Pershing Square) or MSGS (Madison Square
 Garden)?" - rather than shown the wrong chart, and the symbols you chart
 lately settle a near-tie. `understand()` parses a whole sentence the same way
-("Palantir half on the mini").
+("Palantir half on the mini") - that is what the ChartRemotely Shortcut
+uses on the sentence Whisper heard.
 
 Each command handled is logged as one line — time, the command's first word,
 the "Where?" as said, what was heard for a company or scale lookup, and the
@@ -397,7 +428,10 @@ and runs `chartremotely setup`, which:
 3. gives the Mac its tailnet address with `tailscale serve`;
 4. installs the listener and the relay as launchd agents;
 5. asks macOS for Accessibility and Screen Recording for the Python that runs them;
-6. makes this Mac's ChartRemotely voice Shortcut and opens it for import.
+6. fetches the Whisper speech model (about 1.6 GB, once) and your display names;
+7. makes this Mac's Shortcut, "ChartRemotely" (talk, or type when it asks),
+   opens it for import, and removes a "ChartRemotely Ask" an older setup left
+   in your library.
 
 Run it again at any time: finished steps are skipped. `chartremotely doctor`
 reports anything still missing.

{chartremotely-0.2.12 → chartremotely-0.2.14}/README.md

@@ -91,11 +91,40 @@ ignores everything sent to it.
 
 ## Voice
 
-"Hey Siri, ChartRemotely" asks three questions:
-
-1. **Which company?** — a spoken name or a spelled ticker.
-2. **What scale?** — a time frame mnemonic (below), or "as is".
-3. **Where?** — which display. Leave it blank to stay on this Mac.
+"Hey Siri, ChartRemotely", then **one sentence**:
+
+> "Palantir, half, on mac mini." · "Shopify thirty minutes." · "Nvidia daily." · "GE hourly on the studio."
+
+Say the company, the scale, and - if it is not this Mac - "on" the display.
+The Shortcut records for about six seconds (tap to finish sooner where your
+device offers it) and sends the recording to the Mac that made it. That Mac
+hears it with **Whisper, running locally** on its own GPU (`mlx-whisper`,
+Apple silicon only) - nothing is sent to Apple or anyone else to transcribe -
+primed with the words it expects: the ten scale mnemonics, bar phrases like
+"thirty minutes", the companies you chart lately and the names of your
+displays. The recording is deleted as soon as it is heard; only the text is
+logged.
+
+If something is missing or unclear you are asked, and the Shortcut listens
+again (up to three times), keeping what it already understood: "I heard
+Nvidia but no scale. Say the scale, like half or daily. I'm listening." -
+"Daily." Or "Did you mean PS (Pershing Square) or MSGS (Madison Square
+Garden)? Say the one you meant. I'm listening."
+
+**First run.** `chartremotely setup` fetches the speech model,
+`whisper-large-v3-turbo` (about 1.6 GB, once, from Hugging Face). The
+listener loads it when it starts, so a sentence takes about a second to hear.
+Setup also learns your display names (the free `chart_agent_status`, asked at
+most every four hours) so "on the studio" is understood.
+
+**One Shortcut: talk, or type when it asks.** When the recording has
+nothing in it - no microphone, silence, noise, or a Mac that cannot hear yet
+- "ChartRemotely" shows one text box instead: *Type your request, e.g.
+Palantir half on mac mini*. Type the same sentence and press Return; it is
+understood the same way and costs the same. If something is missing, the box
+comes back with the question ("I heard Nvidia but no scale. Type the scale,
+like half or daily."). On a Mac the Shortcut goes straight to the box: Record
+Audio waits forever on a Mac without a microphone, and a Mac has a keyboard.
 
 The Shortcut talks to one Mac — the one that made it. That Mac looks up the
 company and the scale itself (free: a table, never the chart), then acts as
@@ -131,7 +160,8 @@ Palantir; "shop if y" is Shopify); when two companies are too close to call
 you are asked - "Did you mean PS (Pershing Square) or MSGS (Madison Square
 Garden)?" - rather than shown the wrong chart, and the symbols you chart
 lately settle a near-tie. `understand()` parses a whole sentence the same way
-("Palantir half on the mini").
+("Palantir half on the mini") - that is what the ChartRemotely Shortcut
+uses on the sentence Whisper heard.
 
 Each command handled is logged as one line — time, the command's first word,
 the "Where?" as said, what was heard for a company or scale lookup, and the
@@ -173,7 +203,10 @@ and runs `chartremotely setup`, which:
 3. gives the Mac its tailnet address with `tailscale serve`;
 4. installs the listener and the relay as launchd agents;
 5. asks macOS for Accessibility and Screen Recording for the Python that runs them;
-6. makes this Mac's ChartRemotely voice Shortcut and opens it for import.
+6. fetches the Whisper speech model (about 1.6 GB, once) and your display names;
+7. makes this Mac's Shortcut, "ChartRemotely" (talk, or type when it asks),
+   opens it for import, and removes a "ChartRemotely Ask" an older setup left
+   in your library.
 
 Run it again at any time: finished steps are skipped. `chartremotely doctor`
 reports anything still missing.