Introducing LumoChat 💬

Lumo Chat

Lumo Chat is a lightweight automation tool that monitors your Threema Group and forwards incoming messages to your Lumo Api V2 server.

Replies from your server are automatically sent back in Threema perfect for integrations automation and Chat with Lumo together in a Group.

You can also automate network tasks without having to open any network ports on your server.

Everything works E2EE via Threema Messages!

⚡ Features

• Monitors Threema Messages in a Group in real-time
• You can be allone on the Group or invite your Friends
• Forwards incoming messages to your Lumo Api V2 local HTTP endpoint
• Automatically sends back server replies to Threema
• Supports custom flags for special commands (webSearch, debug, log)
• Please for commands and and Lumo Api V2 Installation Go here

Demo

• Incoming message: "Hello"
• Forwarded to http://localhost:3333
• Reply returned automatically in Threema

PAGE LOG: NEW MESSAGE: {id: message-4, direction: in, text: Hello}
PAGE LOG: ✅ Command ready to forward: curl http://localhost:3333 -X POST -H 'Content-Type: application/json' -d '{"prompt":"Hello"}'
📤 Forwarding message message-4 to localhost...
📤 Reply from localhost for message-4: Hey Carlos! What can I help you with today?

🚀 Getting Started

1. Clone the repository:

   git clone https://github.com/carlostkd/lumo-chat.git
   cd lumo-chat
   

2. Install dependencies:

Node.js (v20 + recommended) – includes npm

npm i playwright
npm i express

1. Launch the script:

First run the the Lumo-Api-V2

In another shell run the app

node threema.js

1. Open Threema Web and scan the QR code. Then on the web SELECT the target chat This is IMPORTANT!!

2. Start sending and receiving messages from your Phone to the target chat.

🔧 Configuration

• Use custom flags in messages to trigger special behavior:
  • "webSearch": true
  • "debug": true
  • "log": true

⚠ Notes

• Ensure your local server keeps running both apps.

Coming Soon:

• Help command list for easy remember
• Better error handling
• More commands and file upload from your machine to Lumo via Threema Messages.

❤️ Contributing

Feel free to open issues or submit pull requests.
Enhancements or other integrations are welcome!

Contact Threema *0001337