java fm playground

☕ Java FM -Spielplatz

Willkommen auf dem Java Foundation Model (FM) Playground, einem Sandkasten zur Erkundung der Java -Integration mit Amazon Bedrock .

WICHTIG: Diese Anwendung dient zu Bildungszwecken und nicht für den Produktionsgebrauch.

Überblick

Dieses Repository enthält eine Spring -Boot -Anwendung und ein Next.js Frontend, beide ausführbar. Unten finden Sie einen Screenshot der App in Aktion.

Wichtig

• Das Ausführen dieser Anwendung kann zu Gebühren für Ihr AWS -Konto führen. Weitere Informationen finden Sie unter Amazon Bedrock Pricing.
• Diese App ist so konfiguriert, dass sie in us-east-1 ausgeführt wird und in jeder AWS-Region nicht getestet wurde. Weitere Informationen finden Sie unter AWS Regional Services.
• Wir empfehlen Ihnen, Ihrem Code am wenigsten Berechtigungen zu gewähren, dh nur die vom Antrag erforderlichen Mindestberechtigungen. Sie finden ein IAM-Richtliniendokument mit den erforderlichen Berechtigungen in diesem Repository unter resources/bedrock-access-policy.json (Display-Richtlinie).

Voraussetzungen

Stellen Sie sicher, dass Sie die folgenden Installation haben:

• Java Jdk 17+ (z. B. Amazon Corretto, eine freie Distribution des JDK)
• Apache Maven für den Backend Server
• Node.js (v18.17+) für die Frontend -Anwendung
• Sie müssen über ein AWS -Konto verfügen und Ihre Standard -Anmeldeinformationen und die AWS -Region wie in den AWS -Tools und SDKs Shared Configuration and Reference -Handbuch beschrieben konfigurieren.
• Sie müssen Zugriff auf die Modelle anfordern, bevor Sie sie verwenden können. Weitere Informationen finden Sie unter Modellzugriff. Um die App auszuführen, benötigen Sie Zugriff auf die folgenden Modelle in us-east-1 :
  • Anthropic Claude
  • AI21 Labs Jurassic-2 Mid
  • Stabilität AI Stabile Diffusion xl

Ausführen der Anwendung

Befolgen Sie nach Überprüfung der Voraussetzungen folgende Schritte:

Klonen Sie das Repository

Öffnen Sie ein Terminal, navigieren Sie zu einem Verzeichnis Ihrer Wahl und führen Sie den folgenden Befehl aus:

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

Backend -Setup

Rennen Sie im java-fm-playground/backend Verzeichnis:

mvn spring-boot:run

Sobald der Server ausgeführt wird, sehen Sie die folgende Ausgabe:

...
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)

? Das Backend läuft standardmäßig auf Port 55500. Siehe unten für Portwechsel.

Frontend -Setup

Navigieren Sie in einem neuen Terminalfenster zum frontend -Verzeichnis und installieren Sie die erforderlichen Pakete, indem Sie den folgenden Befehl ausführen:

npm install

Nach erfolgreicher Installation können Sie die Frontend -Anwendung starten, indem Sie den folgenden Befehl ausführen:

npm run dev

Wenn die Anwendung ausgeführt wird, sehen Sie die folgende Ausgabe:

 > [email protected] dev
> next dev

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

 ✓ Ready in 3.3s

Zugriff auf die Anwendung

Öffnen Sie http://localhost:3000 in Ihrem Webbrowser, um mit der Anwendung zu interagieren.

Beantragung der Anwendung

Um die Anwendung zu stoppen, müssen Sie sowohl die Backend- als auch die Frontend -Prozesse stoppen.

Stoppen des Frontends

Drücken Sie im Terminal, an dem der Frontend ausgeführt wird, Ctrl + C um den Prozess zu beenden.

Stoppen des Backends

In ähnlicher Weise verwenden Sie im Backend Terminal die Ctrl + C -Verknüpfung, um den Server zu stoppen.

Wenn Sie auf Probleme stoßen, können Sie die Prozesse mit gewaltsamer Beendigung der Prozesses ( PID ) beenden und den Befehl kill auf Unix-basierten Systemen oder Task-Manager unter Windows verwenden.

Verwenden verschiedener Ports

Ändern Sie den Backend -Port in den folgenden Dateien:

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

Um den Frontend an einem anderen Port zu führen:

npm run dev -- --port NEW_PORT

Fehlerbehebung

Die AWS-Region ist in der Anwendung hart codiert. Wenn jedoch Ihre lokale AWS_REGION -Umgebungsvariable auf eine andere Region eingestellt ist, kann die Anwendung möglicherweise fehlschlagen. In diesem Fall stellen Sie bitte sicher, dass AWS_REGION nicht eingestuft wird, oder stellen Sie es auf us-east-1 ein.

Lizenz

Diese Bibliothek ist im Rahmen der MIT-0-Lizenz lizenziert. Siehe die Lizenzdatei.

Sicherheit

Weitere Informationen finden Sie unter Beitrag.