github.com/www-zaq-ai/zaq

Votre cerveau IA,
ouvert & souverain.

ZAQ est une plateforme de connaissance IA open source auto-hébergée, construite avec Elixir et Phoenix. Déployez sur votre infrastructure. Gardez le contrôle total de vos données.

v0.6.4Elixir / OTPPhoenix LiveViewPostgreSQL + pgvectorDocker

Voir sur GitHub Lire la documentation Démarrage rapide

Opérationnel en quelques secondes

L'installateur local configure tout automatiquement — Docker, base de données, secrets et l'application.

MacOS / Unix

Docker Desktop

Pas d'Elixir ni de PostgreSQL requis

1Collez dans votre terminal et appuyez sur Entrée

$mkdir zaq && cd zaq && curl -O https://raw.githubusercontent.com/www-zaq-ai/zaq/refs/heads/main/zaq-local.sh && chmod +x zaq-local.sh && ./zaq-local.sh

Crée un dossier zaq/, télécharge l'installateur et démarre la pile complète dans Docker.

2Ouvrez ZAQ dans votre navigateur

→http://localhost:4000

3Connectez votre LLM et chargez des documents

Allez dans /bo/system-config pour configurer votre endpoint LLM, le modèle d'embedding et commencer l'ingestion de documents.

Commandes utiles

Arrêter l'affichage des logs (l'app continue de tourner)Ctrl+C

Arrêter l'applicationdocker compose stop

Redémarrer / afficher les logs à nouveau./zaq-local.sh

Mettre à jour vers la dernière versiondocker compose pull

Pour mettre à jour : allez dans votre dossier zaq/ et lancez docker compose pull, puis redémarrez avec ./zaq-local.sh. Vérifiez votre version actuelle en bas de la barre latérale gauche.

Architecture

Une seule application Elixir/OTP composée de cinq services internes, chacun sous sa propre arbre de supervision.

Engine

Orchestrateur central. Sessions, ontologie, routage API et flux de conversation.

SessionsOntologyAPI

Agent

Couche IA. Récupération RAG, interaction LLM, classificateur et détection des lacunes de connaissance.

RAGLLMClassifier

Ingestion

Pipeline de traitement documentaire. Découpage, génération d'embeddings, écriture PGVector, PDF en markdown.

ChunkingEmbeddingsPDF

Channels

Adaptateur de communication multi-canal. Mattermost aujourd'hui — Slack et Email prévus.

MattermostSlack*Email*

Back Office

Panneau d'administration Phoenix LiveView. Gestion de l'ontologie, des documents et de la configuration système.

LiveViewAdminConfig

Couche de données

Stockage principal

PostgreSQL + pgvector — sessions, historique de chat, ontologie, documents, embeddings et configuration dans un seul Zaq.Repo.

LLM client

On-premise, fourni par le client. Connecté via un endpoint configurable depuis le Back Office. Aucune donnée ne quitte votre infrastructure.

Images de conteneurs

Publiées dans le GitHub Container Registry à chaque release.

ghcr.io / www-zaq-ai / zaqGitHub Container Registry

latestDernière version stable

v0.6.4Version actuelle

0.6.4Sans préfixe v

0.6Tag version mineure

0Tag version majeure

Déploiement flexible

Exécutez tout sur un seul nœud ou distribuez les services sur plusieurs nœuds via la distribution Erlang.

Nœud unique

Exécutez les cinq services sur une seule machine. Recommandé pour la plupart des déploiements.

$ ./zaq-local.sh

Par rôle

Activez des services spécifiques par nœud. Faites évoluer les services IA indépendamment du back office.

$ ROLES=agent,ingestion mix phx.server

Multi-nœuds

Distribuez sur plusieurs nœuds via la distribution Erlang. La découverte des pairs est automatique.

$ ROLES=engine,bo iex --sname bo@host

Contribuer

Nous suivons Conventional Commits et un flux trunk-based. Toutes les contributions sont les bienvenues.

Forker le dépôt

gh repo fork www-zaq-ai/zaq

Créer une branche de fonctionnalité

git checkout -b feature/my-feature

Committer avec Conventional Commits

git commit -m "feat(scope): description"

Lancer les vérifications précommit

mix precommit

Pousser et ouvrir une Pull Request

git push origin feature/my-feature

Utilisez Conventional Commits pour le titre de votre PR

Examples: feat(agent): add streaming responses · fix(ingestion): handle empty PDF

Lancez mix precommit avant de soumettre. Les releases sont automatisées via release-please.

Ressources

Tout ce dont vous avez besoin pour démarrer, approfondir ou contribuer.

Documentation

Docs complets du projet publiés sur GitHub Pages, mis à jour à chaque release.

Wiki d'installation

Guide d'installation local étape par étape, incluant Docker Compose et Mix.

Dépôt GitHub

Code source, issues, pull requests et historique des releases.

Changelog

Notes de release et historique des versions, automatisés via release-please.

Prêt à faire tourner votre propre
cerveau de connaissance ?

Déployez ZAQ sur votre infrastructure aujourd'hui — ou réservez une démo pour voir ce que la version gérée peut faire.

Commencer sur GitHub Réserver une démo

Votre cerveau IA,ouvert & souverain.