Installation & Running

Everything you need to clone, compile, build, and run Storyteller.

Prerequisites

Java: JDK 25 or higher
Build Tool: Apache Maven (mvn)
LLM Backend: An OpenAI-compatible chat server (e.g., LM Studio, Jan.ai, llama-server, or mlx_vlm.server) loaded with an instruct model.

From the project root directory:

cd ~/Assistant
mvn -q package

This compiles the code and generates the runnable fat JAR at target/storyteller-x.x.x-all.jar.

java -jar target/storyteller-x.x.x-all.jar

Storyteller supports native compilation enabling GraalVM shared-arena support for JLine:

mvn -Pnative -DskipTests package`

Run the compiled native executable:

./target/storyteller`

To run directly from compiled class files without packaging a fat JAR:

cd ~/Assistant
mvn -q compile dependency:copy-dependencies
java -cp "target/classes:target/dependency/*" nl.llm.storyteller.cli.AssistantApp