Un studio de développement local : décrivez une mission, laissez les agents la réaliser et récupérez les fichiers avec leurs rapports de vérification.
VanOffice utilise votre installation de Codex ou de Claude Code. L’interface permet de lancer une mission, suivre chaque étape, régler la taille de l’équipe et télécharger les livrables. Le bureau et le village montrent l’activité réelle des agents.
Prérequis : Python 3.12 ou 3.13, Git et un compte connecté dans Codex ou Claude Code. L’interface n’a pas de dépendance npm ni de compilation. Les missions utilisent les crédits du fournisseur choisi.
git clone https://github.com/vandervan0001/VanOffice.git
cd VanOffice
python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python -m orchestrator serveOuvrez http://127.0.0.1:8765, choisissez le fournisseur et décrivez un petit projet précis. Commencez par Développement rapide + QA. Le lancement est explicite ; le résultat apparaît dans Projets. Ouvrez le projet pour lire les notes et télécharger son ZIP.
Sur Windows, utilisez WSL2. Sur macOS, bash launcher/start.sh démarre le serveur et ouvre le navigateur après l’installation. bash launcher/install-launcher.sh crée un raccourci sur le Bureau sans remplacer un raccourci existant.
| Parcours | Travail effectué | Résultat |
|---|---|---|
quick-task |
Développement, QA, jusqu’à deux tours de correction | Fichiers et rapport final |
product-full |
Spécification, architecture, développement en équipe, QA, documentation et textes de présentation | Projet et notes de chaque équipe |
research |
Recherche et synthèse | Notes Markdown ; aucun fichier applicatif promis |
Le parcours complet consomme davantage de temps et de crédits. Dans Réglages de l’équipe, le nombre d’agents simultanés est un plafond par mission ; plusieurs missions cumulent leur consommation.
Une QA négative ou avec réserves, une réponse vide ou une erreur de fournisseur met la mission en échec. Les fichiers déjà créés restent récupérables. Une mission interrompue est identifiée lorsque son processus a disparu. Pour reprendre un travail, lancez une nouvelle mission avec un brief corrigé : il n’y a pas de reprise automatique au milieu d’une étape.
Codex est le choix initial. Vérifiez votre connexion avec codex login status. Claude Code se sélectionne dans l’interface ; vérifiez sa connexion avec claude auth status. Le diagnostic python -m orchestrator doctor contrôle la configuration et la présence des outils ; il ne consomme pas de crédits et ne prouve pas l’authentification.
Le modèle par défaut est celui du CLI. Les commandes, délais et modèles explicites se configurent dans config.yaml. config.local.yaml, ignoré par Git, surcharge les clés de premier niveau. Choisir un fournisseur dans l’interface désactive les anciens paliers pour éviter de continuer à utiliser un autre fournisseur à votre insu. Les agents peuvent néanmoins épingler un fournisseur dans leur définition ; ces choix sont visibles dans la liste d’équipe.
Les fournisseurs API compatibles CrewAI/LiteLLM sont utilisables pour les parcours texte, dont research. Ils ne disposent pas ici des outils pour créer un projet sur disque. Un exemple Ollama est fourni ; le modèle correspondant doit être installé dans Ollama. La qualité et les faits d’une recherche dépendent du modèle et de ses outils : les sources restent à vérifier.
output/<mission>/ fichiers créés par les agents
vault/Projects/<mission>/ brief, étapes, erreurs et rapport final
vault/Chat.md conversation persistante
vault/Logbooks/ journaux par département
runs/ activité et logs des missions détachées
team.yaml réglages locaux de l’équipe
config.local.yaml choix local du fournisseur
Ces données sont ignorées par Git. Le dossier vault peut aussi s’ouvrir dans Obsidian.
Le ZIP rassemble source/ et notes/. Il écarte les dépendances, les dossiers de build, les fichiers cachés sauf .gitignore et .env.example, les clés privées usuelles et les liens symboliques. Il est limité à 50 Mo avant compression. Pour une livraison plus volumineuse ou des fichiers exclus, utilisez le dossier output. L’export ne constitue pas une revue de secrets du code produit.
python -m orchestrator run "Crée un minuteur autonome en français" --pipeline quick-task
python -m orchestrator run "Compare ces trois options" --pipeline research --bg
python -m orchestrator agents
python -m orchestrator pipelines
python -m orchestrator search "mot-clé"
python -m orchestrator serve --port 8770Les missions lancées depuis l’interface ou avec --bg continuent après fermeture de l’onglet. Les erreurs de démarrage sont renvoyées à l’interface ; les logs détaillés sont dans runs/.
VanOffice est une application personnelle sur localhost, sans comptes web ni hébergement multi-utilisateur. Le serveur écoute uniquement sur 127.0.0.1. N’exposez pas ce port sur Internet.
Les agents peuvent lancer des commandes dans leurs espaces de travail avec les permissions de votre CLI. Des dossiers séparés ne constituent pas à eux seuls une isolation de sécurité. Les prompts et les éléments de contexte sont transmis au fournisseur choisi. La télémétrie CrewAI est désactivée, mais cela ne désactive pas celle des fournisseurs.
Les alertes connues sur les dépendances et leur portée sont décrites dans SECURITY.md.
Le verdict QA est celui d’agents : relisez et testez le résultat avant de l’utiliser en production. VanOffice ne publie pas automatiquement les projets créés.
Le Portfolio, facultatif, consulte des dépôts locaux déclarés par l’utilisateur. Le mode avancé d’édition d’un dépôt existant utilise un worktree et reste accessible en CLI : mode opérateur. Il exige macOS et Claude Code ; il n’est pas lancé par les parcours web ordinaires.
Pour consulter l’état de vos dépôts existants, copiez portfolio.example.yaml vers portfolio.yaml, puis remplacez le chemin d’exemple par le chemin absolu de votre dépôt. Ajoutez une entrée sous repos pour chaque dépôt à suivre. Le fichier reste local et n’est pas publié par Git.
La vue Portfolio affiche la branche, les modifications en cours et la synchronisation avec le dernier état distant connu de Git. Elle ne lance pas de récupération distante. Le mode de déploiement reste « inconnu » sauf si vous indiquez explicitement deploy_decoupled: false pour un dépôt où un push déclenche un déploiement.
Installez Node.js 22 pour les tests du frontend, puis :
python -m pip install -r requirements-dev.txt
python -m pytest -q
node --test design/orchestrator-dashboard/*.test.jsLes tests exécutent le moteur avec un fournisseur local de test, sans appel payant : création de fichiers, QA, corrections, échecs, persistance et export. La CI les lance sur Linux et macOS, avec Python 3.12 et 3.13. Les dépendances directes sont dans requirements.in ; les fichiers .txt verrouillent aussi les dépendances transitives.
Consultez CONTRIBUTING.md, l’architecture et les règles issues des bugs corrigés.
Code sous licence MIT. Les graphismes du village et les polices ont leurs propres notices : graphismes, polices. Le village reprend une idée d’Agent-Quest : représenter le travail des agents par des personnages et des lieux.