starnet

StarNet est une application de bureau local-first qui vous permet de créer des agents IA, de les organiser dans une station spatiale en pixel-art et de les regarder effectuer un vrai travail à l'aide de vrais modèles et outils. La station n'est pas simplement décorative ; c'est une projection en direct de l'état d'exécution où les salles représentent des équipes à périmètre de capacités, les couloirs sont des voies de transfert autorisées et les objets placés sont de véritables attributions de capacités. Les capacités clés incluent : - Créer plusieurs agents avec des classes, des personas et des équipements distincts, chacun s'exécutant simultanément dans son propre espace de travail avec des permissions limitées. - Apporter vos propres clés API (OpenRouter, Anthropic, OpenAI, Google) stockées en toute sécurité dans le trousseau du système d'exploitation ; le frontend ne détient jamais de secrets. - Connecter les agents à des plateformes de messagerie telles que Telegram, Discord, Slack, Signal ou Matrix pour une interaction à distance. - Utiliser des modèles locaux via Ollama sans clé API ni coût. - Planifier des tâches avec cron, lancer des recettes multi-étapes et accorder des compétences réutilisables. - Poser des questions de clarification via des Task Briefs plutôt que de deviner. - Livrer le travail terminé sous forme de vrais fichiers dans un répertoire OUTBOX. - Attacher des serveurs Model Context Protocol (MCP) et des connecteurs paste-a-key/OAuth pour étendre les capacités des agents. - Dictée vocale push-to-talk et sortie vocale cohérente de la station. - Registres persistants sur disque pour les dépenses, les budgets, l'historique des tâches et les planifications. L'architecture sépare les préoccupations : - `frontend/` : monde de la station en JavaScript vanilla et interface de bureau. - `sidecar/` : runtime d'agent Node.js local gérant les fournisseurs, les outils, la persistance, les budgets et le consentement. - `shared/` : contrats d'événements et de schémas transversaux. - `src-tauri/` : coque de bureau Rust/Tauri et runtime intégré. - `test/` et `qa/` : tests unitaires, de contrat, d'intégration et de release-gate, plus les reçus de QA en direct. Le train de publication public prend en charge Windows 10/11 (64 bits) et macOS (Apple Silicon et Intel). Les paquets Linux sont des artefacts de build internes et ne constituent pas une cible publique prise en charge. Les builds de bureau sont publiés sur la page des releases GitHub. Pour exécuter depuis les sources, vous avez besoin de Node.js 18+ (Node.js 22 correspond à la CI), Git, et éventuellement des prérequis Rust et Tauri pour la coque de bureau. Le sidecar peut être démarré directement avec `node sidecar/index.js`, puis ouvrez http://localhost:8787 dans un navigateur. Pour le développement, utilisez `npm run desktop:dev` et `npm run desktop:build`. Les tests s'effectuent via des scripts npm : `npm run test:fast` (gate de fusion requis), `npm run test:http` (suite HTTP/E2E du sidecar en direct), `npm test` (validation complète) et `npm run security:secrets` (analyse des secrets sur tout l'historique). L'état de préparation à la publication est validé avec `npm run qa:ready`. Les contributions sont les bienvenues ; voir CONTRIBUTING.md et le Code of Conduct. Les vulnérabilités de sécurité doivent être signalées en privé conformément à SECURITY.md. Le projet est open source sous licence MIT. La licence couvre uniquement le code ; le nom StarNet, le logo, les illustrations de la station et l'identité de marque appartiennent à Andrew Sims et ne sont pas sous licence avec le code. Les forks doivent utiliser leur propre nom, logo et illustrations et ne peuvent pas se présenter comme StarNet ni comme approuvés par le projet.