java fm playground

☕ ☕ ground Java FM Playground

Bienvenue dans le terrain de jeu de la Java Foundation Model (FM), un bac à sable pour explorer l'intégration Java avec le substratum rocheux d'Amazon .

IMPORTANT: Cette application est à des fins éducatives et non destinées à une utilisation en production.

Aperçu

Ce référentiel comprend une application Spring Boot et un frontend Next.js , les deux exécutables localement. Vous trouverez ci-dessous une capture d'écran de l'application en action.

Important

• L'exécution de cette application peut entraîner des frais vers votre compte AWS. Pour plus de détails, voir les prix du substratum rocheux d'Amazon.
• Cette application est configurée pour s'exécuter dans us-east-1 et n'a pas été testée dans chaque région AWS. Pour plus d'informations, consultez les services régionaux AWS.
• Nous vous recommandons d'accorder à votre code le moins de privilèges, c'est-à-dire uniquement les autorisations minimales requises par la demande. Vous pouvez trouver un document de politique IAM avec les autorisations requises dans ce référentiel chez resources/bedrock-access-policy.json (politique d'affichage).

Condition préalable

Assurez-vous que vous avez installé les suivants:

• Java JDK 17+ (par exemple Amazon Corrett, une distribution gratuite du JDK)
• Apache Maven pour le serveur backend
• Node.js (v18.17 +) pour l'application Frontend
• Vous devez avoir un compte AWS et avoir vos informations d'identification par défaut et votre région AWS configurées comme décrit dans le guide de référence de configuration et d'identification AWS Tools et SDKS.
• Vous devez demander l'accès aux modèles avant de pouvoir les utiliser. Pour plus d'informations, voir l'accès au modèle. Pour exécuter l'application, vous avez besoin d'accéder aux modèles suivants dans us-east-1 :
  • Claude anthropique
  • AI21 Labs Jurassic-2 Mid
  • Stabilité AI Diffusion stable xl

Exécution de l'application

Après avoir vérifié les conditions préalables, suivez ces étapes:

Cloner le référentiel

Ouvrez un terminal, accédez à un répertoire de votre choix et exécutez la commande suivante:

git clone https://github.com/build-on-aws/java-fm-playground.git

Configuration du backend

Dans le répertoire java-fm-playground/backend , exécutez:

mvn spring-boot:run

Une fois le serveur exécuté, vous verrez la sortie suivante:

...
2023-11-13T14:19:02.862+01:00  INFO 34848 --- [main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 55500 (http) with context path ' '
2023-11-13T14:19:02.868+01:00  INFO 34848 --- [main] a.c.e.b.SpringFmPlaygroundApplication    : Started SpringFmPlaygroundApplication in 1.415 seconds (process running for 1.659)

? Le backend s'exécute sur le port 55500 par défaut. Voir ci-dessous pour les modifications du port.

Configuration du frontend

Dans une nouvelle fenêtre de terminal , accédez au répertoire frontend et installez les packages requis en exécutant la commande suivante:

npm install

Après une installation réussie, vous pouvez démarrer l'application Frontend en exécutant la commande suivante:

npm run dev

Lorsque l'application est en cours d'exécution, vous verrez la sortie suivante:

 > [email protected] dev
> next dev

   ▲ Next.js 14.0.0
   - Local:        http://localhost:3000

 ✓ Ready in 3.3s

Accéder à la demande

Ouvrez http://localhost:3000 dans votre navigateur Web pour interagir avec l'application.

Arrêter la demande

Pour arrêter l'application, vous devrez arrêter à la fois les processus backend et frontend.

Arrêter le frontend

Dans le terminal où le frontend est en cours d'exécution, appuyez sur Ctrl + C pour terminer le processus.

Arrêter le backend

De même, dans le terminal backend, utilisez le raccourci Ctrl + C pour arrêter le serveur.

Si vous rencontrez des problèmes, vous pouvez terminer avec force les processus en trouvant l'ID de processus ( PID ) et en utilisant la commande kill sur des systèmes ou un gestionnaire de tâches basés sur UNIX sur Windows.

En utilisant différents ports

Modifiez le port backend dans les fichiers suivants:

• backend/src/main/resources/application.yml
• frontend/app/app.config.js

Pour exécuter le frontend sur un autre port:

npm run dev -- --port NEW_PORT

Dépannage

La région AWS est codée en dur dans l'application. Cependant, si votre variable d'environnement AWS_REGION locale est définie sur une autre région, l'application peut échouer. Dans ce cas, assurez-vous de Undet AWS_REGION ou de le définir sur us-east-1 .

Licence

Cette bibliothèque est autorisée sous la licence MIT-0. Voir le fichier de licence.

Sécurité

Voir contribuer pour plus d'informations.