lingua-proxy 0.1.0__tar.gz

lingua_proxy-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,50 @@
+name: Bug report
+description: Something behaves differently than documented
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please do not paste prompt content you would not publish. In particular,
+        never attach `~/.lingua-proxy/memo.jsonl` — it contains your prompts in
+        plaintext.
+
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened
+      description: What did you expect, and what happened instead?
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: How to reproduce
+      placeholder: |
+        1. Start the proxy with ...
+        2. Send ...
+        3. Observe ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: doctor
+    attributes:
+      label: Output of `lingua-proxy doctor`
+      description: This redacts credentials automatically.
+      render: text
+    validations:
+      required: true
+
+  - type: input
+    id: language
+    attributes:
+      label: Input language
+      placeholder: Korean, Japanese, Arabic, ...
+
+  - type: input
+    id: model
+    attributes:
+      label: Model
+      placeholder: claude-sonnet-4-6

lingua_proxy-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Security vulnerability
+    url: https://github.com/hanyoungYoo/lingua-proxy/security/advisories/new
+    about: Please report security issues privately, not as a public issue.

lingua_proxy-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,26 @@
+name: Feature request
+description: Suggest an improvement
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem would this solve?
+      description: Please describe the situation rather than only the solution.
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: What would you like it to do?
+    validations:
+      required: true
+
+  - type: textarea
+    id: cost
+    attributes:
+      label: Does this affect the cost tradeoff?
+      description: >
+        This project exists to reduce token spend. If your idea changes what a
+        request costs, please say how.

lingua_proxy-0.1.0/.github/ISSUE_TEMPLATE/other.md

@@ -0,0 +1,12 @@
+---
+name: Question or other
+about: Anything that is not a bug report or a feature request
+title: ''
+labels: ''
+assignees: ''
+---
+
+<!--
+Please do not paste prompt content you would not publish, and never attach
+~/.lingua-proxy/memo.jsonl — it contains your prompts in plaintext.
+-->

lingua_proxy-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,57 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install
+        run: uv venv && uv pip install -e ".[dev]"
+
+      - name: Lint
+        run: |
+          uv run ruff check .
+          uv run ruff format --check .
+
+      - name: Test
+        # The suite is fully offline: upstreams are mocked and translation is
+        # stubbed, so CI never needs a credential.
+        run: uv run pytest -q
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - name: Build distributions
+        run: uv build
+      - name: Check metadata
+        run: uvx twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/

