Odysseus — Espace de Travail IA Auto-Hébergé

Une nouvelle étoile est apparue dans le monde de l'auto-hébergement la semaine dernière et a atteint 23 000 étoiles GitHub en quelques jours. Odysseus est un espace de travail IA complet qui fonctionne entièrement sur votre propre matériel — pas de dépendance au cloud, aucune donnée ne quitte votre réseau, aucun abonnement. Considérez-le comme la version auto-hébergée de l'expérience ChatGPT/Claude, avec encore plus de fonctionnalités : chat avec n'importe quel modèle local ou API, agents autonomes, recherche approfondie, documents, intégration email/calendrier, un gestionnaire de modèles, une mémoire persistante et des compétences.

Ce qui rend Odysseus spécial, c'est sa conception tout-en-un. Au lieu d'assembler Ollama + Open WebUI + LangFlow + une application de calendrier + un client email + un outil de notes, vous obtenez le tout sous un même toit avec un simple docker compose up. C'est ambitieux, c'est récent, et c'est déjà impressionnant de fonctionnalité.

Pourquoi Odysseus est Tendance ?

• 23 000+ étoiles en 2 jours — l'un des projets auto-hébergés à la croissance la plus rapide de 2026
• Remplacement complet de ChatGPT — chat, agents, recherche approfondie, documents, email, calendrier, notes, le tout en local-first
• Confidentialité avant tout — aucune donnée ne quitte votre machine sauf si vous connectez explicitement des API externes
• Fonctionne sur mobile — PWA responsive avec gestes tactiles
• Installation facile — un seul docker compose up -d avec des valeurs par défaut sensées
• Licence MIT — gratuit à utiliser, modifier et partager

Architecture

Odysseus est construit comme un monolithe modulaire fonctionnant dans une pile Docker Compose. Le cœur est un serveur Python FastAPI qui sert une SPA responsive. Autour, des services auxiliaires embarqués gèrent le stockage vectoriel (ChromaDB), la recherche web (SearXNG) et les notifications (ntfy). L'architecture est conçue pour que chaque composant puisse être remplacé ou pointé vers des services externes.

Composants Principaux

• Application FastAPI (app.py) — le serveur HTTP central, le routage et la logique métier
• Frontend (static/) — une application monopage servie par l'application FastAPI elle-même. Modules JS modulaires pour Chat, Agent, Cookbook, Documents, Email, Calendrier, Notes, Paramètres et Comparaison
• Noyau LLM (src/llm_core) — couche d'abstraction pour tout endpoint compatible OpenAI : vLLM, Ollama, llama.cpp, OpenRouter ou API commerciales
• Boucle d'Agent (src/agent_loop) — construite sur opencode, avec outils MCP, accès shell, opérations fichiers, récupération mémoire et recherche web
• Cookbook (services/hwfit) — recommandateur de modèles conscient de la VRAM. Scanne votre matériel, suggère des modèles compatibles, télécharge les fichiers GGUF/FP8/AWQ et les sert via vLLM ou llama.cpp
• Mémoire (services/memory) — mémoire persistante utilisant ChromaDB + récupération par mots-clés (fastembed ONNX), supportant la recherche hybride vecteur + mot-clé, avec import/export
• Email (services/email) — boîte de réception IMAP/SMTP avec triage IA : résumé automatique, détection d'urgence, brouillons de réponses, filtrage spam
• Calendrier (services/calendar) — synchronisation CalDAV (Radicale, Nextcloud, Apple, Fastmail), import/export .ics, compatible agent
• Recherche (services/search) — instance SearXNG configurable ou tout autre backend de recherche
• Auth (core/auth) — authentification intégrée avec rôles admin/non-admin, 2FA, gestion de sessions, jetons API

Services Auxiliaires (Docker Compose)

Flux de Données

Lorsqu'un utilisateur envoie un message dans l'interface Chat :

1. Le frontend envoie le message à l'endpoint /chat de FastAPI
2. Le processeur de chat (src/chat_processor) construit le contexte : historique de la conversation + chunks de mémoire pertinents depuis ChromaDB
3. Le noyau LLM transmet la requête au point de terminaison du modèle configuré (local ou API)
4. La réponse générée est diffusée vers le frontend via Server-Sent Events
5. La conversation est stockée dans SQLite (data/app.db)
6. Les vecteurs mémoire sont optionnellement mis à jour dans ChromaDB

Pour les tâches Agent, le flux s'étend :

1. La boucle d'agent reçoit un objectif utilisateur
2. Elle récupère les compétences et la mémoire pertinentes
3. L'agent planifie les étapes avec le LLM et les exécute à l'aide des outils disponibles (recherche web via SearXNG, lecture/écriture de fichiers, commandes shell, outils MCP)
4. Les résultats s'accumulent dans le contexte de l'agent jusqu'à ce que la tâche soit terminée

Prérequis

• Une machine avec au moins 4 Go de RAM (8 Go+ recommandé, 16 Go+ pour les modèles locaux)
• Docker et Docker Compose (v2.17+)
• Pour l'accélération GPU : GPU NVIDIA avec nvidia-container-toolkit installé
• Pour les modèles locaux : 16 Go+ de RAM ou VRAM (le Cookbook télécharge les modèles automatiquement)
• Python 3.11+ (si installation native au lieu de Docker)
• Git

