dtrans

A modern command-line translator powered by LLMs.

Note: This is a ground-up rewrite of translate-shell with a focus on LLM-based translation and a significantly improved CLI experience.

Features

• LLM-powered translation via DeepSeek, Gemini, a ChatGPT subscription, or any OpenAI-compatible API
• Verify your translations with alternatives, comparisons, and contextual examples
• Rich terminal UI with beautiful panels, tables, and spinners
• Modern CLI with explicit long-form flags and intuitive language syntax
• Configurable providers via a simple TOML config file

Installation

pipx install dtrans

Or with pip:

pip install dtrans

Quick Start

1. Create your configuration file at ~/.config/dtrans/config.toml:

default_provider = "deepseek"

[providers.deepseek]
api_key = "sk-..."
model = "deepseek-chat"

[providers.openai]
api_key = "sk-..."
model = "gpt-4o"

[providers.gemini]
api_key = "..."
model = "gemini-1.5-flash"

[providers.chatgpt]
provider_type = "chatgpt"
# Optional: omit model to use the Codex default available to your subscription.
# model = "your-codex-model"

To use the chatgpt provider, install the Codex CLI and sign in through its supported browser flow. dtrans delegates authentication and token refresh to Codex and never reads its cached credentials:

dtrans-auth login
dtrans-auth status

# For remote or headless systems
dtrans-auth login --device-auth

2. Translate:

# Auto-detect source, translate to French
dtrans --to fr "Hello, world!"

# Specify source and target
dtrans en:fr "Hello, world!"

# Brief mode (translation text only)
dtrans --brief "Hello, world!"

# Identify language
dtrans --identify "手紙"

Usage

Usage: dtrans [OPTIONS] TEXT

Options:
  --from TEXT       Source language code (e.g. 'en', 'ja'). Omit to auto-detect.
  --to TEXT         Target language code (e.g. 'fr', 'zh'). Defaults to system locale.
  --provider TEXT   Override the default provider from the config file.
  --brief / --verbose
                    Brief mode prints only the translation. Verbose is the default in a TTY.
  --identify        Identify the source language and exit.
  --version         Show version and exit.
  --help            Show this message and exit.

Language Syntax

Custom Providers

Any OpenAI-compatible API can be configured:

[providers.local]
base_url = "http://localhost:11434/v1"
api_key = "ollama"
model = "llama3"

Development

# Clone
git clone https://github.com/kriss-spy/deep-translate-shell.git
cd deep-translate-shell

# Install in editable mode with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Lint
ruff check src tests
mypy src

License

See LICENSE.