This project provides a prototype Kotlin module for AI prompt chaining (promptkt) and an associated JavaFx demonstration UI (promptfx). It is intended primarily for demonstration purposes, and is designed to be primarily used with the OpenAI API ( or a compatible LLM API.

See below for instructions to build and run PromptFx.

PromptFx UI Features

PromptFx has views for testing the OpenAI API and for a number of basic applications.

Model View

The GUI initially presents the model view, as shown below. Clicking Run will retrieve a list of models and is a good way to ensure the application is able to access the OpenAI API. To set the API key, you may click on the key in the toolbar. Alternately, you may save your key in an apikey.txt file, or in a system registry variable OPENAI_API_KEY.


OpenAI API Views

The OpenAI API tab contains a number of views designed for exercising the OpenAI API, including completions/, chat/, images/, embeddings/, audio/, and more. These are similar to the API playground at, and should be self-explanatory.


PromptFx has limited support for OpenAI’s audio/ and images/ endpoints.


Text Application Views

The Text and Fun tabs contains a number of use cases designed for different LLM applications or testing. Many of these are similar to the examples described at These views are designed primarily for experimentation with LLMs, so may vary in terms of feature sets and quality.


Document Question Answering

The Document Q&A tab is a prototype view that lets you “ask questions” of a folder of local documents on your system, using OpenAI’s Ada embedding model to retrieve relevant document chunks, and using context-augmented prompting to answer questions. In the view below, a question is being asked based on the content of the Python Software Foundation website.


To customize the documents used, select the Open Folder button and browse to a folder on your local system. Add documents (.txt, .pdf, .doc, or .docx) to this folder, and when you ask a question PromptFx will automatically pull text from the PDF/DOC files, chunk the text into sections, calculate embeddings, lookup relevant chunks based on your question, and use OpenAI’s API to formulate a suitable response. The prompt is also designed to provide a reference to the source document.

In “demonstration mode” (see button on toolbar), PromptFx provides a more elegant interactive mode, additionally rendering PDF thumbnails for source documents.


Integration Views

The Integration tab contains a few experimental demonstrations that integrate with external APIs. Many of these use a prompt chaining approach that may involve a series of steps to answer a question.

PromptKt Library Features

The PromptKt library provides a number of features for working with LLM APIs, including:

  • document chunking tools
  • a local embedding (vector) database
  • command-line chat tools
  • support for AI pipelines (chaining prompts and/or APIs together)
  • configurable prompt templates with mustache support
  • a basic tool chain execution service

Many of these features resemble features of LangChcain.

Building PromptKt and PromptFx

System requirements:

  • Maven version 3.9.3+
  • Java version 17+

OpenAI Client Library:

TornadoFx library (required before you can build promptfx):

  • PromptFx uses a version of tornadofx that is not available on maven central.
  • Clone the repo
  • Checkout out the jdk11-fx18-kotlin16 branch.
  • Run mvn clean install to install the tornadofx library in your local maven repository.

To build the project:

  • Run mvn clean install -DskipTests from the promptkt directory.
  • Run mvn clean install -DskipTests from the promptfx directory.

Note that you can run tests as part of the build, but many of these require an apikey.txt file and use the OpenAI API. We anticipate migrating these to a separate profile and making them available as optional integration tests.

Running PromptFx

To run the project (after compilation):

  • Run java -jar target/promptfx-0.1.0-SNAPSHOT-jar-with-dependencies.jar from the promptfx directory.


View Github