Airweave : couche de récupération de contexte open source pour agents IA

Entre les sources de données et les agents IA

Airweave se connecte à vos applications, outils et bases de données, synchronise continuellement leurs données et les expose via une interface de recherche unifiée et conviviale pour les LLM. Les agents IA interrogent Airweave pour récupérer un contexte pertinent, fondé et à jour à partir de multiples sources en une seule requête. Le README décrit cela comme une couche de récupération de contexte et la place entre les sources de données et les systèmes IA comme infrastructure de récupération partagée. Elle gère l'authentification, l'ingestion, la synchronisation, l'indexation et la récupération afin que vous n'ayez pas à reconstruire des pipelines fragiles pour chaque agent ou intégration. Les métadonnées du dépôt confirment la description : « couche de récupération de contexte open source pour agents IA ». Le README ne fournit pas de benchmarks ni de chiffres de performance, donc toute affirmation sur la vitesse ou l'échelle nécessiterait une vérification.

Le flux documenté

Le README décrit un processus en quatre étapes : connecter des applications, des bases de données et des documents (il revendique 50+ intégrations) ; Airweave synchronise, indexe et expose les données via une couche de récupération unifiée ; les agents interrogent via les SDK, l'API REST, MCP ou les intégrations natives avec les frameworks d'agents populaires ; et les agents récupèrent un contexte pertinent et fondé à la demande. Ces étapes sont conceptuelles ; le README ne précise pas l'algorithme de récupération sous-jacent ni les détails de classement. L'expression « convivial pour les LLM » est utilisée mais pas définie au-delà de l'interface de recherche. Les étapes sont présentées sous forme de puces sans autre explication, donc le comportement exact de chaque étape est laissé au code et à la documentation.

Démarrage rapide auto-hébergé

Le README propose un chemin auto-hébergé : cloner le dépôt, y entrer et exécuter ./start.sh. Le script est censé créer .env à partir de .env.example, générer les secrets requis (ENCRYPTION_KEY, STATE_SECRET), démarrer tous les services avec des vérifications de santé et éventuellement demander des clés API OpenAI ou Mistral. Le README avertit que Docker et docker-compose sont nécessaires et que le premier démarrage peut prendre 2 à 3 minutes pour que tous les services soient sains. L'application est ensuite accessible sur http://localhost:8080. Il y a aussi des flags : --restart, --skip-frontend, --destroy. Le README ne documente pas ce que fait le script en interne au-delà de ces lignes, donc la disposition exacte des services devrait être vérifiée à partir du dépôt lui-même.

La liste des intégrations

Le README montre une grille d'icônes pour les intégrations, notamment Airtable, Apollo, Asana, Attio, Bitbucket, Box, cal.com, ClickUp, Coda, Confluence, Dropbox, Intercom, Fireflies, Freshdesk, GitHub, GitLab, Gmail, Google Calendar, Google Docs, Google Drive, HubSpot, Jira, Linear, Notion, OneDrive, PowerPoint, Salesforce, ServiceNow, SharePoint, Slab, Slack, Slite, Stripe, Trello, Zendesk et Zoom. Le texte dit « 50+ intégrations » mais les icônes visibles sont bien moins nombreuses. Le README renvoie à la documentation sur docs.airweave.ai/connectors/overview pour la liste complète. Le nombre exact et la complétude de chaque connecteur ne sont pas vérifiables à partir du seul README.

SDK et CLI

Deux SDK sont listés : Python (pip install airweave-sdk) et TypeScript (npm install @airweave/sdk). Un exemple Python montre l'import d'AirweaveSDK, la création d'un client avec une clé API, et l'appel de client.collections.search.instant avec un readable_id et une requête. Le CLI est installé avec pip install airweave-cli et fournit des commandes comme airweave auth login et airweave search "quarterly revenue figures" --collection finance-data. Le README dit que le CLI produit des résultats interactifs riches dans le terminal et du JSON propre lorsqu'il est pipé. Il renvoie à la documentation SDK et à des notebooks d'exemple dans le dépôt. Le README ne contient pas d'exemples de code TypeScript ni d'installation CLI pour d'autres plateformes.

Pile technique

Le README nomme la pile : React/TypeScript avec ShadCN pour le frontend, FastAPI (Python) pour le backend, PostgreSQL pour les métadonnées, Vespa pour les vecteurs, Temporal pour l'orchestration, Redis pour pub/sub, Docker Compose pour le développement et Kubernetes pour la production. Ce sont les technologies nommées, mais le README ne dit pas pourquoi chacune a été choisie ni comment elles interagissent au-delà de ces étiquettes. Les métadonnées du dépôt montrent 6 535 étoiles, 818 forks et 121 problèmes ouverts, mais ces chiffres ne proviennent pas du README et doivent être traités comme des métadonnées de dépôt plutôt que comme des fonctionnalités. Le dépôt n'est pas archivé, il semble donc être activement maintenu.

Licence et contribution

Le projet est sous licence MIT, comme indiqué dans le fichier LICENSE et l'extrait de licence. La licence MIT accorde la permission d'utiliser, copier, modifier, fusionner, publier, distribuer, sous-licencier et vendre des copies du logiciel, sous réserve d'inclure l'avis de droit d'auteur et l'avis de permission. La licence stipule que le logiciel est fourni « EN L'ÉTAT », sans garantie d'aucune sorte, et que les auteurs ou titulaires du droit d'auteur ne sont pas responsables des réclamations ou des dommages. Le README invite aux contributions et renvoie à un fichier CONTRIBUTING.md. Il ne décrit pas de processus de contribution, de code de conduite ou de procédure de signalement de sécurité, donc ceux-ci devraient être trouvés dans le dépôt.

Conclusion éditoriale

Airweave est une couche de récupération auto-hébergeable sous licence MIT. Le README est explicite sur la pile et le démarrage rapide, mais silencieux sur les performances en production et les garanties de sécurité.

Sources officielles

1. Official documentation
2. Official README
3. Project repository
4. Release notes