Metadata-Version: 2.4
Name: jarvis-speech-stt
Version: 0.1.0
Summary: Reusable microphone speech-to-text and translation helpers for Jarvis
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: SpeechRecognition<4,>=3.17
Requires-Dist: PyAudio<1,>=0.2.14
Requires-Dist: mtranslate<2,>=1.8
Requires-Dist: colorama<1,>=0.4.6

# jarvis-speech-stt

Reusable speech-to-text and translation helpers extracted from the Jarvis
project.

## Install

```powershell
python -m pip install jarvis-speech-stt
```

For local development, install the built wheel from `dist/` instead. The
distribution name is `jarvis-speech-stt`; the Python import name is
`jarvis_speech_stt`.

## Usage

```python
from jarvis_speech_stt import speech_to_text_python

text = speech_to_text_python()
print(text)
```

The function adjusts for ambient noise, listens through the default microphone,
uses SpeechRecognition's Google recognizer, translates the result to English,
and returns the translated string or `None` when recognition fails.

## Requirements and limitations

- Python 3.10 or newer
- A working microphone and PyAudio-compatible audio input
- Network access for Google speech recognition and mtranslate
- Browser/Selenium automation is not part of this reusable package

Microphone permissions and native audio drivers are system-dependent. The
package catches expected microphone, timeout, recognition, and service errors,
but it cannot grant operating-system permissions.
