Development: Initialize new Hyperion module for programming exercise creation assistance and migrate functionality from Iris

.github/CODEOWNERS

@@ -17,6 +17,7 @@
 /src/main/java/de/tum/cit/aet/artemis/atlas          @ls1intum/atlas-maintainers
 /src/main/java/de/tum/cit/aet/artemis/buildagent     @ls1intum/programming-maintainers
 /src/main/java/de/tum/cit/aet/artemis/communication  @ls1intum/communication-maintainers
+/src/main/java/de/tum/cit/aet/artemis/hyperion       @ls1intum/hyperion-maintainers
 /src/main/java/de/tum/cit/aet/artemis/iris           @ls1intum/iris-maintainers
 /src/main/java/de/tum/cit/aet/artemis/lecture        @ls1intum/lectures-maintainers
 /src/main/java/de/tum/cit/aet/artemis/lti            @ls1intum/lti-maintainers
@@ -31,6 +32,7 @@
 /src/main/webapp/app/atlas          @ls1intum/atlas-maintainers
 /src/main/webapp/app/buildagent     @ls1intum/programming-maintainers
 /src/main/webapp/app/communication  @ls1intum/communication-maintainers
+/src/main/webapp/app/hyperion       @ls1intum/hyperion-maintainers
 /src/main/webapp/app/iris           @ls1intum/iris-maintainers
 /src/main/webapp/app/lecture        @ls1intum/lectures-maintainers
 /src/main/webapp/app/lti            @ls1intum/lti-maintainers
@@ -44,6 +46,7 @@
 /src/test/java/de/tum/cit/aet/artemis/atlas          @ls1intum/atlas-maintainers
 /src/test/java/de/tum/cit/aet/artemis/buildagent     @ls1intum/programming-maintainers
 /src/test/java/de/tum/cit/aet/artemis/communication  @ls1intum/communication-maintainers
+/src/test/java/de/tum/cit/aet/artemis/hyperion       @ls1intum/hyperion-maintainers
 /src/test/java/de/tum/cit/aet/artemis/iris           @ls1intum/iris-maintainers
 /src/test/java/de/tum/cit/aet/artemis/lecture        @ls1intum/lectures-maintainers
 /src/test/java/de/tum/cit/aet/artemis/lti            @ls1intum/lti-maintainers

.github/issue-labeler.yml

@@ -91,6 +91,12 @@ iris:
   - \b(?<!\S)ai(?!\S)\b
   - caseSensitive: false
 
+hyperion:
+  - hyperion
+  - consistency check
+  - exercise generation
+  - caseSensitive: false
+
 lecture:
   - lecture
   - attachment

.github/labeler.yml

@@ -104,6 +104,13 @@ iris:
           - src/test/java/de/tum/cit/aet/artemis/iris/**/*
           - src/main/webapp/app/iris/**/*
 
+hyperion:
+  - changed-files:
+      - any-glob-to-any-file:
+          - src/main/java/de/tum/cit/aet/artemis/hyperion/**/*
+          - src/test/java/de/tum/cit/aet/artemis/hyperion/**/*
+          - src/main/webapp/app/hyperion/**/*
+
 lecture:
   - changed-files:
       - any-glob-to-any-file:

README.md