lingua_proxy-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,72 @@
+name: Release
+
+# Publishes to PyPI when a version tag is pushed.
+#
+# Authentication uses PyPI Trusted Publishing (OpenID Connect): GitHub proves
+# this workflow's identity directly to PyPI, so there is no API token to
+# create, store, rotate, or leak. Configure it once at
+# https://pypi.org/manage/account/publishing/
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  # Never publish something that does not pass its own tests.
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - run: uv python install ${{ matrix.python-version }}
+      - run: uv venv && uv pip install -e ".[dev]"
+      - run: uv run ruff check .
+      - run: uv run pytest -q
+
+  build:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Verify the tag matches the packaged version
+        # A tag that disagrees with pyproject.toml would publish a release
+        # under the wrong number, which cannot be undone on PyPI.
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: |
+          TAG="${GITHUB_REF_NAME#v}"
+          PKG=$(grep -m1 '^version' pyproject.toml | sed 's/.*"\(.*\)".*/\1/')
+          echo "tag=$TAG packaged=$PKG"
+          test "$TAG" = "$PKG" || { echo "::error::tag $TAG != version $PKG"; exit 1; }
+
+      - run: uv build
+      - run: uvx twine check dist/*
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/lingua-proxy
+    permissions:
+      id-token: write  # required for Trusted Publishing
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

lingua_proxy-0.1.0/.gitignore

@@ -0,0 +1,17 @@
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# never commit local runtime state or private endpoints
+.lingua-proxy/
+*.local.toml
+*.local.json
+tests/fixtures/*.local.json

lingua_proxy-0.1.0/CHANGELOG.md

@@ -0,0 +1,43 @@
+# Changelog
+
+All notable changes to this project are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project uses
+[semantic versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-09-10
+
+First release. Alpha: the interfaces may still change.
+
+### Added
+
+- Translating reverse proxy for the Anthropic Messages API
+  (`POST /v1/messages`) and the OpenAI-compatible chat API
+  (`POST /v1/chat/completions`). Everything else passes through untouched.
+- Offline language detection with `lingua`. English input is a pure passthrough
+  with no added latency and no extra tokens.
+- Technical-content masking, so fenced code, inline code, URLs, file paths,
+  JSON blobs and markup tags survive translation byte for byte.
+- Bidirectional translation memo, in memory and on disk, which keeps resent
+  conversation history byte-stable so the upstream prompt cache keeps hitting.
+- Streaming support. Text blocks are buffered per block and translated; tool
+  calls and reasoning stream through untouched, with keep-alives while a
+  translation is in flight.
+- `wrap` and `unwrap` commands that patch and transactionally restore client
+  settings, chaining onto whatever gateway the client already points at.
+- `doctor`, `dashboard`, and `bench` commands. The benchmark reports savings in
+  dollars and is able to report that a workload does not pay off.
+- `x-lingua-bypass` header to skip translation for a single request.
+
+### Known limitations
+
+- Savings apply to input tokens. Output tokens cost more and are not reduced,
+  so end-to-end savings are lower than the input-token figure.
+- Streaming buffers each text block, so non-English text does not appear word
+  by word.
+- macOS and Linux only.
+- DeepL and LibreTranslate adapters are interface-only.
+
+[Unreleased]: https://github.com/hanyoungYoo/lingua-proxy/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/hanyoungYoo/lingua-proxy/releases/tag/v0.1.0

lingua_proxy-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,116 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+yhanyoung0411@gmail.com. All complaints will be reviewed and investigated
+promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+https://www.contributor-covenant.org/version/2/1/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][mozilla].
+
+[homepage]: https://www.contributor-covenant.org
+[mozilla]: https://github.com/mozilla/diversity

lingua_proxy-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,86 @@
+# Contributing
+
+Thanks for considering a contribution.
+
+## Getting set up
+
+Requires Python 3.12 or newer, and [uv](https://github.com/astral-sh/uv).
+
+```bash
+uv venv && uv pip install -e ".[dev]"
+```
+
+```bash
+uv run pytest
+```
+
+```bash
+uv run ruff check . && uv run ruff format --check .
+```
+
+The whole suite runs offline in a few seconds. No test may reach the network:
+upstreams are mocked with `RecordingTransport` in `tests/conftest.py`, and
+translation is stubbed by `FakeTranslator` so results stay deterministic.
+
+## How this project is built
+
+Tests come first. Every module here was written by adding a failing test that
+describes the behaviour, then the smallest implementation that satisfies it.
+Please keep that shape — a pull request that changes behaviour should change or
+add a test that would fail without it.
+
+Three rules carry most of the design:
+
+1. **Fail open.** Any uncertainty — a translator error, a damaged placeholder,
+   an ambiguous language — must result in the user's original text being
+   forwarded untranslated. A missed saving is a rounding error. A corrupted
+   prompt is not.
+2. **Byte stability.** Text already translated in an earlier turn is reproduced
+   from the memo, never re-translated. Agentic clients resend the whole history
+   each turn, so anything else breaks the upstream prompt cache and costs more
+   than it saves.
+3. **No private endpoints.** The only hard-coded URLs are the public vendor
+   APIs. Everything else is resolved at runtime. `test_no_private_endpoints_committed_in_repo`
+   fails the build if a private host is committed.
+
+## Measuring cost claims
+
+This project exists to make a claim about money, so please do not change the
+documented savings figures by hand. Re-run the benchmark against a real upstream
+and update the recorded fixture:
+
+```bash
+LINGUA_BENCH_BASE_URL=https://your-upstream.example lingua-proxy bench
+```
+
+A test asserts the README quotes the same number as
+`tests/fixtures/bench_recorded.json`, so the two cannot drift apart. Note that
+the benchmark spends real money and refuses to guess an endpoint for you.
+
+## Releasing
+
+Releases are published to PyPI by CI, never from a laptop. The workflow uses
+PyPI Trusted Publishing, so there is no API token to store or rotate.
+
+1. Update the version in `pyproject.toml` and add a section to `CHANGELOG.md`.
+2. Commit, then tag and push:
+
+```bash
+git tag v0.1.0 && git push origin v0.1.0
+```
+
+The release workflow runs the tests, refuses to continue if the tag disagrees
+with the packaged version, builds, and publishes. A version number on PyPI can
+never be reused, which is why the check exists.
+
+## Reporting bugs
+
+Please include the output of `lingua-proxy doctor`, which redacts credentials.
+Never paste a prompt containing anything you would not publish — and note that
+`~/.lingua-proxy/memo.jsonl` contains your prompts in plaintext, so do not
+attach it.
+
+## Areas that need work
+
+See the roadmap in the README. The largest open item is sentence-boundary
+streaming translation, which would remove the per-block buffering caveat.

lingua_proxy-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hanyoung Yoo
+
+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.