Installation

Docker (Recommandé)

git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
cp .env.example .env        # facultatif — les valeurs par défaut fonctionnent
docker compose up -d --build

Attendez que les conteneurs soient opérationnels, puis ouvrez http://localhost:7000.

Au premier démarrage, Odysseus crée le compte admin et affiche un mot de passe temporaire dans les logs du conteneur :

docker compose logs odysseus | grep -i "password"

Utilisez ce mot de passe pour vous connecter, puis changez-le dans Settings.

Installation Native (Linux/macOS)

git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python setup.py
python -m uvicorn app:app --host 127.0.0.1 --port 7000

Pour macOS avec Apple Silicon :

./start-macos.sh

Windows

git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
powershell -ExecutionPolicy Bypass -File .\launch-windows.ps1

Configuration

La plupart de la configuration se fait dans l'application sous Settings. Le fichier .env est réservé aux surcharges de déploiement :

Ajouter des Modèles

Allez dans Settings → Providers et ajoutez un endpoint compatible OpenAI :

• Local (Ollama) : http://host.docker.internal:11434/v1
• Local (vLLM) : http://host.docker.internal:8000/v1
• Cloud (OpenRouter) : Ajoutez votre clé API et sélectionnez les modèles

Ou utilisez l'onglet Cookbook pour détecter automatiquement votre matériel, obtenir des recommandations de modèles, les télécharger et les servir en un clic.

Fonctionnalités Clés en Détail

💬 Chat & Comparaison

Discutez avec n'importe quel modèle — local ou API — dans une interface familière de type ChatGPT. La fonction Compare vous permet de confronter deux modèles côte à côte en test aveugle, montrant les résultats sans révéler quel modèle a produit quelle réponse. Idéal pour l'évaluation de modèles.

🤖 Système d'Agent

L'agent utilise opencode avec des outils MCP, un accès shell, des opérations fichiers, la recherche web et la mémoire. Vous pouvez définir des compétences réutilisables que l'agent apprend au fil du temps. Il peut naviguer sur le web, lire et écrire des fichiers, exécuter des commandes shell et effectuer des workflows de recherche en plusieurs étapes.

🔬 Recherche Approfondie

Des recherches multi-étapes qui collectent, lisent et synthétisent des sources en un rapport visuel structuré. Adapté de DeepResearch d'Alibaba, il cherche sur le web, extrait le contenu des pages, résume les résultats et construit un rapport — le tout de manière autonome.

📚 Cookbook — Gestionnaire de Modèles

Le Cookbook est l'une des fonctionnalités vedettes d'Odysseus :

1. Scan matériel — détecte votre GPU, VRAM et RAM système
2. Recommandations de modèles — suggère des modèles compatibles (GGUF, FP8, AWQ) avec un "score d'adéquation"
3. Téléchargement en un clic — télécharge les modèles directement depuis Hugging Face
4. Service automatique — lance vLLM ou llama.cpp pour servir le modèle téléchargé
5. Serveurs distants — peut installer et servir des modèles sur des machines distantes via SSH

📧 Email & Calendrier

• Email : Connectez n'importe quel compte IMAP/SMTP. Le triage IA étiquette, résume, rédige des brouillons, détecte l'urgence et filtre le spam. Compatible CalDAV pour la planification de réunions.
• Calendrier : Calendrier local-first avec synchronisation CalDAV (Radicale, Nextcloud, Apple, Fastmail). Import/export de fichiers .ics. Compatible agent — l'agent peut consulter votre calendrier lors de la planification de tâches.

🧠 Mémoire & Compétences

• Mémoire persistante : Chaque discussion contribue à un stockage mémoire vecteur + mot-clé (ChromaDB + fastembed ONNX)
• Compétences : Définissez des packages de compétences réutilisables — instructions + outils que l'agent peut invoquer
• Import/export : Partagez compétences et mémoire entre instances

Liste de Vérification

Après l'installation, vérifiez que tout fonctionne :

• Connexion fonctionnelle — http://localhost:7000 affiche la page de connexion
• Configuration admin terminée — mot de passe temporaire récupéré des logs, changé dans Settings
• Chat fonctionnel — envoyez un message au fournisseur de modèle par défaut
• Paramètres accessibles — navigation vers Settings → Providers
• Cookbook chargé — écran de détection matérielle dans l'onglet Cookbook
• Mémoire active — vérifiez Settings → System pour le statut ChromaDB
• Recherche web configurée — SearXNG est accessible (port 8080 par défaut)
• Conteneurs Docker sains — docker compose ps montre tous les services Up

Déploiement en Production

Pour un déploiement en production :

1. Placez Odysseus derrière un proxy inverse (Caddy, nginx, Traefik) avec HTTPS
2. Gardez AUTH_ENABLED=true et SECURE_COOKIES=true
3. Ne liez jamais à 0.0.0.0 sans HTTPS et un proxy
4. Envisagez Cloudflare Access ou Tailscale pour un accès privé
5. Vérifiez data/auth.json après le premier démarrage — désactivez l'inscription ouverte

Ressources

• GitHub : github.com/pewdiepie-archdaemon/odysseus
• Licence : MIT
• Dépendances : opencode, llmfit, Tongyi DeepResearch, ChromaDB, SearXNG
• Alternative : Open WebUI (interface de chat auto-hébergée alternative)