emon 🎙️🔊

emon is a simple Python package that gives your projects a voice — both speaking and listening — with just a few lines of code.

✨ Features

📦 Installation

pip install emon

Windows note: If PyAudio fails to install, run:

pip install pipwin
pipwin install pyaudio

Linux note:

sudo apt-get install portaudio19-dev python3-pyaudio
pip install pyaudio

🚀 Quick Start

from emon import voice as v

# Speak something
v.say("Hello! I am emon, your voice assistant.")

# Listen for a reply
user = v.listen("Say something...")
print("You said:", user)

# Respond based on input
if "how are you" in user.lower():
    v.say("I am fine, thank you!")

🔄 Voice-to-Voice Conversation

Build a full voice chatbot in minutes:

from emon import voice as v

def my_bot(text):
    text = text.lower()
    if "hello" in text:
        return "Hello! How can I help you?"
    elif "how are you" in text:
        return "I am fine and you?"
    elif "your name" in text:
        return "My name is Emon Assistant."
    else:
        return f"You said: {text}. I am still learning!"

# Starts listening in a loop. Say 'goodbye' to stop.
v.conversation(my_bot)

🌍 Multi-Language Support

from emon import voice as v

# Bangla
v.say("আমি ভালো আছি", lang="bn")

# French
v.say("Bonjour le monde", lang="fr")

# Listen in Bangla
text = v.listen("বলুন...", language="bn-BD")

📖 API Reference

v.say(text, lang="en", slow=False)

Converts text to speech and plays it through your speakers.

v.listen(prompt="Listening...", timeout=5, phrase_time_limit=10, language="en-US")

Records from your microphone and returns the recognised text as a string. Returns "" (empty string) if nothing was heard.

v.conversation(handler, prompt="Listening...", exit_phrase="goodbye", language="en-US", tts_lang="en")

Runs a continuous voice loop. handler receives the heard text and returns a reply string.

📄 License

MIT © ABS EMON