# 🤖 Effi - Assistant IA Personnel Self-Hosted

Effi est un assistant IA personnel **100% auto-hébergé**, avec mémoire persistante entre sessions, discussion vocale (STT + TTS), et intégration avec les outils de productivité.

## 🎯 Objectifs

- **Assistant conversationnel** avec personnalité joyeuse et mécanismes de mémoire
- **Discussion vocale complète** : Speech-to-Text (Whisper) + Text-to-Speech (XTTS)
- **Mémoire persistante** entre les sessions via mémoire manuelle OpenWebUI
- **Intégration Joplin** (en cours) pour la prise de notes
- **Automatisation** via n8n et Sub Agent Tool
- **Infrastructure entièrement locale** - aucun appel API externe obligatoire

---

## 🏗️ Architecture

### Infrastructure Multi-Machines

| Machine | IP | Rôle | Spécifications |
|---------|-----|------|----------------|
| **effi-server** | `192.168.1.27` | Serveur Docker principal | Intel J5040 / 8 GB RAM |
| **folzo-Corp** | `192.168.1.11` | LLM + STT + TTS | AMD Ryzen 5800X3D / RX 7800 XT 16GB VRAM / 32GB RAM |

### Schéma Global (Configuration Actuelle)

```
┌─────────────────────────────────────────────────────────────────────────────┐
│                              EFFI SERVER (192.168.1.27)                     │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐                       │
│  │ Open WebUI   │  │ Qdrant       │  │ n8n          │                       │
│  │ Port 3000    │  │ Port 6333    │  │ Port 5678    │                       │
│  └──────┬───────┘  └──────────────┘  └──────────────┘                       │
│         │                                                                   │
│  ┌──────────────┐                                                           │
│  │ wol-proxy    │                                                           │
│  │ Port 3011    │                                                           │
│  └──────┬───────┘                                                           │
└─────────┼───────────────────────────────────────────────────────────────────┘
          │ Wake-on-LAN + Proxy
          ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                            FOLZO-CORP (192.168.1.11)                        │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │                          RX 7800 XT (ROCm)                          │   │
│  │  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐               │   │
│  │  │ Ollama       │  │ speaches     │  │ openedai     │               │   │
│  │  │ qwen3.5:9b   │  │ Whisper STT  │  │ speech TTS   │               │   │
│  │  │ Port 11434   │  │ Port 8200    │  │ Port 8100    │               │   │
│  │  │ 32K context  │  │ (CPU)        │  │ XTTS/ROCm    │               │   │
│  │  └──────────────┘  └──────────────┘  └──────────────┘               │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────────────────┘
```

