polyglot-gpu 1.0.2__tar.gz

polyglot_gpu-1.0.2/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: "/"
+    schedule:
+      interval: monthly
+    groups:
+      all-deps:
+        patterns: ["*"]
+    open-pull-requests-limit: 3

polyglot_gpu-1.0.2/.github/workflows/ci.yml

@@ -0,0 +1,45 @@
+name: CI
+
+on:
+  push:
+    paths:
+      - "src/**"
+      - "tests/**"
+      - "pyproject.toml"
+      - ".github/workflows/**"
+  pull_request:
+    paths:
+      - "src/**"
+      - "tests/**"
+      - "pyproject.toml"
+      - ".github/workflows/**"
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e . pytest pytest-asyncio pytest-cov
+      - run: pytest tests/ -v --cov=pypolyglot --cov-report=xml
+      - name: Upload coverage
+        if: matrix.python-version == '3.12'
+        uses: codecov/codecov-action@v4
+        with:
+          files: coverage.xml
+          fail_ci_if_error: false
+      - name: Dependency audit
+        if: matrix.python-version == '3.12'
+        run: |
+          pip install pip-audit
+          pip-audit --skip-editable

polyglot_gpu-1.0.2/.github/workflows/pages.yml

@@ -0,0 +1,50 @@
+name: Deploy site to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'site/**'
+      - '.github/workflows/pages.yml'
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Install site dependencies
+        working-directory: site
+        run: npm ci
+
+      - name: Build site
+        working-directory: site
+        run: npm run build
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site/dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

polyglot_gpu-1.0.2/.github/workflows/publish.yml

@@ -0,0 +1,20 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install hatchling build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

polyglot_gpu-1.0.2/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+*.egg
+.polyglot-cache.json
+site/.astro/
+site/dist/
+site/node_modules/

polyglot_gpu-1.0.2/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+## 1.0.2 (2026-03-06)
+
+- Renamed PyPI distribution from `py-polyglot` to `polyglot-gpu` (import name `pypolyglot` unchanged)
+- CLI entry point renamed to `polyglot-gpu`
+
+## 1.0.1 (2026-03-06)
+
+- Shipcheck compliance: verify script, dependency audit, dependabot
+- Landing page via @mcptoolshop/site-theme
+- Translated READMEs (7 languages)
+
+## 1.0.0 (2026-03-06)
+
+- Initial release — Python port of polyglot-mcp
+- 57 languages via TranslateGemma + Ollama
+- Dual-use: Python library (`pip install polyglot-gpu`) + MCP server
+- Core translation with chunking, batching, retry, and validation
+- Markdown-aware translation preserving code blocks, tables, HTML
+- Multi-language orchestrator with concurrent translation
+- Segment-level caching with fuzzy matching (translation memory)
+- Software glossary for accurate technical translations
+- Auto-start Ollama and auto-pull models
+- GPU-safe concurrency control via semaphore

polyglot_gpu-1.0.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mcp-tool-shop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

polyglot_gpu-1.0.2/Makefile

