v0.22.1 — reliability and polish

Voice control for hands
that hurt.

Samsara is a local-first voice assistant for Windows. One persistent HANDS FREE lane: dictate naturally across pauses, fire exact commands between thoughts, say “end” to paste. Your voice never leaves your machine unless you deliberately enable a cloud feature. Built first for one developer whose hands hurt; released for everyone’s.

Download for Windows → View source Compare Documentation
Extensiblecommand system Pythonplugin architecture Localby default

Built for one pair of hands. Free for yours.

I'm Morne, and my hands fucking hurt.

I've had Hypermobile Spectrum Disorder for a decade. Using a mouse and keyboard hurts — all the time. I tried paid apps, but they were fragmented, expensive, and didn't fit. So I built Samsara.

Samsara didn't free me from pain. But it freed me from a lot of it.

I went from using a computer two or three times a day, 15 to 25 minutes at a stretch, to having multi-hour writing and development sessions. Of the moments I now stop, only about a third are because of my fingers. The rest are energy, focus, or just life.

I still can't play video games the way I used to ten years ago. But I can play them sometimes, which I'm overjoyed about — because that's up from never.

That's freedom.

— Morne
What it does

Dictate and control Windows in one persistent hands-free session.

Speech becomes buffered dictation; exact commands — “scroll down”, “show numbers”, “switch window” — fire instantly without leaving the lane. “end” pastes the whole thought. Hold-to-dictate and wake words still work too.

Apps

  • "open Chrome"
  • "open Spotify"
  • "open Word"

Smart home

  • "lights red"
  • "light effect rainbow"
  • "lights off"

3D printing

  • "printer status"
  • "pause print"
  • "printer light"

Music

  • "play me some music"
  • "play moonlight"
  • "volume down"

Macros

  • "going dark"
  • "good morning"
  • "focus mode"

Dictation

  • Hold Ctrl+Shift to speak
  • CapsLock to stream
  • HANDS FREE: pause, command, then say "end"
Design principle

Reduce.

Every change must remove a step — less friction, less cognitive load, less cost per interaction.

Software assumes interaction is cheap. For chronic pain, ADHD, or limited energy, it isn’t — Samsara starts from that.

Living with ADHD, "work smart, not hard" stopped being a productivity slogan and became survival logic. I was already working hard just existing in a room.

Local. Fast. Honestly built.

No marketing trick replaces engineering. Here's what's actually under it.

Local-first audio pipeline

WASAPI capture, faster-whisper transcription — GPU optional, CPU fine. Local by design; network features are opt-in and labeled.

Streaming dictation

Live partials float in an overlay; the final paste swaps drafts through a clean undo-cycle.

Hardware integration

Direct ctypes calls into IAudioEndpointVolume for volume control (because pycaw proved unreliable). TCP M-code protocol for FlashForge printers. JSON-RPC for Hyperion LED strips. AHK for Electron apps that ignore Win32.

Plugin system

Drop a Python file in plugins/commands/, add @command — that’s a voice command. Ships with plugins for smart home, music, printers, macros, screen recording, reminders, Ava, and more.

Deterministic first. AI when needed.

Frequent commands stay deterministic — no AI, no latency, no misunderstanding. Open-ended requests can route to AI you configure: local LLMs or your own keys. You set the boundary.

The Advanced tab in Samsara settings, showing wake word, performance mode, AEC toggle, and microphone calibration
The Advanced tab — wake word, performance mode, echo cancellation, and microphone calibration. Most users never need to touch it; the defaults are sensible.
Live dictation indicator lit up blue in toggle mode
The live indicator — blue when listening, grey when idle. Always visible, never in the way.
Stack

Nothing fancy. Just things that work.

For the technically curious. You don't need to know any of this to use Samsara.

Python 3.10+
faster-whisper
Tkinter
PyInstaller
pywin32
SQLite
Hyperion
FlashForge M-code
Spotify API
AutoHotkey v1
Demo

Demo, recorded in the garage.

A real session, real desk, no edits beyond trim. Wake word, lights, apps, dictation, a sketch on the side.

Originally posted to Instagram. Sound on recommended.

On the roadmap

Where this is going.

v0.22.1: HANDS FREE is one persistent lane — pauses no longer paste fragments; “end” commits the whole thought while the session stays live.

Also new: DOM-aware Show Numbers, high-DPI fixes, voice-managed vocabulary, config backup, OpenRouter for cloud Ava, local-only Task Lists.

Next: stabilize with real users, then the ambient Ava workflow — direct agents and triage information without touching a keyboard.

Every roadmap item is filtered through the same question: does this reduce a step somewhere?

Get it

Free for everyone. Open source.

No installer — just extract and run. The standard download is the verified CPU build. The separate CUDA runtime pack is optional; no NVIDIA GPU is required.

Windows
Samsara v0.22.1
standalone .zip · verified CPU build
Download ↓
Windows · CUDA add-on
Verified CUDA Pack
optional · 1.13 GB · compatible with v0.22
Download ↓
Source
GitHub
AGPL-3.0 · open source
View source ↗

Windows only for now. Beta testers welcome — bug reports are the only currency this project accepts.

Free of cost

No purchases, subscriptions, or limits — ever.

Local-first, with disclosed network features

No account, no email, no telemetry. Core dictation never touches a server of mine.

Free of lock-in

AGPL-3.0, source public today — if I vanish, anyone can carry it on. You can’t be stranded.

Dictation, commands, wake words, history: local. Only opt-in features touch the network — model download, TTS, cloud Ava, your own webhooks.

Free forever — nothing is ever locked behind payment. Optional cloud AI just needs your own key.

♡ Sponsor development on GitHub

First run

Extract, run Samsara.exe, follow the wizard. Hold the dictation key to talk — or turn on HANDS FREE and say “end” when a thought’s ready. Wake words optional; the docs cover CUDA and the browser extension.

Licensed under AGPL-3.0 — free and open source, including for commercial use.

Things people ask

Common questions.

Does it work with a quiet voice?

Yes — the matcher is tolerant. Quiet voices do best with a close mic.

What about accents?

Whisper handles most English accents well; persistent misses go in the custom dictionary.

Can I use it lying down?

Yes — wake words mean never reaching for a key. A headset helps.

Will it conflict with NVDA or other screen readers?

Not intentionally — it doesn’t touch focus or screen-reader output, but edge cases are untested. Report anything that breaks.

Do I need an NVIDIA GPU?

No — the standard build is CPU. An NVIDIA GPU can accelerate via the optional CUDA pack.

What happens if you stop maintaining Samsara?

AGPL-3.0, public today. Forkable forever — you won’t be stranded.

Stay in touch

Bugs, ideas, or just hello.

Samsara is early-stage. Things will break. Telling me when they do is the most useful thing you can do for this project.

Send a message
Bugs, ideas, or just hello
Tip jar
ko-fi.com/morneingstar

Samsara is free and stays free. If it saves your hands and you want to send a coffee, I won't say no — but please don't feel you have to.