phorminx README

The project's README from github.com/impossibleG/phorminx. As one markdown file: README.md.

Phorminx P logo

Phorminx

Voice, disciplined.

Local-first dictation and meeting assistance for Windows. Turn speech into text, keep searchable notes, and use optional AI formatting without requiring a paid AI service.

Build from source · Features · Privacy

Phorminx Meetings workspace in light mode, showing computer-audio and microphone options

The Meetings workspace. Screenshots use synthetic demo data.

What it does

Keep the meeting in view

The floating companion puts the live transcript and assistant beside the conversation. Ask a question with the latest transcript context while capture continues.

Phorminx floating companion in dark mode, with a synthetic live transcript and assistant response

Getting started

Phorminx targets Windows 10/11 x64. It is alpha software; recognition accuracy, latency, and compatibility depend on the device, audio source, and model.

Build from source using the development guide. Speech models and Vosk runtime assets are separate downloads and are not included in this source repository. Configure them in the application's setup and model screens. Ollama is optional; dictation can run without AI formatting.

The default Ctrl+Alt+Space shortcut opens the P launcher. Choose Dictate, speak, then press the shortcut again to finish. Settings provides shortcut and appearance preferences. Meetings and Actions have their own workspaces.

Privacy and network access

Speech recognition runs locally. The production capture path keeps audio in memory rather than saving recordings to disk. Retained text and settings live under %LOCALAPPDATA%\Phorminx; use the application's history, session, and deletion controls to manage stored text. Disabling dictation history does not mean that separately saved meeting sessions have been deleted.

Local Ollama formatting and embeddings use local compute. Model downloads use the network. Optional remote assistant providers and HTTP actions send the configured text/context to the selected provider or destination. These options are not a local-only privacy guarantee: remote providers may charge for usage and apply their own data policies. Review the destination before enabling them.

Do not include real transcripts, recordings, credentials, or personal settings in bug reports or contributions. Use synthetic examples instead.

Documentation

License

Phorminx's original source is licensed under the MIT License. Third-party libraries, runtimes, and downloaded models retain their respective licenses and notices; the project license does not replace those terms.

phorminx (impossibleG/phorminx)

Searching Database…

What is this?Phorminx is a local-first Windows desktop app that turns speech into text for dictation and meeting transcription, with searchable notes and optional local AI formatting instead of a paid cloud AI service.
Is this just a background speech-to-text tool or a full app with its own UI?It is a full desktop app with its own launcher, a Meetings workspace with a floating companion, a searchable Library, and an Actions workspace for triggering HTTP requests from transcripts.
How do I get it running?You build Phorminx from source using the development guide; speech models and Vosk runtime assets are separate downloads that you configure through the app's setup and model screens.
Do I need Ollama or a GPU for this to work?No, dictation works without any AI service: Instant mode uses the local Vosk recognizer, and Accurate mode uses Whisper with optional Vulkan GPU acceleration. A local Ollama model is only needed for the optional AI formatting step.
Is this ready for everyday use yet?Not fully, it's labeled alpha software, and recognition accuracy, latency, and compatibility depend on your device, audio source, and chosen model.
Does it run on Mac or Linux too?No, Phorminx targets Windows 10/11 x64 only.
Where does my audio and transcript data go?Speech recognition runs locally and audio is kept in memory rather than saved to disk in production; retained text and settings live under %LOCALAPPDATA%\Phorminx, though enabling optional remote assistant providers or HTTP actions sends your text to those external destinations.
What's the difference between Instant and Accurate dictation modes?Instant mode uses the resident Vosk recognizer for fast speech-to-text, while Accurate mode uses Whisper, optionally accelerated with Vulkan, for higher-quality transcription.
How do I actually start dictating?Press the default Ctrl+Alt+Space shortcut to open the P launcher, choose Dictate, speak, then press the shortcut again to finish.
Can I trigger automated actions from my speech?Yes, the Actions workspace lets you save HTTP requests that use transcript substitution or optional model-generated JSON, launched from the same launcher.
Does asking the floating companion a question interrupt the meeting recording?No, sending an assistant question includes the newly captured transcript context without stopping capture.
Size
3.8 MB
Stars
207
Updated
CommitOct 17
Age
1mo
Commits · 90 Days