explaingit

danterolle/loqi

Analysis updated 2026-05-18

2GoAudience · developerComplexity · 2/5LicenseSetup · moderate

TLDR

A Go command-line tool that translates text, files, and documents locally using Ollama, llama.cpp, or Argos Translate, with no data sent to external services.

Mindmap

mindmap
  root((repo))
    What it does
      Local text translation
      File and doc translation
      No external APIs
    Backends
      Ollama default
      llama.cpp server
      Argos Translate offline
    Usage Modes
      Interactive TUI
      One-shot CLI
      Batch processing
    Tech Stack
      Go
      YAML config
      Python venv
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Translate markdown documents or text files without sending them to Google Translate or DeepL

USE CASE 2

Pipe translated output into other command-line tools as part of a local automation workflow

USE CASE 3

Run a live interactive translation terminal that updates as you type, using a local model

USE CASE 4

Process batches of JSON or text files through local translation in one command

What is it built with?

GoOllamallama.cppPython

How does it compare?

danterolle/loqiiwetan77/flumemtojek/prometheus-instrumentation-in-go
Stars222
LanguageGoGoGo
Last pushed2018-11-04
MaintenanceDormant
Setup difficultymoderatemoderateeasy
Complexity2/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Ollama with a compatible model pulled, or a running llama.cpp server, or Python 3 for the Argos backend.

Apache 2.0: use freely for any purpose including commercial, give credit, and include the license notice.

In plain English

Loqi is a command-line translation tool that runs entirely on your computer, sending no text to Google, DeepL, or any third-party service. You give it text, a file, or piped input, and it translates using a local AI model. The author built it out of a desire to stop sending personal and business documents to external translation services, even those with opt-out settings and privacy policies. The tool supports three different backends. The default is Ollama, which can download and run a language model locally and is the easiest option to start with. The second backend is llama.cpp, which connects to a locally running model server you point at a GGUF model file. The third is Argos Translate, a rule-based translation engine that works fully offline with no GPU, installs itself automatically in a Python environment, and handles straightforward sentences faster than a language model but with less context awareness. There are three ways to use Loqi. Interactive mode opens a terminal interface where you type text and see translations update as you type. One-shot mode runs a single translation from the command line and returns the result, which works well for scripting and piping into other tools. Batch mode processes JSON files, plain text files, or markdown documents. The tool is written in Go and installed with a single go install command or by building from source. Configuration lives in a YAML file, and all settings can be overridden with command-line flags. The translation quality depends on the model you choose, smaller models make mistakes, and the README recommends treating output as a draft to review rather than a finished translation. Loqi is licensed under Apache 2.0.

Copy-paste prompts

Prompt 1
I have Ollama installed with phi4-mini pulled. Walk me through running Loqi to translate a markdown file from Italian to English using one-shot CLI mode.
Prompt 2
How do I configure Loqi to use a llama.cpp server instead of Ollama? I have a GGUF model I want to point it at.
Prompt 3
I want to set up Loqi's Argos backend for fully offline translation with no GPU. What does the setup look like and what are the trade-offs compared to Ollama?
Prompt 4
Show me how to use Loqi in batch mode to translate a JSON file containing multiple strings and how to configure the source and target languages.

Frequently asked questions

What is loqi?

A Go command-line tool that translates text, files, and documents locally using Ollama, llama.cpp, or Argos Translate, with no data sent to external services.

What language is loqi written in?

Mainly Go. The stack also includes Go, Ollama, llama.cpp.

What license does loqi use?

Apache 2.0: use freely for any purpose including commercial, give credit, and include the license notice.

How hard is loqi to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is loqi for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub danterolle on gitmyhub

Verify against the repo before relying on details.