ArTEMiS-Testskriptgenerator

Diese Python-Anwendung nutzt ein lokal mit Ollama betriebenes Llama3.1-Modell, um automatisch Testskripte für vorgegebene Musterlösungen zu erstellen. Die generierten Tests sind speziell für den Einsatz in der ArTEMiS-Lernumgebung konzipiert.

Ziel ist es, Kursentwicklerinnen und -entwickler zu entlasten, die Erstellung neuer Kurse zu vereinfachen und die Qualität der Kurse durch automatisierte Testskriptgenerierung zu steigern.

Vor jeder Anfrage wird die Eingabe optional auf syntaktische Korrektheit und das Vorhandensein von testbaren Strukturen überprüft. Anschließend wird die Anfrage mittels eines speziell entwickelten Kombinations-Prompts oder einem belibigen Spezialisierungs-Prompt an das lokale Llama3.1-Modell übergeben. Das Modell verarbeitet die Anfrage und liefert einen generiertes Testskript zurück.

Features

• Automatisierte Testskriptgenerierung: Basierend auf einer Musterlösung werden Testskripte generiert.
• ArTEMiS-Integration: Speziell für den Einsatz in der ArTEMiS-Lernumgebung optimiert.
• Flexible Eingaben: Unterstützt verschiedene Python-Programmieraufgaben.
• Lokale Ausführung: Modell läuft lokal ohne Internetverbindung.
• Validierung: Eingaben werden vor der Verarbeitung überprüft (syntaktische Korrektheit, testbare Strukturen).

Installation

1. Terminal öffnen:
   Starten Sie ein Terminalfenster auf Ihrem System und führen Sie die folgenden Schritte aus.

2. Python installieren: Installieren Sie Python 3.10 oder höher über die offizielle Python-Website und überprüfen Sie die Installation anschließend mit dem Befehl:

   python --version

3. Git installieren: Installieren Sie Git 2.40.1 oder höher über die offizielle Git-Website und überprüfen Sie die Installation anschließend mit dem Befehl:

   git --version

4. Ollama installieren:
   Installieren Sie Ollama 0.4.2 oder höher über die offizielle Ollama-Website und überprüfen Sie die Installation anschließend mit dem Befehl:

   ollama --version

5. Llama3-Modell laden:
   Laden Sie das Llama 3.1-Modell mit Ollama herunter:

   ollama pull llama3.1:8b

6. Repository klonen:
   Klonen Sie das Repository des Testskriptgenerators:

   git clone https://git-st.inf.tu-dresden.de/ag-feedbacksysteme/student-projects/ba-yorick-behme.git

7. Ins Code-Verzeichnis wechseln:
   Navigiere in das Hauptverzeichnis des Projekts:

   cd ArTEMiS-Testgenerator/src

8. Programm starten:
   Führe die Anwendung aus:

   python3 main.py

Projektstruktur

├── src/
│   ├── generator_manager.py  
│   ├── main.py
│   ├── prompt_manager.py
│   ├── prompts.json
│   ├── ui_main.py
│   ├── ui_settings.py
│   └── validator_manager.py
├── LICENSE
└── README.md

Hinweise

• Version: Diese Anwendung basiert auf Prototyp-Version version-50.
• Einschränkungen: Derzeit wird nur Python-Code und nur das Model Llama3.1:8b unterstützt.
• Feedback: Für Fragen, Fehlerberichte oder Vorschläge kannst du ein Issue erstellen.

Lizenz

Dieses Projekt steht unter der MIT-Lizenz. Details dazu findest du in der Datei LICENSE.