openbot/README.md

OpenSquared Assistant PWA

POC de PWA mobile pour parler a l'assistant depuis un telephone.

Fonctionnalites

• Interface mobile installable sur Android via "Ajouter a l'ecran d'accueil".
• Bouton micro avec transcription Groq Whisper.
• Reponse LLM Groq.
• Lecture audio automatique de la reponse apres interaction utilisateur.
• Envoi d'emails Gmail avec carnet de contacts contacts.json.

Configuration locale

cd pwa_assistant
copy .env.example .env

Remplir .env :

GROQ_API_KEY=...
GMAIL_EMAIL=...
GMAIL_PASSWORD=...
APP_SECRET=...

Installer :

C:\Users\baron\AppData\Local\Programs\Python\Python313\python.exe -m pip install -r requirements.txt

Lancer :

C:\Users\baron\AppData\Local\Programs\Python\Python313\python.exe app.py

Puis ouvrir :

http://localhost:8080

Sur telephone, le micro necessite HTTPS sauf cas particulier localhost.

Deploiement VPS Hostinger

Exemple Ubuntu :

cd /var/www
git clone <ton-repo-ou-upload> opensquared-assistant
cd opensquared-assistant/pwa_assistant
python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
nano .env

Service systemd :

[Unit]
Description=OpenSquared Assistant PWA
After=network.target

[Service]
WorkingDirectory=/var/www/opensquared-assistant/pwa_assistant
EnvironmentFile=/var/www/opensquared-assistant/pwa_assistant/.env
ExecStart=/var/www/opensquared-assistant/pwa_assistant/.venv/bin/gunicorn -w 2 -b 127.0.0.1:8080 app:app
Restart=always
RestartSec=3

[Install]
WantedBy=multi-user.target

Commandes :

sudo nano /etc/systemd/system/opensquared-assistant.service
sudo systemctl daemon-reload
sudo systemctl enable --now opensquared-assistant
sudo systemctl status opensquared-assistant

Nginx :

server {
    server_name assistant.ton-domaine.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

HTTPS avec Certbot :

sudo certbot --nginx -d assistant.ton-domaine.com

Installation Android

1. Ouvrir l'URL HTTPS dans Chrome Android.
2. Menu ....
3. Ajouter a l'ecran d'accueil ou Installer l'application.
4. Ouvrir l'icone Assistant.
5. Appuyer une fois sur Demarrer pour autoriser micro/audio.

Notes

• Groq Orpheus TTS doit etre accepte dans la console Groq pour fonctionner : https://console.groq.com/playground?model=canopylabs%2Forpheus-v1-english
• La lecture audio automatique depend toujours des regles du navigateur mobile, mais elle marche mieux dans une PWA apres un tap utilisateur que dans Telegram.