@@ -0,0 +1,13 @@
+.PHONY: verify test build clean
+
+verify: test build
+	@echo "All checks passed."
+
+test:
+	python -m pytest tests/ -v
+
+build:
+	python -m build
+
+clean:
+	rm -rf dist/ build/ *.egg-info src/*.egg-info

polyglot_gpu-1.0.2/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: polyglot-gpu
+Version: 1.0.2
+Summary: Local GPU translation Python library + MCP server — TranslateGemma via Ollama, 57 languages, zero cloud dependency
+Project-URL: Homepage, https://github.com/mcp-tool-shop-org/py-polyglot
+Project-URL: Repository, https://github.com/mcp-tool-shop-org/py-polyglot
+Project-URL: Issues, https://github.com/mcp-tool-shop-org/py-polyglot/issues
+Author-email: mcp-tool-shop <64996768+mcp-tool-shop@users.noreply.github.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: gpu,mcp,ollama,polyglot,translategemma,translation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Text Processing :: Linguistic
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: mcp[cli]>=1.26.0
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/polyglot-mcp/readme.png" alt="py-polyglot" width="400">
+</p>
+
+<p align="center"><strong>Local GPU translation Python library + MCP server — TranslateGemma via Ollama, 57 languages, zero cloud dependency.</strong></p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/py-polyglot/actions"><img src="https://github.com/mcp-tool-shop-org/py-polyglot/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://codecov.io/gh/mcp-tool-shop-org/py-polyglot"><img src="https://codecov.io/gh/mcp-tool-shop-org/py-polyglot/branch/main/graph/badge.svg" alt="Codecov"></a>
+  <a href="https://pypi.org/project/polyglot-gpu/"><img src="https://img.shields.io/pypi/v/polyglot-gpu" alt="PyPI"></a>
+  <a href="https://pypi.org/project/polyglot-gpu/"><img src="https://img.shields.io/pypi/pyversions/polyglot-gpu" alt="Python"></a>
+  <a href="https://github.com/mcp-tool-shop-org/py-polyglot/blob/main/LICENSE"><img src="https://img.shields.io/github/license/mcp-tool-shop-org/py-polyglot" alt="License"></a>
+  <a href="https://mcp-tool-shop-org.github.io/py-polyglot/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
+</p>
+
+---
+
+Python port of [polyglot-mcp](https://github.com/mcp-tool-shop-org/polyglot-mcp). Use as a **pip-installable library** for your Python projects or as an **MCP server** for Claude Code, Claude Desktop, and other MCP clients.
+
+## Features
+
+- **57 languages** — TranslateGemma via Ollama, running 100% locally on your GPU
+- **Zero cloud dependency** — no API keys, no internet required after model download
+- **Dual-use** — Python library API + MCP server in one package
+- **Markdown-aware** — preserves code blocks, tables, HTML, URLs, badges
+- **Smart caching** — segment-level cache with fuzzy matching (translation memory)
+- **Software glossary** — 12 built-in tech terms for accurate translations
+- **Auto-everything** — auto-starts Ollama, auto-pulls models on first use
+- **GPU-safe** — semaphore-controlled concurrency prevents VRAM overload
+
+## Requirements
+
+- Python >= 3.10
+- [Ollama](https://ollama.com) installed locally
+- GPU with sufficient VRAM for your chosen model:
+  - `translategemma:4b` — 3.3 GB (fast, good quality)
+  - `translategemma:12b` — 8.1 GB (balanced, recommended)
+  - `translategemma:27b` — 17 GB (slow, best quality)
+
+## Install
+
+```bash
+pip install polyglot-gpu
+```
+
+## Library Usage
+
+```python
+import asyncio
+from pypolyglot import translate, translate_markdown, translate_all
+
+async def main():
+    # Simple translation
+    result = await translate("Hello world", "en", "ja")
+    print(result.translation)  # こんにちは世界
+
+    # Markdown translation (preserves structure)
+    md = "## Features\n\nLocal GPU translation with **zero cloud dependency**."
+    result = await translate_markdown(md, "en", "fr")
+    print(result.markdown)
+
+    # Multi-language (7 languages at once)
+    result = await translate_all(md, source_lang="en")
+    for r in result.results:
+        print(f"{r.name}: {r.status}")
+
+asyncio.run(main())
+```
+
+### Options
+
+```python
+from pypolyglot import translate, TranslateOptions, GlossaryEntry
+
+# Custom model
+result = await translate("Hello", "en", "ja",
+    TranslateOptions(model="translategemma:4b"))
+
+# Custom glossary
+result = await translate("Deploy the Widget", "en", "ja",
+    TranslateOptions(glossary=[
+        GlossaryEntry("Widget", {"ja": "ウィジェット"})
+    ]))
+
+# Streaming
+result = await translate("Hello world", "en", "ja",
+    TranslateOptions(on_token=lambda t: print(t, end="")))
+```
+
+## MCP Server Usage
+
+### Claude Code
+
+```json
+{
+  "mcpServers": {
+    "polyglot-gpu": {
+      "command": "polyglot-gpu"
+    }
+  }
+}
+```
+
+Or run directly:
+
+```bash
+python -m pypolyglot
+```
+
+### MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `translate_text` | Translate text between any of 57 languages |
+| `translate_md` | Translate markdown while preserving structure |
+| `translate_all_langs` | Translate into multiple languages at once |
+| `list_languages` | List all 57 supported languages |
+| `check_status` | Check Ollama + model availability |
+
+## Architecture
+
+```
+MCP Client (Claude Code, etc.)
+      │ MCP protocol (stdio)
+      ▼
+┌──────────────────┐
+│   server.py      │  5 MCP tools (FastMCP)
+├──────────────────┤
+│  translate.py    │  Chunking, batching, streaming
+│  markdown.py     │  Markdown segmentation
+│  translate_all   │  Multi-language orchestrator
+│  semaphore.py    │  GPU-safe concurrency
+│  validate.py     │  Output validation
+├──────────────────┤
+│   ollama.py      │  httpx client → localhost:11434
+│   cache.py       │  Segment cache + fuzzy memory
+│  glossary.py     │  Software term dictionary
+│ languages.py     │  57 language definitions
+│   polish.py      │  Post-translation cleanup
+│   errors.py      │  Structured error class
+└──────────────────┘
+      │ HTTP (httpx)
+      ▼
+   Ollama + TranslateGemma (GPU)
+```
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `POLYGLOT_MODEL` | `translategemma:12b` | Default Ollama model |
+| `POLYGLOT_CONCURRENCY` | `1` | Max concurrent Ollama calls |
+
+## Security
+
+- All translation runs locally — zero data leaves your machine
+- No telemetry, no API keys, no cloud dependency
+- See [SECURITY.md](SECURITY.md) for threat model
+
+## License
+
+MIT
+
+---
+
+Built by <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>

polyglot_gpu-1.0.2/README.es.md

@@ -0,0 +1,169 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.md">English</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/polyglot-mcp/readme.png" alt="py-polyglot" width="400">
+</p>
+
+<p align="center"><strong>Biblioteca de traducción local para GPU en Python + servidor MCP — TraduceGemma a través de Ollama, 57 idiomas, sin dependencia de la nube.</strong></p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/py-polyglot/actions"><img src="https://github.com/mcp-tool-shop-org/py-polyglot/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://pypi.org/project/polyglot-gpu/"><img src="https://img.shields.io/pypi/v/polyglot-gpu" alt="PyPI"></a>
+  <a href="https://pypi.org/project/polyglot-gpu/"><img src="https://img.shields.io/pypi/pyversions/polyglot-gpu" alt="Python"></a>
+  <a href="https://github.com/mcp-tool-shop-org/py-polyglot/blob/main/LICENSE"><img src="https://img.shields.io/github/license/mcp-tool-shop-org/py-polyglot" alt="License"></a>
+  <a href="https://mcp-tool-shop-org.github.io/py-polyglot/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
+</p>
+
+---
+
+Port de Python de [polyglot-mcp](https://github.com/mcp-tool-shop-org/polyglot-mcp). Úsalo como una **biblioteca instalable con pip** para tus proyectos de Python o como un **servidor MCP** para Claude Code, Claude Desktop y otros clientes MCP.
+
+## Características
+
+- **57 idiomas** — TraduceGemma a través de Ollama, ejecutándose completamente localmente en tu GPU.
+- **Cero dependencia de la nube** — no requiere claves de API, ni conexión a internet después de la descarga del modelo.
+- **Uso dual** — API de biblioteca de Python + servidor MCP en un solo paquete.
+- **Compatible con Markdown** — conserva bloques de código, tablas, HTML, URLs, insignias.
+- **Caché inteligente** — caché a nivel de segmento con coincidencia difusa (memoria de traducción).
+- **Glosario de software** — 12 términos técnicos integrados para traducciones precisas.
+- **Automatización total** — inicia automáticamente Ollama, descarga automáticamente los modelos en la primera ejecución.
+- **Seguro para GPU** — la concurrencia controlada por semáforo evita la sobrecarga de VRAM.
+
+## Requisitos
+
+- Python >= 3.10
+- [Ollama](https://ollama.com) instalado localmente
+- GPU con suficiente VRAM para el modelo elegido:
+- `translategemma:4b` — 3.3 GB (rápido, buena calidad)
+- `translategemma:12b` — 8.1 GB (equilibrado, recomendado)
+- `translategemma:27b` — 17 GB (lento, mejor calidad)
+
+## Instalación
+
+```bash
+pip install polyglot-gpu
+```
+
+## Uso de la biblioteca
+
+```python
+import asyncio
+from pypolyglot import translate, translate_markdown, translate_all
+
+async def main():
+    # Simple translation
+    result = await translate("Hello world", "en", "ja")
+    print(result.translation)  # こんにちは世界
+
+    # Markdown translation (preserves structure)
+    md = "## Features\n\nLocal GPU translation with **zero cloud dependency**."
+    result = await translate_markdown(md, "en", "fr")
+    print(result.markdown)
+
+    # Multi-language (7 languages at once)
+    result = await translate_all(md, source_lang="en")
+    for r in result.results:
+        print(f"{r.name}: {r.status}")
+
+asyncio.run(main())
+```
+
+### Opciones
+
+```python
+from pypolyglot import translate, TranslateOptions, GlossaryEntry
+
+# Custom model
+result = await translate("Hello", "en", "ja",
+    TranslateOptions(model="translategemma:4b"))
+
+# Custom glossary
+result = await translate("Deploy the Widget", "en", "ja",
+    TranslateOptions(glossary=[
+        GlossaryEntry("Widget", {"ja": "ウィジェット"})
+    ]))
+
+# Streaming
+result = await translate("Hello world", "en", "ja",
+    TranslateOptions(on_token=lambda t: print(t, end="")))
+```
+
+## Uso del servidor MCP
+
+### Claude Code
+
+```json
+{
+  "mcpServers": {
+    "polyglot-gpu": {
+      "command": "polyglot-gpu"
+    }
+  }
+}
+```
+
+O ejecútalo directamente:
+
+```bash
+python -m pypolyglot
+```
+
+### Herramientas MCP
+
+| Herramienta | Descripción |
+|------|-------------|
+| `translate_text` | Traduce texto entre cualquiera de los 57 idiomas. |
+| `translate_md` | Traduce Markdown conservando la estructura. |
+| `translate_all_langs` | Traduce a múltiples idiomas a la vez. |
+| `list_languages` | Lista todos los 57 idiomas soportados. |
+| `check_status` | Verifica la disponibilidad de Ollama y el modelo. |
+
+## Arquitectura
+
+```
+MCP Client (Claude Code, etc.)
+      │ MCP protocol (stdio)
+      ▼
+┌──────────────────┐
+│   server.py      │  5 MCP tools (FastMCP)
+├──────────────────┤
+│  translate.py    │  Chunking, batching, streaming
+│  markdown.py     │  Markdown segmentation
+│  translate_all   │  Multi-language orchestrator
+│  semaphore.py    │  GPU-safe concurrency
+│  validate.py     │  Output validation
+├──────────────────┤
+│   ollama.py      │  httpx client → localhost:11434
+│   cache.py       │  Segment cache + fuzzy memory
+│  glossary.py     │  Software term dictionary
+│ languages.py     │  57 language definitions
+│   polish.py      │  Post-translation cleanup
+│   errors.py      │  Structured error class
+└──────────────────┘
+      │ HTTP (httpx)
+      ▼
+   Ollama + TranslateGemma (GPU)
+```
+
+## Variables de entorno
+
+| Variable | Valor predeterminado | Descripción |
+|----------|---------|-------------|
+| `POLYGLOT_MODEL` | `translategemma:12b` | Modelo Ollama predeterminado |
+| `POLYGLOT_CONCURRENCY` | `1` | Número máximo de llamadas concurrentes a Ollama |
+
+## Seguridad
+
+- Todas las traducciones se realizan localmente — ningún dato sale de tu máquina.
+- Sin telemetría, sin claves de API, sin dependencia de la nube.
+- Consulta [SECURITY.md](SECURITY.md) para el modelo de amenazas.
+
+## Licencia
+
+MIT
+
+---
+
+Creado por <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>