Skip to main content

A Translation Tool for Humans

Project description


Documentation github travis pypi Wheel

A Translation Tool For Humans

Translate Lewis Carroll: Alice in Wonderland <figcaption>

Translate Lewis Carroll: Alice in Wonderland


The end goal is a simple application for translating text in the terminal. Text can be generated interactively or programmatically in the shell environment. Through command line arguments, file descriptors or pipes generating translated output that can be piped to a file or displayed on the terminal.


  • Fast! Translate an entire book in less than 5 seconds.

  • Made for Python 3 but still works on Python 2

  • Fast and easy to install, easy to use

  • Supports translation from any language

  • Highly composable interface, the power of Unix pipes and filters.

  • Simple API and documentation


From PyPI with pip (easy)

$ pip install py-translate

From Source at Github

  • Clone the repository

$ git clone
  • Install with

$ python install


translate [--flags] [source] dest




Destination language code


Source language code



Show this help message and exit

-v, –version

Show program’s version number and exit

-l,–list [code]

Enumerate the name of country and language code pair.

[ Optionally specify output language format ]


Print out the transliteration of the text


Hello World from English to Traditional Chinese

$ translate en zh-TW <<< 'Hello World!'
Hello World <figcaption>

Hello World

  • Just as easily specify a source language by providing it as first argument

# Translate Hello from French to English
$ translate fr en <<< 'Bonjour, comment allez-vous!'
Hello, how are you?

Smart Language Detection

Omitting the source language will try to detect it based on the text content

$ translate fr <<< 'I think therefore I am'
Je pense donc je suis

Romanified Transliteration

$ translate --translit en ko <<< 'Want to fight!'
ssaugo sip-eo!

$ translate --translit en zh-TW <<< 'Kidding, we should be friends'
Kāiwánxiào, wǒmen yīnggāi shì péngyǒu

Redirect from File

$ translate zh-TW < 'alice.txt'




Chaining together Pipes

# Multiple Chaining
$ echo 'What is love?' | translate en zh-TW | translate zh-TW ko | translate ko fr | translate fr en
What is love?

Be Creative!

# Grocery List
$ cat << BUY | translate ko



Here’s a list of Python platforms that are officially supported.

  • Python 3.4

  • Python 3.3

  • Python 3.2

  • Python 2.7

  • Python 2.6

  • PyPy 2 (Latest)

  • PyPy 3 (latest)


Find the latest documentation


  1. Fork us on Github.

  2. Find a bug? Implemented a new feature? Send a pull request to get it merged and published.

  3. Feel free to send an e-mail to the code maintainer for questions or help regarding the codebase.

Release History

1.0.2 (2015-01-02)

  • Happy New Year

  • Created quick benchmarking suite

  • Optimized thread utilization

  • Bug fixes and better IO performance

1.0.1 (2014-12-30)

  • More efficient task processing using map over submit.

  • Seperated IO in coroutine exception blocks.

  • Bug Fixes and Improvements.

1.0.0 (2014-12-18)

  • Bug fix with lines longer than 1000 chars

  • Fixed another unicode bug

  • Improved Python 2/3 Compatability

  • Implemented text transliteration where available

  • Implemented simple File IO

  • Better utilization of thread pools using futures module.

  • Vendorized dependencies

  • Swapped transport API from urllib2 with Requests

  • SSL/TLS integration for secure web requests

0.2.3 (2014-12-08)

  • Bug fix with double output

0.2.2 (2014-12-07)

  • Bug fixes

  • Decreased package size

  • Split into two seperate modules

0.2.1 (2014-12-04)

  • Added Output Buffer Streaming

  • Utilized Cooperative Multitasking for Coroutines

  • Updated Documentation on API

0.2.0 (2014-11-30)

  • Bug fixes

  • Implmented concurrency based on Asyncronous threads and coroutines

  • Up to 10x performance speedup

0.1.6 (2014-11-30)

  • Bug Fixes

  • Re-implmenenting concurrency models

  • Python 3 is now the base implemntation

0.1.5 (2014-07-18)

  • Language Code Generator Fix

0.1.4 (2014-07-05)

  • General Bug Fixes

  • Speed Improvements

  • Length of multibyte characters correctly represented by spooler

  • Better support for utf-8.

0.1.3 (2014-04-07)

  • Implemented language discovery arg

  • Bug Fixes

0.1.2 (2014-04-04)

  • Documentation reorganization

Bug Fixes

  • Fixed unicode encode/decode errors

0.1.1 (2014-04-03)

  • PyPy-c v2.2 now support

Bug Fixes

  • Quick fix PyPI distribution (huge package sizes)

  • now does it job

  • Assorted fixes with methods and scope

0.1.0 (2014-04-02)

  • GTranslate is taken on PyPI.

  • Name changed to py-translate

  • Distributed through PyPI and Wheel

  • More documentation and autoparsing for module functions

  • Separated into logical modules in a package rather than one executable

0.0.0 (2014-03-31)

  • Support for Python 2.7 and 3.x

  • Sphinx Documentation hosted

  • Travis CI build passed!

  • Source released on Github

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

py-translate-1.0.3.tar.gz (58.9 kB view hashes)

Uploaded source

Built Distribution

py_translate-1.0.3-py2.py3-none-any.whl (61.3 kB view hashes)

Uploaded 3 4

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page