livekit-plugins-munsit

LiveKit Agents plugin for Munsit voice AI: Arabic speech-to-text (batch and live streaming) and Arabic text-to-speech.

This package consolidates the former livekit-plugins-faseeh (TTS) — that name now ships a deprecation shim that installs this package.

Installation

pip install livekit-plugins-munsit

Set your API key (from the Munsit dashboard):

export MUNSIT_API_KEY=your-key

Speech-to-Text

from livekit.agents import AgentSession
from livekit.plugins import munsit, silero

session = AgentSession(
    stt=munsit.STT(mode="streaming"),   # live transcription over WS /api/v1/listen
    vad=silero.VAD.load(),
)

Two modes:

mode="streaming" (default) mode="batch"
Transport WS /api/v1/listen POST /api/v1/audio/transcribe
Interim results yes (INTERIM_TRANSCRIPT) no
Turn detection server-side (endpointing + semantic smart-turn) client energy VAD
Word timestamps + confidence yes, on finals yes
Models munsit, munsit-en-ar (default) munsit, munsit-en-ar (default)

Streaming options:

munsit.STT(
    mode="streaming",
    endpointing_ms=800,          # silence that ends a turn (100–5000; retunable live)
    smart_turn=True,             # semantic end-of-turn gating
    hotwords=["فرحان", "تطبيق منصت"],   # custom vocabulary (≤200 entries, ≤40 chars)
    interim_results=True,
    correlation_id="call-1234",
    on_enrichment=lambda ev: print(ev),  # per-turn Sentiment / Gender events
)

Batch extras: hotwords=[...] and return_confidence=True (per-word confidence on timestamps). hotwords only bias the Arabic munsit model — with munsit-en-ar (the default) they are ignored with a warning, in both modes.

Text-to-Speech

from livekit.plugins import munsit

tts = munsit.TTS(
    voice_id="ar-hijazi-female-1",
    model="faseeh-v1-preview",
)

MUNSIT_API_KEY is used for both engines (the legacy FASEEH_API_KEY env var still works for TTS).

Documentation

Full API reference: https://docs.munsit.com — see Speech-to-Text Streaming for the /api/v1/listen protocol (events, close codes, billing).

Development

uv sync
uv run pytest tests/ -k "not Integration"   # offline suite (fake server)
MUNSIT_API_KEY=... uv run pytest tests/     # includes live integration tests

License

Apache-2.0

Project links

Data verified by PyPI on Jul 28, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for khalid.ghiboub from gravatar.com khalid.ghiboub Avatar for mohanactualize from gravatar.com mohanactualize

Credits

Author/Maintainer: Mohan Raj Palanisamy

GitHub Statistics

Data verified by PyPI on Jul 28, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.10.0

Tags

ai arabic audio faseeh livekit munsit realtime speech-to-text stt voice

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

livekit_plugins_munsit-0.4.0.tar.gz (23.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

livekit_plugins_munsit-0.4.0-py3-none-any.whl (27.9 kB view details)

Uploaded Python 3

File details

Details for the file livekit_plugins_munsit-0.4.0.tar.gz.

File metadata

  • Download URL: livekit_plugins_munsit-0.4.0.tar.gz
  • Upload date:
  • Size: 23.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for livekit_plugins_munsit-0.4.0.tar.gz
Algorithm Hash digest
SHA256 77f90cfd85e443b6df641bd4adf1d5db01a2bc553d50ca0551f18561d7027dde
MD5 14c33751616beed1da068c19340b937a
BLAKE2b-256 64d6652bb6f41f521eb79103958b240139eec67428f65ec50a17873dea6118ad

See more details on using hashes here.

Provenance

The following attestation bundles were made for livekit_plugins_munsit-0.4.0.tar.gz:

Publisher: publish.yml on CNTXTFZCO0/livekit-plugins-munsit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file livekit_plugins_munsit-0.4.0-py3-none-any.whl.

File metadata

File hashes

Hashes for livekit_plugins_munsit-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 519a115f38008823968e5ee4a51e9f7118fd36f1a4d08de80ce5ca3d95f3a986
MD5 67c0a586c5ec7fc53a1b2bbd5bfa68a3
BLAKE2b-256 760584722a2c4b25c0820da9d4b0f864ba59c875a8e6b67ae5d713186ad6669c

See more details on using hashes here.

Provenance

The following attestation bundles were made for livekit_plugins_munsit-0.4.0-py3-none-any.whl:

Publisher: publish.yml on CNTXTFZCO0/livekit-plugins-munsit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.4.0 This release

2 files

0.3.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page