Package 'LLMTranslate'

Title: 'shiny' App for TRAPD/ISPOR Survey Translation with LLMs
Description: A 'shiny' application to automate forward and back survey translation with optional reconciliation using large language models (LLMs). Supports both item-by-item and batch translation modes for optimal performance and context-aware translations. Handles multi-sheet Excel files and supports OpenAI (GPT), Google Gemini, and Anthropic Claude models. Follows the TRAPD (Translation, Review, Adjudication, Pretesting, Documentation) framework and ISPOR (International Society for Pharmacoeconomics and Outcomes Research) recommendations. See Harkness et al. (2010) <doi:10.1002/9780470609927.ch7> and Wild et al. (2005) <doi:10.1111/j.1524-4733.2005.04054.x>.
Authors: Jonas R. Kunst [aut, cre]
Maintainer: Jonas R. Kunst <[email protected]>
License: MIT + file LICENSE
Version: 0.3.0
Built: 2026-05-12 08:18:44 UTC
Source: https://github.com/cran/LLMTranslate

Help Index

LLMTranslate: Shiny App for TRAPD/ISPOR-style Survey Translation with LLMs

Description

LLMTranslate wraps a Shiny application that automates forward translation, optional blind back-translation, and reconciliation (TRAPD/ISPOR workflow) using large language models (OpenAI GPT-4o / GPT-4.1 / o-series; Google Gemini).

Details

The main exported function is run_app(), which launches the UI. All other functions/objects are internal but documented below for clarity.

Launching the app

LLMTranslate::run_app()

Pass arguments through to shiny::runApp(), e.g. host, port, launch.browser.

UI overview (tabs and key inputs/outputs)

  • API Keys & Models:

    • openai_key, gemini_key: read from environment if empty.

    • forward_model, back_model, recon_model: chosen from MODEL_SPEC.

    • forward_temp, back_temp, recon_temp: temperature sliders (ignored for o1/o3).

    • reasoning_effort: only for OpenAI o-series reasoning models.

  • Translation:

    • lang_from, lang_to

    • file: Excel upload (.xlsx/.xls)

    • orig_col: original text column selector

    • forward_prompt, back_prompt, recon_prompt

    • do_back, do_recon, debug

    • Buttons: run, stop; download button appears after completion

    • Outputs: table (DT), debug_log (verbatim)

  • Help: instructions, troubleshooting.

  • Citation: citation text & BibTeX.

  • About: brief description and credits.

Citation

See the Citation tab or citation("LLMTranslate"). Also cite specific LLMs and TRAPD/ISPOR frameworks.

Author(s)

Maintainer: Jonas R. Kunst [email protected]

See Also

run_app()

Examples

if (interactive()) {
  LLMTranslate::run_app()
}

Launch the LLM Survey Translator shiny app

Description

Launch the LLM Survey Translator shiny app

Usage

run_app(...)

Arguments

...

Passed to shiny::runApp.

Value

No return value, called for side effects (launches a shiny app).

Examples

if (interactive()) {
  run_app()
}