Synoptia-THERESE

<p align="center">
  <img src="assets/screenshots/therese-hero.png" alt="THÉRÈSE - Assistant IA desktop" width="720" />
</p>

<h1 align="center">THÉRÈSE</h1>

<p align="center">
  <strong>L'assistante IA desktop pour les entrepreneurs, TPE, mairies et associations françaises.</strong><br />
  <em>"Humain d'abord - IA en soutien"</em>
</p>

<p align="center">
  <a href="LICENSE"><img src="https://img.shields.io/badge/licence-AGPL--3.0-blue.svg" alt="AGPL-3.0 License" /></a>
  <a href="https://github.com/ludovicsanchez38-creator/Synoptia-THERESE/actions"><img src="https://img.shields.io/github/actions/workflow/status/ludovicsanchez38-creator/Synoptia-THERESE/ci.yml?branch=main&label=CI" alt="CI" /></a>
  <img src="https://img.shields.io/badge/version-0.40.0--alpha-orange" alt="Version" />
</p>

<p align="center">
  <strong>Open source et gratuit - pour toujours.</strong>
</p>

---

## Fonctionnalités

- **Chat multi-LLM** - Claude, GPT, Gemini, Mistral, Grok, Infomaniak AI, Ollama (local)
- **Mémoire persistante** - Contacts, projets, fichiers : tout reste sur ta machine
- **Email et Calendrier** - IMAP/Gmail, CalDAV/Google Calendar intégrés
- **CRM et Facturation** - Local ou sync Google Sheets, PDF conforme, devises EUR/CHF/USD/GBP
- **Board de Décision IA** - 5 conseillers virtuels pour t'aider à trancher
- **18 skills intégrés** - Word, Excel, PowerPoint, emails pro, posts LinkedIn, propositions commerciales, analyses PDF/web, planification projets/semaine/objectifs
- **Recherche web** - Brave Search, SearXNG (auto-hébergeable) ou DuckDuckGo
- **Dictée vocale** - Parle, THÉRÈSE écrit
- **Données locales et chiffrées** - Ton contexte reste sur ta machine, jamais envoyé à un serveur Synoptïa. Ta base de données est chiffrée au repos (SQLCipher, AES-256) et tes clés API sont chiffrées via le trousseau de ton système. Les réponses passent par le provider IA de ton choix.
- **Atelier IA (v0.5)** - Deux agents embarqués qui améliorent l'app pour toi (voir ci-dessous)
- **THERESE.md** - Fichier de contexte personnel éditable depuis les Paramètres

## Atelier - Agents IA Embarqués (v0.5)

THÉRÈSE embarque deux agents IA open source qui travaillent ensemble :

- **Katia** (PM/Guide) : t'aide à comprendre l'app, traduit tes besoins en spécifications
- **Zézette** (Dev) : implémente les changements sur une branche git, lance les tests

**Comment ça marche** : tu décris ce que tu veux dans l'Atelier (`Cmd+Shift+A`), Katia comprend le besoin, Zézette code, et tu valides les changements avant qu'ils soient appliqués. Pas besoin de savoir coder.

**Open source** : les prompts des agents (`SOUL.md`) sont livrés avec le code. Tu peux les personnaliser dans `~/.therese/agents/`. Tu fournis ta propre clé API (BYOK), on ne livre aucun token.

**Compatible OpenClaw** : le format de configuration (agent.json + SOUL.md) est compatible avec [OpenClaw](https://github.com/openclaw/openclaw) (MIT).

## Télécharger (alpha)

> THÉRÈSE est en **alpha** avec 21 testeurs.

Les installeurs sont disponibles dans les [GitHub Releases](https://github.com/ludovicsanchez38-creator/Synoptia-THERESE/releases).

| Plateforme | Fichier |
|------------|---------|
| macOS (Apple Silicon) | `THERESE_x.x.x_aarch64.dmg` |
| Windows (x64) | `THERESE_x.x.x_x64-setup.exe` |
| Linux (x64) | `THERESE_x.x.x_amd64.deb` |

> **macOS** : Clic droit sur l'app > Ouvrir > Confirmer (Gatekeeper, app non signée pour l'instant).
> **Windows** : SmartScreen peut afficher un avertissement, clique sur "Informations complémentaires" > "Exécuter quand même".

Tu as besoin d'un **code d'accès au service IA** (appelé "clé API") pour utiliser THÉRÈSE. Anthropic est recommandé : [console.anthropic.com](https://console.anthropic.com). Ou utilise [Ollama](https://ollama.ai) pour un usage 100% local et gratuit.

## Premiers pas

1. **Télécharge et installe** la dernière build depuis les [Releases](https://github.com/ludovicsanchez38-creator/Synoptia-THERESE/releases)
2. **Suis l'assistant de configuration** qui te guide étape par étape
3. **Commence à discuter** avec THÉRÈSE !

Guide complet pour les testeurs : [docs/USER_GUIDE_ALPHA.md](docs/USER_GUIDE_ALPHA.md)

## Signaler un bug

- **Discord** : mentionne `@Katia bug : [description]` dans `#bugs`
- **GitHub** : ouvre une [issue](https://github.com/ludovicsanchez38-creator/Synoptia-THERESE/issues/new?template=bug_report.md)
- **Email** : ludo@synoptia.fr avec l'objet `[THÉRÈSE Alpha] Bug`

## Pour les développeurs

### Prérequis

- Python 3.11+ (via [UV](https://docs.astral.sh/uv/))
- Node.js 20+
- Rust stable (pour [Tauri 2.0](https://v2.tauri.app/))

### Installation et lancement

```bash
make install    # Installer toutes les dépendances
make dev        # Lancer backend + Tauri en mode dev
```

### Commandes utiles

```bash
make dev              # Backend + Tauri simultanés
make dev-backend      # Backend seul (uvicorn)
make test             # Tous les tests
make lint             # Vérifier le code (ruff + eslint)
make bu

... (truncated)