README.md
---------
# Gemini Translator
A simple Python wrapper for Google Gemini LLM translations.
## Installation
```bash
pip install gemini-translator
```
## Usage
```python
from gemini_translator.translator import GeminiTranslator
tr = GeminiTranslator(api_key="YOUR_API_KEY")
res = tr.translate(["Hello"], "auto", "ru")
print(res)
Gemini Translator
Gemini Translator — лёгкая Python-библиотека для пакетных переводов с помощью Google Gemini LLM.
Установка
pip install gemini-translator
Быстрый старт
from gemini_translator.translator import GeminiTranslator
# Передача ключа напрямую
translator = GeminiTranslator(api_key="YOUR_GEMINI_API_KEY")
# Или через переменную окружения (рекомендуется)
# export GOOGLE_API_KEY="YOUR_GEMINI_API_KEY"
# translator = GeminiTranslator()
# 1) Перевод одного текста
result = translator.translate(
["Hello, world!"],
source_lang="auto", # автоопределение языка
target_lang="ru" # двухбуквенный код языка
)
print(result["Hello, world!"])
# 2) Пакетный перевод списка строк
texts = ["Good morning", "How are you?"]
translations = translator.translate(
texts,
source_lang="en", # явный код исходного языка
target_lang="fr" # код целевого языка
)
for original, translated in translations.items():
print(f"{original} -> {translated}")
Ключ API Gemini
Для работы с Gemini API необходим API-ключ. Его можно получить в Google Cloud Console:
-
Перейдите в раздел APIs & Services → Credentials.
-
Создайте или выберите существующий API-ключ.
-
Сохраните значение ключа и передайте в библиотеку одним из способов:
- Через параметр
api_keyпри инициализацииGeminiTranslator. - Через переменную окружения
GOOGLE_API_KEY.
- Через параметр
Параметры
api_key: str— ваш Gemini API-ключ. Если не указан, будет использована переменная окруженияGOOGLE_API_KEY.model: str— имя модели Gemini (по умолчаниюgemini-2.0-flash).timeout: int— таймаут HTTP-запроса в секундах (по умолчанию 30).
Примечания
- Коды языков указываются по стандарту ISO 639-1 (двухбуквенные, например,
en,ru,fr). - Если у вас возникает
ValueError: API key must be provided, проверьте корректность передачи ключа.
Metadata
Release files for gemini-translator 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| gemini_translator-0.1.0.tar.gz | 2.9 kB | Without provenance | Details for gemini_translator-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| gemini_translator-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for gemini_translator-0.1.0-py3-none-any.whl |
Total release size: 5.5 kB
Release files / gemini_translator-0.1.0.tar.gz
| Download URL | gemini_translator-0.1.0.tar.gz |
|---|---|
| Size | 2.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
58fbcc553548518d6f83198438cf6f1464797e3387f931641f727d919e5200b8
|
|
BLAKE2b-256 checksum How to use checksums |
48852468144ac1483ee03bbf5b655f306e50e42b4ef0924795092d8d91225a1d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.3
|
Release files / gemini_translator-0.1.0-py3-none-any.whl
| Download URL | gemini_translator-0.1.0-py3-none-any.whl |
|---|---|
| Size | 2.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7f271753c30b8b7014a7edbb99595fca1be1e03509a51ea4f8fbf589b55696c5
|
|
BLAKE2b-256 checksum How to use checksums |
49d7333dc250110740ca62bad591c6888eb9a6149a1c351f7a937755ffdf9d0d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.3
|
Security for gemini-translator 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.