Environnements notebook

Les Explorations ouvrent des environnements notebook pour exécuter des notebooks Python, garder les fichiers avec le workspace et documenter les décisions de recherche au même endroit.

Dernière mise à jour : 26 juin 2026

Exploration TheoryCraft avec workspace notebook, navigateur de fichiers, cellules notebook et résultats sauvegardés

Utilise un environnement notebook quand tu dois faire de la recherche interactive : charger des données, lancer des calculs, inspecter des graphiques, comparer des résultats et sauvegarder le raisonnement à côté du code.

Démarrer une session notebook

  1. Ouvre une exploration.
  2. Démarre le workspace notebook s'il n'est pas déjà disponible.
  3. Attends que l'interface notebook soit chargée.
  4. Ouvre main.ipynb ou crée un autre notebook.
  5. Exécute les cellules, sauvegarde ton travail et arrête la session quand tu as fini.

Un démarrage à froid peut prendre un peu de temps. Attends l'interface notebook et le kernel Python avant de conclure qu'il y a un problème.

Fichiers de départ

Les nouvelles explorations incluent deux fichiers importants :

Fichier Rôle
main.ipynb Notebook de départ pour l'hypothèse, le code, les sorties et les notes.
requirements.txt Packages installés automatiquement au démarrage de la session notebook.

Garde le notebook principal assez lisible pour comprendre le travail plusieurs semaines plus tard : ce que tu as testé, quelles données tu as utilisées, ce qui a changé et ce que tu as décidé.

Installer des packages Python

Il y a deux façons d'installer des packages selon qu'ils doivent rester dans l'exploration ou non.

Besoin Action
Utiliser le package à chaque démarrage de l'exploration Ajoute-le à requirements.txt, sauvegarde le fichier, puis redémarre la session notebook.
Tester rapidement un package Exécute %pip install package-name dans une cellule notebook.

Les packages installés avec %pip sont pratiques pour expérimenter, mais ce n'est pas le meilleur endroit pour documenter les dépendances durables. Si le package compte pour la recherche, ajoute-le à requirements.txt après avoir validé l'essai.

Si un import échoue encore après modification de requirements.txt, redémarre le kernel Python ou la session notebook pour charger proprement les nouveaux packages.

Sauvegarder et structurer le travail

Pratique Pourquoi c'est important
Sauvegarder avant de fermer l'onglet Évite de perdre les dernières modifications du notebook.
Utiliser des cellules markdown Rend les résultats compréhensibles sans tout relancer.
Séparer le scratch Rend les notebooks relus plus simples à partager.
Nommer clairement les exports Aide à retrouver fichiers et graphiques plus tard.
Retirer les secrets des notebooks Les partages publics peuvent inclure texte et sorties notebook.

Limites de plan

Les sessions notebook actives peuvent compter dans les limites de ton plan. Si TheoryCraft indique qu'une autre session doit être arrêtée, ouvre Usage pour voir ce qui est actif.

Arrête les sessions inutilisées, surtout après une longue passe de recherche ou quand tu passes à une autre exploration.

Dépannage

Symptôme À essayer
L'interface notebook reste en chargement Attends brièvement, puis recharge l'exploration.
Le kernel Python est déconnecté Redémarre le kernel depuis l'interface notebook.
Un import échoue Vérifie le nom, installe avec %pip, ou ajoute le package à requirements.txt puis redémarre.
Limite de plan atteinte Arrête une autre session notebook active ou ajuste ton plan.
L'assistant ne voit pas une modification récente Sauvegarde le notebook, puis redemande.

FAQ

Les fichiers notebook sont-ils permanents ?

Les fichiers attachés à l'exploration persistent. La session notebook active peut s'arrêter et être redémarrée plus tard.

Peut-on partager un notebook en cours d'exécution ?

Les partages sont des snapshots en lecture seule. Sauvegarde d'abord le notebook, puis utilise Partager des explorations pour créer un lien public.

Un assistant externe peut-il travailler avec les notebooks ?

Oui. Utilise Paramètres développeur et Connecter un assistant externe quand tu veux qu'un client compatible MCP accède à ton workspace TheoryCraft.