added examples project

Author: dzlab

llm4j-examples/pom.xml

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+  <modelVersion>4.0.0</modelVersion>
+
+  <parent>
+    <groupId>org.llm4j</groupId>
+    <artifactId>llm4j-parent</artifactId>
+    <version>1.0-SNAPSHOT</version>
+    <relativePath>../parent-pom.xml</relativePath>
+  </parent>
+
+  <artifactId>llm4j-examples</artifactId>
+
+  <packaging>jar</packaging>
+  <name>LLM4J Examples Module</name>
+  <description>Examples showcasing how to LLM4J to query LLMs</description>
+
+  <url>http://github.com/dzlab</url>
+
+  <properties>
+    <module-name>org.llm4j.examples</module-name>
+  </properties>
+
+  <dependencies>
+    <dependency>
+      <groupId>org.llm4j</groupId>
+      <artifactId>llm4j-api</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.llm4j</groupId>
+      <artifactId>llm4j-huggingface</artifactId>
+    </dependency>
+
+  </dependencies>
+
+
+</project>

llm4j-examples/src/main/java/org/llm4j/examples/HFApp.java

@@ -0,0 +1,20 @@
+package org.llm4j.examples;
+
+import org.apache.commons.configuration2.Configuration;
+import org.apache.commons.configuration2.builder.fluent.Configurations;
+import org.apache.commons.configuration2.ex.ConfigurationException;
+import org.llm4j.api.LLM4J;
+import org.llm4j.huggingface.HFLanguageModel;
+
+public class HFApp {
+
+    public static void main(String[] args) throws ConfigurationException {
+        Configuration config = new Configurations().properties("llm4j.properties");
+
+        HFLanguageModel.Builder factory = new HFLanguageModel.Builder();
+        HFLanguageModel llm = (HFLanguageModel) LLM4J.getLanguageModel(config, factory);
+
+        String answer = llm.process("In what country is Andalossia?");
+        System.out.println(answer);
+    }
+}

llm4j-examples/src/main/java/org/llm4j/examples/LLMApp.java

@@ -0,0 +1,19 @@
+package org.llm4j.examples;
+
+import org.apache.commons.configuration2.Configuration;
+import org.apache.commons.configuration2.builder.fluent.Configurations;
+import org.apache.commons.configuration2.ex.ConfigurationException;
+import org.llm4j.api.LLM4J;
+import org.llm4j.api.LanguageModel;
+
+public class LLMApp {
+
+    public static void main(String[] args) throws ConfigurationException {
+        Configuration config = new Configurations().properties("llm4j.properties");
+
+        LanguageModel llm = LLM4J.getLanguageModel(config);
+
+        String answer = llm.process("In what country is Andalossia?");
+        System.out.println(answer);
+    }
+}

llm4j-examples/src/main/resources/META-INF/services/org.llm4j.spi.LLM4JServiceProvider

@@ -0,0 +1 @@
+org.llm4j.huggingface.HFServiceProvider

llm4j-examples/src/main/resources/llm4j.properties

@@ -0,0 +1,19 @@
+hf.waitForModel=false
+hf.useCache=true
+
+# Set API key using env variable or use actual value
+hf.apiKey=${env:HF_API_KEY}
+
+modelId=tiiuae/falcon-7b-instruct
+# timeout in milliseconds
+timeout=10000
+
+topK=3
+topP=0.4
+temperature=0.7
+repetitionPenalty=0.9
+maxNewTokens=256
+maxTime=11
+returnFullText=false
+numReturnSequences=2
+doSample=false

llm4j-huggingface/src/test/java/org/llm4j/huggingface/HFLanguageModelTest.java

@@ -17,7 +17,6 @@ public class HFLanguageModelTest {
     public void should_send_messages_and_receive_response() throws ConfigurationException {
 
         Configuration config = new Configurations().properties("llm4j.properties");
-        Configuration envConfig = new EnvironmentConfiguration();
 
         LanguageModel llm = new HFLanguageModel.Builder()
                 .getLanguageModel(config);

pom.xml

@@ -15,6 +15,7 @@
   <modules>
     <module>parent-pom.xml</module>
     <module>llm4j-api</module>
+    <module>llm4j-examples</module>
     <module>llm4j-huggingface</module>
   </modules>