Aller au contenu principal

Démarrage rapide – Exécuter la plateforme localement

Obtenez la pile FirstBreath complète en quelques étapes. Pour les détails spécifiques aux composants, utilisez les liens ci-dessous.

1. Cloner la plateforme (monorepo)​

git clone --recursive https://github.com/FirstBreath/FirstBreath-Platform.git
cd FirstBreath-Platform

Si vous avez déjà cloné sans --recursive :

./setup.sh

2. Environnement​

Créez le fichier d'environnement global utilisé par toutes les sous-piles :

cp .env.example .env
# Modifiez .env et définissez des mots de passe sécurisés (DB, Redis, etc.)

3. Démarrer l'infrastructure et les services​

Depuis la racine de la plateforme :

docker-compose up -d --build

Cela démarre l'infrastructure partagée (MySQL, Redis) et les services définis dans le docker-compose.yml racine. Ajustez selon votre configuration si vous exécutez backend/vision dans des dépôts séparés.

4. Backend (Control Hub)​

  • Installation : Backend – Installation
  • URL : http://localhost:3333 (par défaut)
  • Exécutez les migrations et le seed : node ace migration:run puis node ace db:seed (depuis le répertoire Control-Hub-Back).

5. Vision (optionnel, nécessite un GPU)​

  • Démarrage rapide : Vision – Quickstart
  • URLs : Camera Manager et logs Batch Inference ; métriques sur le port 4002 si exposé.
  • Nécessite un GPU NVIDIA et le réseau Docker control-hub-network (généralement créé par la pile backend).

6. Frontend (my-app) et Mobile​

  • Frontend : Exécutez depuis le dépôt my-app (npm run dev ou yarn dev). Pointez NEXT_PUBLIC_API_URL vers votre backend (par ex. http://localhost:3333).
  • Mobile : Mobile – Setup. Utilisez l'IP LAN de votre machine pour EXPO_PUBLIC_API_URL afin que l'appareil puisse atteindre l'API.

URLs utiles (par défaut)​

ServiceURL
API Backendhttp://localhost:3333
Métriques Visionhttp://localhost:4002
Flux RTSPrtsp://localhost:8554/cam1

Pour le déploiement, voir Infrastructure – Déploiement.