Comment Arrêter de Se Noyer dans le Code des Autres et Commencer à Vivre avec Sourcebot

Situation familière : vous vous lancez dans un nouveau projet ou vous essayez de comprendre un monstre legacy que trois générations de développeurs ont écrit avant vous. L'IDE essaie honnêtement d'aider, mais sauter entre les définitions de fonctions dans dix dépôts différents se transforme en quête. Habituellement, dans ces moments, vous voulez juste demander à quelqu'un : « Où est la logique de traitement des paiements de toute façon ? » Mais les collègues sont occupés, et la documentation est devenue obsolète l'année dernière.

Je suis récemment tombé sur Sourcebot. C'est un outil open-source que vous pouvez auto-héberger et utiliser comme guide personnel à travers votre codebase. Il peut indexer vos dépôts et répondre aux questions en langage naturel, en citant des lignes de code spécifiques.

Qu'est-ce que c'est exactement

En bref, Sourcebot est un mélange de recherche de code avancée et d'assistant LLM. La caractéristique principale est qu'il est auto-hébergé. Cela résout la question de sécurité éternelle : « Nos codes sources ne vont-ils pas finir chez OpenAI ? » Vous contrôlez où le service s'exécute et quelles données il voit.

L'outil aborde plusieurs points douloureux à la fois. Premièrement, il vous offre une recherche rapide sur toutes vos branches et dépôts simultanément. Deuxièmement, il construit un graphe de navigation de niveau IDE directement dans le navigateur. Et la cerise sur le gâteau — un chat qui comprend le contexte de votre projet.

Ce dont il est capable

Les développeurs ont souligné plusieurs domaines principaux qui font vraiment gagner du temps au quotidien.

Chat intelligent avec contexte

Vous écrivez une question comme : « Comment l'autorisation est-elle configurée dans ce service ? » Sourcebot ne devine pas au hasard — il utilise ses index de recherche, trouve les fichiers pertinents, analyse les connexions et livre une réponse avec des citations. C'est plus pratique qu'un ChatGPT classique car vous obtenez des preuves sous forme de liens vers le code.

Recherche sans latence

Un grep classique sur un huge monorepo peut traîner. Ici, la recherche fonctionne très rapidement. Elle prend en charge les expressions régulières, les filtres par langage et dépôt, ainsi que les opérateurs logiques. Vous pouvez trouver rapidement tous les endroits où une bibliothèque spécifique ou une configuration particulière est utilisée, même si vous avez des dizaines de projets.

Navigation dans le navigateur

Parfois, vous avez juste besoin de fouiner dans le code sans le télécharger localement. L'explorateur intégré prend en charge la coloration syntaxique et Go to Definition. Cela fonctionne de manière cross-repository : si une fonction est définie dans un projet voisin, Sourcebot vous y amènera.

Comment ça fonctionne en interne

Le projet est écrit en TypeScript. Il nécessite Docker pour fonctionner, car le moyen le plus simple de déployer est via Docker Compose. L'architecture est conçue pour que vous puissiez brancher vos propres LLMs. Dans la config, vous pouvez spécifier les fournisseurs de modèles, configurer l'authentification et indiquer quels dépôts de GitHub ou GitLab indexer.

Curieusement, les auteurs préviennent honnêtement de la collecte de données de télémétrie anonymes. Vous pouvez la désactiver avec une seule variable d'environnement SOURCEBOT_TELEMETRY_DISABLED=true, ce qui est appréciable — aucune activité cachée.

Comment lancer et tester

Le déploiement prend quelques minutes si vous avez déjà Docker. Commencez par télécharger la config :

curl -o docker-compose.yml https://raw.githubusercontent.com/sourcebot-dev/sourcebot/main/docker-compose.yml

Puis créez config.json. Dedans, vous décrivez où le bot doit chercher. Pour un test, vous pouvez le pointer vers le dépôt Sourcebot lui-même :

{
    "$schema": "https://raw.githubusercontent.com/sourcebot-dev/sourcebot/main/schemas/v3/index.json",
    "connections": {
        "starter-connection": {
            "type": "github",
            "repos": [
                "sourcebot-dev/sourcebot"
            ]
        }
    }
}

Après cela, lancez les conteneurs avec docker compose up et dirigez-vous vers localhost:3000.

Qui trouvera cela utile

Je vois la valeur de Sourcebot dans deux scénarios. Le premier est lorsqu'une équipe grandit rapidement et que les nouveaux venus passent trop de temps en onboarding. Au lieu de déranger le lead, ils peuvent « consulter » le bot. Le second est lorsque vous avez un zoo de microservices, et tracer le chemin des données entre les services devient physiquement douloureux.

Le projet est encore en évolution, et il y a une liste décente d'issues ouvertes dans le dépôt, mais la base est déjà assez utilisable. Si vous cherchiez un moyen de rendre vos connaissances en code plus accessibles à l'équipe sans vouloir envoyer de données dans le cloud — c'est un excellent candidat à essayer.

Au fait, ils ont une démo publique, donc vous pouvez même essayer l'interface sans installer quoi que ce soit. Cela vous aide à comprendre si ce format de travail avec le code vous convient.