Your terminal, out loud.

steph listens to your shell and says what matters, in one sentence. Errors explained, prompts recognised, long commands followed step by step.

git clone https://github.com/tutozz/steph && cd steph && ./scripts/install.sh

Linux · on macOS, see Install · free for individuals

S.T.E.P.H Speaking
Terminal,
Everything
Privately
Hosted

100% local The language model and the voice run on your machine. Nothing leaves it.

Your shell zsh or bash, on Linux and macOS. Your configuration stays untouched.

01 · The idea

A screen reader reads every line. steph says what matters.

An error becomes a clear sentence, a prompt becomes yes or no, an upgrade becomes a percentage.

02 · Listen

Four commands, four sentences.

Real recordings of steph's voice: Piper synthesis, French voice, generated on the machine. steph speaks French today; the translation is under each clip.

A missing file
```
Typed command: $ cat /nope
```
« Erreur 1 : cat: /nope : aucun fichier ou dossier de ce nom. »
Error 1: cat: /nope: no such file or directory.
A failing build
```
Typed command: $ npm run build
```
« Erreur TypeScript : la propriété titel n'existe pas, utilisez title. »
TypeScript error: property titel does not exist, use title.
A long upgrade
```
Typed command: $ sudo apt upgrade
```
« En cours : mise à jour des paquets. 35 pour cent, décompression de vim-common. Terminé en 1 minute 24. 12 paquets mis à jour. »
Running: upgrading packages. 35 percent, unpacking vim-common. Done in 1 minute 24. 12 packages upgraded.
A program waiting for an answer
```
Displayed prompt: Souhaitez-vous continuer ? [O/n]
```
« Question : il est nécessaire de prendre 24 Mo. Souhaitez-vous continuer ? Oui ou non, oui par défaut. »
Question: 24 MB of additional disk space will be used. Do you want to continue? Yes or no, yes by default.

03 · Principles

Fast, quiet, private . It asks you to change nothing.

AYour shell

Nothing to relearn

steph starts zsh or bash with your usual configuration. Your commands, aliases and shortcuts stay yours.

BReal time

Speaks right away

Simple cases go through instant rules. The model only writes summaries and explanations, read sentence by sentence.

COn your machine

No cloud

A small model (Gemma 4 E2B via llama.cpp) and the Piper voice run locally, on the GPU when available. 4 GB of video memory is enough.

04 · Keyboard

Four keys to control everything.

Ask about any command in the session: steph knows the history, the exit codes and the output.

Keys and commands
`F7`	Opens the question window
`F8`	Instant silence
`F9`	Repeats the last announcement
`F10`	Detailed explanation of the last command
`q` + question	Quick question without leaving the shell, for example `q why did it crash?`

On a Mac, F7 to F10 are media keys: hold fn as well.

05 · Built with

Designed and tested with visually impaired people, not just for them.

06 · License

Free for you. Licensed for companies.

Individuals · nonprofits · education

Free

Source available under the PolyForm Noncommercial 1.0.0 license.

Personal use, study, hobby projects
Nonprofits, schools, public research, government
Modify and share, for noncommercial use

Install from GitHub

Companies

Commercial license

Quote on request.

Use inside a company or for a client
Rollout on your teams' machines
Embedding in a product or service

Write to luis@lsmdx.com

Not sure which applies? Write to luis@lsmdx.com.

07 · Install

One command, and you are set.

The script installs llama.cpp, the model (about 3 GB), the French voice and the steph command, without admin rights. Requirement: uv.

Linux

git clone https://github.com/tutozz/steph
cd steph
./scripts/install.sh
steph

macOS

brew install uv llama.cpp sox
git clone https://github.com/tutozz/steph
cd steph
./scripts/install.sh
steph