**Historique des services supprimés** : CouchDB (Obsidian abandonné), mcpo, pipelines (mem0 abandonné) - voir [l'historique complet](./docs/ARCHIVE/HISTORIQUE-COMPLET-EFFI.md)

---

## 🐳 Stack Services (7 services)

| Service | Hôte | Port | Image | Rôle | Statut |
|---------|------|------|-------|------|--------|
| Open WebUI | effi-server | 3000 | `ghcr.io/open-webui/open-webui:main` | Interface IA principale | ✅ Actif |
| Qdrant | effi-server | 6333 | `qdrant/qdrant:latest` | Base vectorielle RAG | ✅ Actif |
| n8n | effi-server | 5678 | `docker.n8n.io/n8nio/n8n:latest` | Automatisation workflows | ✅ Actif |
| wol-proxy | effi-server | 3011 | Build local | Wake-on-LAN + Proxy Ollama | ✅ Actif |
| speaches | folzo-Corp | 8200 | `speaches:latest` (build local) | STT Whisper (CPU) | ✅ Actif |
| openedai-speech | folzo-Corp | 8100 | `ghcr.io/matatonic/openedai-speech` | TTS XTTS ROCm | ✅ Actif |
| Ollama | folzo-Corp | 11434 | Installation native | LLM qwen3.5:9b, bge-m3 | ✅ Actif |

**Services supprimés** (voir historique) :
- ~~CouchDB~~ : Supprimé (Obsidian abandonné)
- ~~mcpo~~ : Supprimé (MCP Obsidian trop fragile)
- ~~pipelines~~ : Supprimé (mem0 abandonné)

---

## 📚 Documentation

- [📁 Architecture](./docs/01-architecture/) - Infrastructure et réseau
- [⚙️ Configuration](./docs/02-configuration/) - Docker, audio, mémoire
- [📖 Guides](./docs/03-guides/) - Installation et configuration initiale
- [🔧 Dépannage](./docs/04-depannage/) - Erreurs courantes et solutions
- [📓 Journal](./docs/05-journal/) - Historique des évolutions
- [📚 Historique Complet](./docs/ARCHIVE/HISTORIQUE-COMPLET-EFFI.md) - Toute l'histoire du projet

---

## 🚀 Démarrage Rapide

### Prérequis

- **Serveur** : Ubuntu 22.04+ avec Docker et Docker Compose
- **PC Gaming** : Ollama installé avec modèles `qwen3.5:9b` et `bge-m3`
- **Réseau** : Les deux machines sur le même LAN

### Installation

```bash
# 1. Cloner le dépôt
git clone https://gitea.folzocorp.fr/Folzo/effi.git
cd effi

# 2. Configurer les variables d'environnement
cp .env.example .env
# Éditer .env avec tes valeurs

# 3. Démarrer les services
docker compose up -d
```

### Configuration OpenWebUI

1. Accéder à `http://192.168.1.27:3000`
2. Créer un compte admin
3. Configurer les connexions :
   - **Ollama** : `http://192.168.1.11:3011` (via WOL proxy)
   - **Audio STT** : `http://192.168.1.11:8200/v1`
   - **Audio TTS** : `http://192.168.1.11:8100/v1`
4. Voir le [guide de première configuration](./docs/03-guides/premiere-config.md)

---

## 🔑 Caractéristiques Clés

### 🎤 Pipeline Vocal
- **STT** : Whisper large-v3-turbo en CPU (~10s pour 5s audio)
  - *Note* : Build ROCm GPU en pause (complexité)
- **TTS** : XTTS v2 avec voix "nova" sur GPU ROCm
- **Latence** : ~500ms pour le TTS, ~10s pour STT

### 🧠 Mémoire Persistante
- **Type** : Mémoire manuelle via OpenWebUI (snippets)
- **Avantage** : Rapide et prévisible (vs mem0 qui était trop lent)
- **Stockage** : Base SQLite intégrée à OpenWebUI
- **Utilisation** : Snippets courts injectés dans le contexte

### 🔗 Intégrations
- **Sub Agent Tool** : Délégation de tâches complexes
- **n8n** : Workflows d'automatisation
- **Joplin** : En cours d'intégration pour prise de notes

---

## 🛠️ Technologies

| Domaine | Technologies |
|---------|-------------|
| **LLM** | Ollama, Qwen 3.5 9B (32K context) |
| **Interface** | Open WebUI |
| **STT** | Faster Whisper (CPU) |
| **TTS** | XTTS v2, OpenedAI-Speech (ROCm) |
| **Vector DB** | Qdrant |
| **Automatisation** | n8n |
| **GPU** | AMD ROCm (RX 7800 XT gfx1100) |

---

## 📝 Historique des Changements Majeurs

**Avril 2026** : Simplification majeure
- Suppression de CouchDB, mcpo, pipelines
- Passage à mémoire manuelle (abandon de mem0)
- Mise à jour qwen2.5:14b → **qwen3.5:9b** (meilleures performances)
- Abandon Obsidian/MCP → future intégration Joplin

Voir l'[historique complet](./docs/ARCHIVE/HISTORIQUE-COMPLET-EFFI.md) pour tous les détails.

---

## 📄 Licence

Ce projet est personnel et documenté à des fins d'apprentissage.

---

## 🙋 Auteur

**Folzo** - [gitea.folzocorp.fr/Folzo](https://gitea.folzocorp.fr/Folzo)

---

*Dernière mise à jour : Avril 2026*