This project is an untested and unmaintained bot for the Matrix protocol. The bot integrates AI-powered responses, scheduled messages, and speech recognition for transcriptions. It allows users to interact with an AI model, transcribe audio messages, and set scheduled messages in chat rooms.
- Matrix Chatbot: Responds to commands and messages in Matrix rooms
- AI Integration: Uses an external AI API to generate responses
- Audio Transcription: Converts voice messages to text using speech recognition
- Scheduled Messages: Allows scheduling of automated messages with various recurrence options (daily, weekly, weekdays)
- Command System: Provides various bot commands for interaction
- Automatic Room Joining: Can join invited rooms and keep a persistent configuration
- Python 3.7+
- Required dependencies:
pip install matrix-client speechrecognition requests schedule pytz
- Set up environment variables or edit the script with:
MATRIX_SERVER: Your Matrix server URLUSERNAME: Bot usernamePASSWORD: Bot passwordAI_API_URL: API URL for AI responsesAI_API_KEY: API key for AI service
- Create a
bot_config.jsonfile (or let the bot generate one on the first run):{ "scheduled_messages": [], "joined_rooms": [] }
Run the bot with:
python bot.py!help- Display available commands!ai <message>- Get an AI-generated response!transcribe- Transcribe the last voice message!schedule add HH:MM <message>- Schedule a one-time message!schedule daily HH:MM <message>- Schedule a daily message!schedule weekly HH:MM <message>- Schedule a weekly message!schedule weekdays HH:MM <message>- Schedule a message for weekdays!schedule list- Show scheduled messages!schedule remove <ID>- Remove a scheduled message!status- Show bot status
- This project is untested and unmaintained.
- Use at your own risk.
- The AI response feature relies on an external API, which may require an API key.
- Audio transcription uses Google Speech Recognition, which may require internet access.
- Ensure
bot_config.jsonexists and is writable.
This project is provided as-is, without warranty or support.