wfloat 2.0.0__py3-none-win_amd64.whl

wfloat-2.0.0.dist-info/METADATA

@@ -0,0 +1,251 @@
+Metadata-Version: 2.4
+Name: wfloat
+Version: 2.0.0
+Summary: Wfloat Python SDK for running models locally
+Home-page: https://github.com/wfloat/wfloat-python
+Author: wfloat
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: requires-python
+Dynamic: summary
+
+# wfloat
+
+`wfloat` is the Python package for Wfloat's on-device model families, including
+TTS, STT, VAD, and LLM.
+
+It runs inference locally in Python instead of calling a hosted inference API.
+The TTS model supports 20 voices with emotion and intensity control.
+
+If you're building for the browser, use
+[`@wfloat/wfloat-web`](https://github.com/wfloat/wfloat-web). If you're
+building for React Native, use
+[`@wfloat/react-native-wfloat`](https://github.com/wfloat/react-native-wfloat).
+
+Browser demo to hear how it sounds: https://wfloat.com/demo
+
+## Install
+
+```bash
+pip install wfloat
+```
+
+## Usage
+
+```python
+import wfloat
+
+tts = wfloat.load_tts_model("wfloat/wfloat-tts")
+
+result = tts.synthesize(
+    text="No, no, that's not possible.",
+    voice="mad_scientist_woman",
+    emotion="surprise",
+    intensity=0.7,
+)
+
+print(result.model_id)
+print(result.timeline.chunks[0].text)
+```
+
+For multi-speaker dialogue:
+
+```python
+import wfloat
+
+tts = wfloat.load_tts_model("wfloat/wfloat-tts")
+
+result = tts.synthesize_dialogue(
+    segments=[
+        {
+            "voice": "wise_elder_man",
+            "text": "Rain taps against the tavern shutters as you step inside.",
+            "emotion": "neutral",
+            "intensity": 0.5,
+        },
+        {
+            "voice": "strong_hero_man",
+            "text": "You're late. Two bandits stole the king's map over three hours ago.",
+            "emotion": "fear",
+            "intensity": 0.6,
+        },
+        {
+            "voice": "strong_hero_man",
+            "text": "They fled north, up into the woods.",
+            "emotion": "neutral",
+            "intensity": 0.5,
+        },
+    ],
+    silence_between_segments_sec=0.35,
+)
+
+result.audio.save("dialogue.wav")
+```
+
+The older `load(...)`, `generate(...)`, and `generate_dialogue(...)` names are
+still available as compatibility aliases.
+
+## STT Usage
+
+The shared Python entrypoint is `load_stt_model(...)`, with
+`load_whisper_tiny_en(...)` as a convenience wrapper for offline STT:
+
+```python
+import wfloat
+
+stt = wfloat.load_stt_model(
+    "openai/whisper-tiny-en",
+)
+
+result = stt.transcribe(audio="/path/to/audio.wav")
+print(result.text)
+```
+
+The loader accepts canonical built-in model IDs and resolves Wfloat-hosted
+registry assets internally.
+
+Streaming-capable STT families also expose a separate session path instead of
+overloading `transcribe(...)`:
+
+```python
+stt = wfloat.load_stt_model("k2-fsa/streaming-zipformer-en")
+session = stt.create_session()
+
+session.push(audio_chunk, sample_rate=16000)
+partial = session.get_result()
+final_result = session.finish()
+session.close()
+```
+
+## VAD Usage
+
+Python also exposes the same one-shot VAD model shape as the web and React
+Native packages. It is intentionally file/buffer based for now; there is no
+Python live microphone/session helper. The Python VAD path uses `wfloat-core`,
+matching the TTS, STT, and LLM backend boundary.
+
+```python
+vad = wfloat.load_vad_model(
+    "snakers4/silero-vad",
+    threshold=0.5,
+    min_silence_duration_sec=0.5,
+    min_speech_duration_sec=0.25,
+    max_speech_duration_sec=20.0,
+)
+
+result = vad.detect(audio="/path/to/mono-16khz.wav")
+
+for segment in result.segments:
+    print(segment.start_sec, segment.duration_sec)
+```
+
+VAD currently expects mono 16 kHz audio.
+
+## LLM Usage
+
+The Python LLM path loads local GGUF artifacts through `wfloat-core`:
+
+```python
+import wfloat
+
+llm = wfloat.load_llm_model("HuggingFaceTB/SmolLM2-360M-Instruct")
+result = llm.generate("Write one calm sentence about local inference.", seed=0)
+print(result.text)
+llm.close()
+```
+
+## CLI Usage
+
+You can also generate a WAV from the command line:
+
+```bash
+wfloat generate \
+  --text "Hello world!" \
+  --out out.wav \
+  --voice-id mad_scientist_woman \
+  --emotion surprise \
+  --intensity 0.7 \
+  --silence-padding-sec 0
+```
+
+For the full CLI help:
+
+```bash
+wfloat generate --help
+```
+
+The first load downloads the model assets. After that, the package uses the
+cached local copy.
+
+## Native Backend
+
+Python TTS, STT, VAD, and LLM use the `wfloat-core` native runtime. Release
+wheels bundle the platform-specific shared library inside the `wfloat` package.
+
+Inside this monorepo, local development can point at an explicit build artifact
+with:
+
+```bash
+export WFLOAT_CORE_LIBRARY=/abs/path/to/libwfloat-core.so
+```
+
+## Speaker IDs
+
+Use `voice_id` string names or numeric `sid` values:
+
+| Speaker | SID |
+| --- | ---: |
+| `skilled_hero_man` | 0 |
+| `skilled_hero_woman` | 1 |
+| `fun_hero_man` | 2 |
+| `fun_hero_woman` | 3 |
+| `strong_hero_man` | 4 |
+| `strong_hero_woman` | 5 |
+| `mad_scientist_man` | 6 |
+| `mad_scientist_woman` | 7 |
+| `clever_villain_man` | 8 |
+| `clever_villain_woman` | 9 |
+| `narrator_man` | 10 |
+| `narrator_woman` | 11 |
+| `wise_elder_man` | 12 |
+| `wise_elder_woman` | 13 |
+| `outgoing_anime_man` | 14 |
+| `outgoing_anime_woman` | 15 |
+| `scary_villain_man` | 16 |
+| `scary_villain_woman` | 17 |
+| `news_reporter_man` | 18 |
+| `news_reporter_woman` | 19 |
+
+## Emotions
+
+Supported emotion labels:
+
+- `neutral`
+- `joy`
+- `sadness`
+- `anger`
+- `fear`
+- `surprise`
+- `dismissive`
+- `confusion`
+
+`intensity` must be between `0.0` and `1.0`.
+
+## More
+
+- Docs: https://docs.wfloat.com
+- Model card, voices, emotions, and samples: https://huggingface.co/Wfloat/wfloat-tts
+- Web package: https://github.com/wfloat/wfloat-web
+- React Native package: https://github.com/wfloat/react-native-wfloat

wfloat-2.0.0.dist-info/RECORD

@@ -0,0 +1,28 @@
+wfloat/__init__.py,sha256=pcvCRVgzrCtofPqKoV---3gDvTEcPnm2vLzW5u0-swQ,1447
+wfloat/__main__.py,sha256=NUh9D_rWfVdbNziDDz-ls3KZY5OJcI__l4OE-Chri1Y,106
+wfloat/_assets.py,sha256=g3PxLasu10X5dTZMwEF91CsnAHQJbpga1cQZmmk2gtI,15961
+wfloat/_cache.py,sha256=kU47uO93Yp3OBQDwzaFPEJoFw_ZJroL1Ep_0mDZ0W4Y,5985
+wfloat/_cli.py,sha256=iCr-CbLD58j1e93vx0r5eHECU17fwnprW7AnKsxSL0w,2372
+wfloat/_constants.py,sha256=OXh4Lrhp0MIR--ZR6bmCV1egRci4cDMY0JgSon-1dGo,3752
+wfloat/_core.py,sha256=Nn4Eckc0VNbGtOp19TcsVX_7t_-FIoN_cqq9VGQhiYE,62148
+wfloat/_download.py,sha256=6l-OTBF0ns0FmKrB9CErxs4wcUWIbYbBF6K4LGRc4kw,4166
+wfloat/_generated_model_urls.py,sha256=8WGhUjdcfkfXoUW-KA3vyqlm-hAFfENAUfDeE0HN1Ps,4543
+wfloat/_llm.py,sha256=HO0iRAXawg7U9Kr5acyusFIEgeJ0jg3Bnuik9WdBPTE,2433
+wfloat/_llm_assets.py,sha256=8HyMuyFX1qrukxgOQNEXAnaaMX3yfB5Xl7t03mkKZJw,4326
+wfloat/_llm_load.py,sha256=5hFFgIdm1GdQf6uOU-IfCdP668ERS5etBx_DMIT5JdM,1941
+wfloat/_model.py,sha256=CxEyquiKQ1cM8PERR9IFPzWfPv6tKtsostVJ0BeiFe8,13370
+wfloat/_native.py,sha256=g4jKupO18KwMolryHv4dBGpQ6c62pgZEhCCHiq5yJhU,369
+wfloat/_results.py,sha256=HNAToKeLAiAyJaQFWL_lln2zMAcX3khWa22RaIVvaEc,3578
+wfloat/_stt.py,sha256=6OUqXOQKAIIPF1D2OCnxWx2raY6m5k-OSilWf4yOphA,4123
+wfloat/_stt_assets.py,sha256=nV2momO8m3aaq7amssUdzfmrS56m0C5PjU0Kxy3yOiI,4519
+wfloat/_stt_load.py,sha256=FW7SaEkM7WBoJeRHj7MSVREtzMVQb-wXCLS9TfGChew,2296
+wfloat/_vad.py,sha256=6sYhlBnaMvkioub_ih4fIb0POV_xYuIcQj98OGUDg7k,4342
+wfloat/_vad_assets.py,sha256=nDJfM5nLm-zHgzToFjSpUKrQUlX0-q-0LP8I4T7VXP8,3792
+wfloat/_vad_load.py,sha256=GOled83VUGk_dB13U6eDgeg0NuJLxX_PfKGzbnpBqvA,3335
+wfloat/_version.py,sha256=HLJc82fZ6h65qdEwfCWx0U1_51VFQHVHv3kddt9t2Yk,23
+wfloat/native/wfloat-core.dll,sha256=2L-ceUI5d4uMOM4o04BVBTS8kPK_VpS9Il8XK82WDZQ,21232640
+wfloat-2.0.0.dist-info/METADATA,sha256=r8EQgvJ3m0s4R3W83c5wSnI1jt0hF3-NRBhSI5DWjBY,6334
+wfloat-2.0.0.dist-info/WHEEL,sha256=Zx98gwb_dQKckJK3HEOVKnxxD52EfU_PXDG_usMJ2ng,98
+wfloat-2.0.0.dist-info/entry_points.txt,sha256=lWQgaOC_jw8m10sdYieAD0q9D_kewtVt2mrJyn3nyt4,44
+wfloat-2.0.0.dist-info/top_level.txt,sha256=uWWyRL0PFWuaufMp4oEELfXtvmKTJkOtbApfN4XOvtk,7
+wfloat-2.0.0.dist-info/RECORD,,

wfloat-2.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: false
+Tag: py3-none-win_amd64
+

wfloat-2.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+wfloat = wfloat._cli:main

wfloat-2.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+wfloat