garden-md

Qu'est-ce que garden-md ?

garden-md est un outil en ligne de commande qui transforme les transcriptions de réunions (et notes associées) en base de connaissances d’entreprise structurée et liée. Il génère un wiki HTML de style Wikipédia à partir de fichiers markdown stockés localement, pour parcourir les personnes, entreprises, produits/outils de votre organisation et leurs mentions dans les documents.

Son objectif principal est d’aider les équipes à organiser le matériel de transcription dispersé en un format parcourable, tout en conservant les transcriptions originales verbatim (non réécrites ni résumées). Vous pouvez synchroniser des données depuis les services compatibles, extraire des entités, lier les mentions et ouvrir le wiki résultant dans votre navigateur.

Fonctionnalités principales

• Synchronisation de transcriptions depuis plusieurs sources (zone de mise en scène locale + wiki local) : Exécutez garden sync pour récupérer de nouvelles transcriptions depuis Grain, Granola, Fireflies.ai ou un connecteur “Other” basé sur API dans une zone de mise en scène locale.
• Extraction d’entités sur les documents : Pendant garden tend, l’outil extrait des entités telles que personnes, entreprises et produits/outils et les utilise pour organiser les pages wiki.
• Pages wiki liées et parcourables en markdown : La sortie consiste en des fichiers .md liés qui s’enrichissent au fil du temps à mesure que plus de documents référencent des entités existantes ou nouvelles.
• Rendu HTML de style Wikipédia : garden open génère et sert un wiki HTML avec navigation, recherche et backlinks.
• Opération locale en priorité : Le wiki est stocké sous forme de dossiers de fichiers markdown sur votre machine, et non dans une base de données cloud.
• Intégration git optionnelle / commits automatisés : garden init peut activer git, et le wiki peut être mis à jour avec des commits automatiques (optionnel selon la configuration).
• Approche par connecteurs avec validation pour services personnalisés : Les connecteurs intégrés sont préconstruits et testés ; pour “Other”, l’IA génère un script de connecteur affiché pour validation avant exécution.
• Objectifs non poursuivis clarifiés (préserve les transcriptions) : Il ne réécrit ni ne résume le contenu ; les transcriptions restent verbatim dans les documents sources.

Comment utiliser garden-md

1. Installation et prérequis : Installez avec npm install -g garden-md. Utilisez Node.js 18+ et fournissez une clé API pour un fournisseur d’IA compatible.
2. Initialisez votre wiki : Exécutez garden init pour choisir votre fournisseur d’IA, configurer l’emplacement du wiki et activer git en option.
3. Connectez une source de données : Exécutez garden connect et sélectionnez un service — Grain, Granola, Fireflies.ai ou Other — pour configurer la synchronisation. Pour “Other”, fournissez le nom du service et l’URL de la documentation API.
4. Synchronisez de nouvelles transcriptions : Exécutez garden sync pour récupérer de nouvelles transcriptions dans la zone de mise en scène (affichée comme “wildland” dans la démo).
5. Traitez dans le wiki : Exécutez garden tend pour extraire les entités, créer des pages stubs et générer une structure markdown/wiki liée ; puis garden open pour parcourir le wiki HTML généré.

Commandes courantes : garden connect --repair (pour réparer les connecteurs défaillants), garden sync --schedule (synchronisation automatique basée sur cron), et garden tend / garden open pour traiter et parcourir.

Cas d’usage

• Transformer les transcriptions de réunions en wiki interne searchable : Après synchronisation des transcriptions depuis une source de notes/transcriptions de réunions, exécutez garden tend pour générer des pages d’entités et backlinks, afin que les membres de l’équipe parcourent les connaissances de l’entreprise par personne, entreprise ou produit/outil.
• Maintenir un “cerveau d’entreprise” basé sur du matériel source verbatim : Comme garden-md évite la réécriture/résumé, les équipes peuvent s’appuyer sur le contenu des transcriptions originales tout en bénéficiant d’une couche wiki structurée.
• Mettre à jour continuellement les pages wiki avec de nouvelles réunions : Utilisez garden sync (optionnellement avec --schedule) pour importer de nouvelles transcriptions, puis relancez garden tend pour que le wiki s’enrichisse et que les liens s’étendent avec les références supplémentaires.
• Onboarder équipes ou parties prenantes avec une couche de navigation commune : Utilisez garden open pour parcourir un wiki HTML avec navigation latérale et recherche, facilitant la découverte de mentions pertinentes dans de nombreuses transcriptions.
• Intégrer une source de transcription personnalisée via API : Choisissez “Other” dans garden connect et fournissez la documentation API ; l’outil génère un script de connecteur pour validation avant exécution.

FAQ

• garden-md réécrit-il ou résume-t-il mes transcriptions ? Non. garden-md conserve les transcriptions verbatim (il ne réécrit ni ne résume le contenu).

• Où est stocké le wiki ? Sous forme de fichiers markdown locaux (dossiers de fichiers .md) sur votre machine ; il ne nécessite ni base de données ni stockage cloud.

• Quels services sont supportés nativement ? Le dépôt liste les connecteurs intégrés et testés pour Grain, Granola et Fireflies.ai. Pour d’autres services, utilisez “Other” avec la documentation API.

• Que font garden tend et garden open ? garden tend lit la zone de mise en scène, envoie le contenu à votre fournisseur d’IA pour extraction d’entités, et met à jour le wiki markdown lié. garden open rend et sert le wiki HTML pour parcours.

• Quels prérequis sont nécessaires ? Le README indique que Node.js 18+ est requis, et vous avez besoin d’une clé API d’un fournisseur d’IA compatible.

Alternatives

• Construire un wiki manuellement avec markdown + scripts : Si vous avez seulement besoin d’une organisation basique, vous pouvez créer et lier des pages markdown vous-même sans extraction d’entités pilotée par l’IA ni workflows de rendu HTML.
• Utiliser une plateforme de documentation/wiki avec pipelines d’import : Les bases de connaissances généralistes peuvent stocker et rechercher des documents, mais le workflow diffère car garden-md génère spécifiquement des pages d’entités croisées de style Wikipédia à partir des transcriptions.
• Outils de résumé de transcriptions avec bases de connaissances : Certains outils se concentrent sur le résumé des transcriptions et l’indexation de ces résumés ; l’approche de garden-md est différente car elle préserve le texte original et construit des liens d’entités structurés plutôt que de remplacer le contenu par des résumés.
• Pipelines ETL personnalisés (sync → parse → index) : Pour les équipes disposant déjà d’un support ingénierie, vous pouvez reproduire le modèle « sync + extraction d’entités + liaison » avec vos propres outils et stockage, au lieu d’utiliser l’ensemble de commandes et le moteur wiki de garden-md.