@@ -73,6 +73,7 @@ Artemis integrates with the [EduTelligence suite](https://github.com/ls1intum/ed
 
 * **Iris** - AI Virtual Tutor powered by Pyris for intelligent student assistance
 * **Athena** - Automated assessment system for text, modeling, and programming exercises
+* **Hyperion** - AI-powered programming exercise creation assistance
 
 Additional services are available in the EduTelligence suite for advanced deployments. For detailed information about all available services, please refer to the [EduTelligence repository](https://github.com/ls1intum/edutelligence).
 
@@ -145,6 +146,7 @@ The following members of the project management team are responsible for specifi
 | Atlas                 | Maximilian Anzinger ([@maximiliananzinger](https://github.com/maximiliananzinger)) |
 | Iris                  | Patrick Bassner ([@bassner](https://github.com/bassner))                           |
 | Athena                | Maximilian Sölch ([@maximiliansoelch](https://github.com/maximiliansoelch))        |
+| Hyperion              | Felix Dietrich ([@FelixTJDietrich](https://github.com/FelixTJDietrich))            |
 | Tutorial Groups       | Ramona Beinstingel ([@rabeatwork](https://github.com/rabeatwork))                  |
 | Plagiarism checks     | Markus Paulsen ([@MarkusPaulsen](https://github.com/MarkusPaulsen))                |
 | LTI                   | Maximilian Anzinger ([@maximiliananzinger](https://github.com/maximiliananzinger)) |

build.gradle

@@ -25,6 +25,7 @@ plugins {
     id "org.liquibase.gradle" version "${liquibase_plugin_version}"
     id "org.owasp.dependencycheck" version "12.1.3"
     id "org.springframework.boot" version "${spring_boot_version}"
+    id "com.google.protobuf" version "${protobuf_plugin_version}"
 }
 
 group = "de.tum.cit.aet.artemis"
@@ -151,6 +152,71 @@ configurations.configureEach {
     exclude group: "commons-configuration", module: "commons-configuration"
 }
 
+// Protobuf Configuration for gRPC Integration
+protobuf {
+    generatedFilesBaseDir = "$projectDir/src"
+
+    protoc {
+        artifact = "com.google.protobuf:protoc:${protobuf_version}"
+    }
+    plugins {
+        grpc {
+            artifact = "io.grpc:protoc-gen-grpc-java:${grpc_version}"
+        }
+    }
+    generateProtoTasks {
+        all().each { task ->
+            task.builtins {
+                java {
+                    outputSubDir = 'main/java'
+                }
+            }
+            task.plugins {
+                grpc {
+                    outputSubDir = 'main/java'
+                }
+            }
+        }
+    }
+}
+
+// Task to move generated files to correct location
+tasks.register("moveGeneratedFiles") {
+    doLast {
+        // Find all generated directories under src/main/main/java/de/tum/cit/aet/artemis/*/generated
+        def incorrectMainDir = file("src/main/main")
+        if (incorrectMainDir.exists()) {
+            def artemisPath = file("src/main/main/java/de/tum/cit/aet/artemis")
+            if (artemisPath.exists()) {
+                artemisPath.listFiles().each { moduleDir ->
+                    if (moduleDir.isDirectory()) {
+                        def generatedDir = new File(moduleDir, "generated")
+                        if (generatedDir.exists()) {
+                            def moduleName = moduleDir.name
+                            def targetDir = file("src/main/java/de/tum/cit/aet/artemis/${moduleName}/generated")
+
+                            println "Moving generated files for module: ${moduleName}"
+                            targetDir.parentFile.mkdirs()
+                            ant.move(todir: targetDir) {
+                                fileset(dir: generatedDir)
+                            }
+                        }
+                    }
+                }
+            }
+
+            // Clean up the incorrect main directory after moving all files
+            incorrectMainDir.deleteDir()
+        }
+    }
+}
+
+// Make sure generated files are moved after generation
+generateProto.finalizedBy moveGeneratedFiles
+
+compileJava.dependsOn generateProto
+compileTestJava.dependsOn generateProto
+
 dependencies {
 
     // Required by Spring cloud
@@ -284,6 +350,13 @@ dependencies {
     // Avoid outdated version of netty to prevent security issues
     implementation("net.minidev:json-smart") { version {strictly "2.5.2" } }
 
+    // gRPC Client Dependencies
+    implementation platform("io.grpc:grpc-bom:${grpc_version}")
+    implementation 'io.grpc:grpc-protobuf'
+    implementation 'io.grpc:grpc-stub'
+    implementation 'io.grpc:grpc-netty-shaded'
+    implementation "com.google.protobuf:protobuf-java:${protobuf_version}"
+    implementation 'javax.annotation:javax.annotation-api:1.3.2'
 
     // Required for synchronization between nodes and build agents (LocalCI)
     implementation "com.hazelcast:hazelcast:${hazelcast_version}"
@@ -406,8 +479,8 @@ dependencies {
     runtimeOnly "commons-beanutils:commons-beanutils:1.11.0"
     checkstyle "commons-beanutils:commons-beanutils:1.11.0"
 
-
     implementation "com.google.errorprone:error_prone_annotations:2.39.0"
+    implementation "io.grpc:grpc-services:${grpc_services_version}"
 
     // NOTE: we want to keep the same unique version for all configurations, implementation and annotationProcessor
     implementation("net.bytebuddy:byte-buddy") { version {              strictly byte_buddy_version } }
@@ -451,6 +524,11 @@ dependencies {
     testImplementation "org.apache.maven.surefire:surefire-report-parser:3.5.3"
     testImplementation "io.zonky.test:embedded-database-spring-test:2.6.0"
 
+    // gRPC testing dependencies
+    testImplementation "io.grpc:grpc-testing:${grpc_version}"
+    testImplementation "io.grpc:grpc-inprocess:${grpc_version}"
+    testImplementation "io.grpc:grpc-services:${grpc_services_version}"
+
     testImplementation "com.tngtech.archunit:archunit:1.4.1"
     testImplementation "org.skyscreamer:jsonassert:1.5.3"
 

docs/dev/development-process/development-process.rst

@@ -118,7 +118,7 @@ Naming Conventions for GitHub Pull Requests
 
     1. Possible feature tags are: ``Programming exercises``, ``Integrated code lifecycle``, ``Quiz exercises``, ``Modeling exercises``, ``Text exercises``, ``File upload exercises``, ``Exam mode``,
        ``Grading``, ``Assessment``, ``Communication``, ``Notifications``, ``Team exercises``, ``Lectures``, ``Integrated markdown editor``, ``Plagiarism checks``, ``Learning analytics``,
-       ``Adaptive learning``, ``Learning path``, ``Tutorial groups``, ``Iris``, ``Scalability``, ``Usability``, ``Performance``, ``Infrastructure``, ``Mobile apps``.
+       ``Adaptive learning``, ``Learning path``, ``Tutorial groups``, ``Iris``, ``Hyperion``, ``Scalability``, ``Usability``, ``Performance``, ``Infrastructure``, ``Mobile apps``.
     2. If the change is not visible to end users, or it is a pure development or test improvement, we use the term ``Development``:.
     3. Everything else belongs to the ``General`` category.
 

docs/dev/setup/server.rst

@@ -70,6 +70,13 @@ You only need to modify them if your specific work or production environments re
        athena:
             # If you want to use Athena, refer to the dedicated configuration section. Under Administration Guide, Setup of Extension Services.
 
+       hyperion:
+            # If you want to use Hyperion for programming exercise creation assistance, configure the service connection below.
+            # For production, enable TLS and configure certificates. See Hyperion Service section below.
+            host: localhost
+            port: 50051
+            use-tls: false
+
 **Note:**
 If you use a password for authentication, update it in ``gradle/liquibase.gradle``.
 
@@ -106,6 +113,8 @@ module replacement in the client.
   ``dev,jenkins,localvc,artemis,scheduling,core,atlas,local``.
 * **Artemis (Server, LocalVC & LocalCI, Athena):** The server will be started separated from the client with ``athena`` profile and Local VC / CI enabled
   (see `Athena Service <#athena-service>`__).
+* **Artemis (Server, LocalVC & LocalCI, Hyperion):** The server will be started separated from the client with ``hyperion`` profile and Local VC / CI enabled
+  (see `Hyperion Service <#hyperion-service>`__).
 * **Artemis (Server, LocalVC & LocalCI, Theia):** The server will be started separated from the client with ``theia`` profile and Local VC / CI enabled.
 * **Artemis (BuildAgent):** The server will be started separated from the client with the profiles ``buildagent,local``.
   This configuration is used to run the build agent for the local CI. This configuration is rarely needed for development.
@@ -250,3 +259,52 @@ sure to pass the active profiles to the ``gradlew`` command like this:
 .. code:: bash
 
    ./gradlew bootRun --args='--spring.profiles.active=dev,jenkins,localvc,artemis,scheduling'
+
+.. _hyperion-service:
+
+Hyperion Service
+^^^^^^^^^^^^^^^^
+
+Hyperion is an AI-powered Edutelligence microservice for programming exercise creation assistance. To enable Hyperion:
+
+1. **Setup Hyperion Service** (external dependency)
+
+   - Deploy Hyperion service separately (see Hyperion documentation)
+   - Ensure it's accessible from Artemis server
+
+2. **Configure Connection**
+
+   Update ``application-local.yml`` (for development):
+
+   .. code-block:: yaml
+
+      artemis:
+        hyperion:
+          host: localhost         # Hyperion service host  
+          port: 50051             # Hyperion gRPC port
+          use-tls: false          # Disable TLS for development
+
+   For production, enable TLS in ``application-artemis.yml``:
+
+   .. code-block:: yaml
+
+      artemis:
+        hyperion:
+          host: hyperion.domain.com
+          port: 50051
+          use-tls: true
+          client-cert-path: "/certs/artemis-client.crt"
+          client-key-path: "/certs/artemis-client.key"  
+          server-ca-path: "/certs/hyperion-ca.crt"
+
+3. **Enable Profile**
+
+   Add ``hyperion`` to active profiles:
+
+   .. code-block:: bash
+
+      ./gradlew bootRun --args='--spring.profiles.active=dev,localci,localvc,artemis,hyperion'
+
+4. **Verify Setup**
+
+   Check health endpoint: ``http://localhost:8080/actuator/health/hyperion``

gradle.properties

@@ -37,6 +37,12 @@ netty_version=4.1.118.Final
 mysql_version=9.3.0
 micrometer_version=1.15.1
 
+# protobuf and gRPC versions for Edutelligence integration
+protobuf_plugin_version=0.9.5
+protobuf_version=4.31.1
+grpc_version=1.73.0
+grpc_services_version=1.71.0
+
 # testing
 # make sure both versions are compatible
 junit_version=5.13.2

src/main/java/de/tum/cit/aet/artemis/ArtemisApp.java

@@ -1,5 +1,6 @@
 package de.tum.cit.aet.artemis;
 
+import static de.tum.cit.aet.artemis.core.config.Constants.PROFILE_HYPERION;
 import static de.tum.cit.aet.artemis.core.config.Constants.UPLOADS_FILE_PATH_DEFAULT;
 import static de.tum.cit.aet.artemis.core.config.Constants.UPLOADS_FILE_PATH_PROPERTY_NAME;
 import static tech.jhipster.config.JHipsterConstants.SPRING_PROFILE_DEVELOPMENT;
@@ -78,6 +79,8 @@ public void initApplication() {
     public static void main(String[] args) {
         SpringApplication app = new SpringApplication(ArtemisApp.class);
         DefaultProfileUtil.addDefaultProfile(app);
+        // Enable Hyperion profile by default TODO: REMOVE!!!!!!!!!!!!!!!!!!!!!!!!!!
+        app.setAdditionalProfiles(PROFILE_HYPERION);
         var context = app.run(args);
         Environment env = context.getEnvironment();
         String fileUploadPath = env.getProperty(UPLOADS_FILE_PATH_PROPERTY_NAME);

src/main/java/de/tum/cit/aet/artemis/core/config/Constants.java

@@ -318,6 +318,11 @@ public final class Constants {
      */
     public static final String PROFILE_ATHENA = "athena";
 
+    /**
+     * The name of the Spring profile used for Hyperion functionality.
+     */
+    public static final String PROFILE_HYPERION = "hyperion";
+
     /**
      * The name of the Spring profile used for Athena functionality.
      */