Dify est une plateforme open source dédiée au développement d'applications exploitant des modèles de langage (LLM). Elle intègre des concepts de Backend as a Service et d'Opérations LLM, permettant aux développeurs de construire rapidement des applications génératives de niveau production. Même les profils non techniques peuvent participer à la définition et à l'exploitation des données de ces applications IA.

La plateforme fournit une pile technologique complète pour les applications LLM, incluant le support de centaines de modèles, une interface visuelle de composition de prompts, un moteur RAG performant, un framework d'agents robuste et des workflows flexibles. Elle propose également une interface utilisateur intuitive et une API, réduisant ainsi le temps de développement pour permettre de se concentrer sur l'innovation et les besoins métier.

Prérequis pour le déploiement local

Ce guide suppose un environnement Mac avec puce Apple Silicon. Les prérequis logiciels sont : npm, Node.js et pnpm. Le serveur doit disposer d'au moins 2 cœurs de CPU et 4 Go de RAM.

Étapes de déploiement

1. Installation de Docker

Téléchargez et installez Docker Desktop depuis le site officiel. Choisissez la version adaptée à votre architecture matérielle (Apple Silicon ou Intel).

2. Installation de Dify via Docker

Commencez par cloner le dépôt du projet :

git clone https://github.com/langgenius/dify.git

Naviguez ensuite dans le répertoire docker du projet copié. Copiez le fichier d'environnement exemple pour créer votre propre configuraton, puis lancez les services via Docker Compose.

cd dify/docker
cp .env.example .env
docker compose up -d

Vérifiez que tous les conteneurs sont démarrés avec succès :

docker compose ps

3. Déploiement de l'interface web

Installez les dépendances du frontend à l'aide de pnpm depuis le répertoire web, puis lancez le serveur de développement.

cd web
pnpm install
pnpm run dev

Une fois le serveur actif, accédez à l'interface d'initialisation dans votre navigateur via l'URL http://localhost/install. Après avoir configuré le compte administrateur, vous pouvez vous connecter et commencer à créer vos applications.

Résolution de problèmes courants

Échec de téléchargement des images Docker

Si le téléchargement des images échoue par timeout, configurez des registres miroirs dans les paramètres de Docker. Dans l'onglet "Docker Engine" des paramètres, ajoutez ou modifiez la clé registry-mirrors avec une liste d'URLs de miroirs fiables.

{
  "registry-mirrors": [
    "https://mirror.example1.com",
    "https://mirror.example2.com"
  ]
}

Conflit sur le port 80

Identifiez le processus occupant le port 80 et arrêtez-le, ou modifiez le port par défaut de Nginx dans le fichier .env. Changez la valeur de NGINX_PORT (par exemple, NGINX_PORT=8080). Appliquez ensuite les changements en redémarrant la pile :

docker compose down
docker compose up -d

L'interface web sera alors accessible sur le nouveau port, par exemple http://localhost:8080. N'oubliez pas de mettre à jour les variables SERVICE_API_URL et APP_WEB_URL dans le fichier .env pour refléter le nouveau port si nécessaire.

Personnalisation de la configuration

Pour des ajustements plus fins, consultez les commentaires dans le fichier .env.example et modifiez le fichier .env en conséquence. Des modifications avancées peuvant aussi être apportées directement au fichier docker-compose.yaml, comme changer les versions des images ou les points de montage des volumes. Relancez toujours docker compose up -d après toute modification.