loqalkit 1.6.2__tar.gz

loqalkit-1.6.2/.gitattributes

@@ -0,0 +1 @@
+XCFrameworks/** filter=lfs diff=lfs merge=lfs -text

loqalkit-1.6.2/.github/workflows/publish.yml

@@ -0,0 +1,85 @@
+name: publish
+
+# Publish the Python package to PyPI when a version tag appears.
+#
+# tag-release.yml creates v<version> whenever pyproject.toml's version changes
+# on main, so the full chain is: bump the version in a PR -> merge -> tag is
+# created -> this workflow publishes it. No hand-cut tags, no manual upload.
+#
+# Authentication is PyPI Trusted Publishing (OIDC). There is no API token to
+# store or rotate — GitHub mints a short-lived identity for this specific
+# workflow in this specific repo, and PyPI verifies it. That is why nothing
+# here reads `secrets`.
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - run: pip install build
+
+      - run: python -m build
+
+      - name: Check the built version matches the tag
+        if: startsWith(github.ref, 'refs/tags/')
+        run: |
+          # Guards the failure mode that motivated this workflow: a tag cut by
+          # hand without bumping pyproject.toml. The package then reports a
+          # version that no pin can ever satisfy, and anything comparing the
+          # pinned tag against installed metadata reinstalls forever without
+          # converging. Refuse to publish that.
+          tag="${GITHUB_REF#refs/tags/v}"
+          built=$(python -c "
+          import pathlib, re
+          names = [p.name for p in pathlib.Path('dist').glob('*.whl')]
+          print(re.match(r'loqalkit-([^-]+)-', names[0]).group(1))
+          ")
+          echo "tag=$tag built=$built"
+          if [ "$tag" != "$built" ]; then
+            echo "::error::Tag v$tag does not match built version $built."
+            echo "::error::Bump version in pyproject.toml rather than tagging by hand."
+            exit 1
+          fi
+
+      - name: Check the VAD model shipped in the wheel
+        run: |
+          # hatchling includes .py by default but not data files; the artifacts
+          # config in pyproject.toml is what pulls this in. Without it the vad
+          # extra installs onnxruntime and then fails at runtime on a missing
+          # model, which is a far worse way to find out.
+          python - <<'PY'
+          import pathlib, sys, zipfile
+          whl = next(pathlib.Path("dist").glob("*.whl"))
+          names = zipfile.ZipFile(whl).namelist()
+          if "loqalkit/data/silero_vad.onnx" not in names:
+              sys.exit(f"silero_vad.onnx missing from {whl.name}")
+          print(f"OK — VAD model present in {whl.name}")
+          PY
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write # required for Trusted Publishing; do not remove
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

loqalkit-1.6.2/.github/workflows/tag-release.yml

@@ -0,0 +1,34 @@
+name: tag-release
+
+# Auto-create the git tag v<version> whenever the version in pyproject.toml
+# changes on main. The version in pyproject.toml is the single source of truth;
+# LoqalKitServer installs core by this tag (git+...@vX.Y.Z), so the tag must
+# exist before its Docker build runs. Bump the version in a PR, merge, and the
+# matching tag appears automatically — no hand-cut tags.
+
+on:
+  push:
+    branches: [main]
+    paths: ["pyproject.toml"]
+
+jobs:
+  tag:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - id: v
+        run: echo "version=$(grep -m1 '^version' pyproject.toml | cut -d'"' -f2)" >> "$GITHUB_OUTPUT"
+      - name: Create tag if missing
+        run: |
+          tag="v${{ steps.v.outputs.version }}"
+          if git rev-parse "$tag" >/dev/null 2>&1; then
+            echo "$tag already exists — nothing to do"
+          else
+            git tag "$tag"
+            git push origin "$tag"
+            echo "created and pushed $tag"
+          fi

loqalkit-1.6.2/.gitignore

@@ -0,0 +1,23 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+.env
+.claude-tmp/
+.DS_Store
+
+# Swift Package Manager
+.build/
+.swiftpm/
+
+# Android / Gradle
+.gradle/
+local.properties
+*.iml
+.idea/
+.claude/settings.local.json

loqalkit-1.6.2/CLAUDE.md

@@ -0,0 +1,53 @@
+# LoqalKit
+
+Unified language SDK — detection, transcription, romanization, translation, TTS routing.
+
+**Repo:** `SoratoGroup/loqalkit`
+
+## Structure
+
+```
+LoqalKit/
+├── loqalkit/               # Python package
+│   ├── __init__.py          # Re-exports all public symbols
+│   ├── bilingual.py         # [[Marker]] segment parsing
+│   ├── canonical.py         # Language-tag canonicalization (includes legacy codes)
+│   ├── codes.py             # BCP-47 normalization
+│   ├── detect.py            # Text + audio language detection
+│   ├── disambiguate.py      # LLM disambiguation for confusable families
+│   ├── prompts.py           # ASR language prompts
+│   ├── registry.py          # Per-language metadata (languages.json)
+│   ├── romanize.py          # Romanization (batch + segment-aware)
+│   ├── script_info.py       # Latin vs non-Latin script classification
+│   ├── segmentation.py      # Long-segment splitting
+│   ├── speakers.py          # Speaker extraction
+│   ├── transcribe.py        # ASR via gpt-4o-transcribe
+│   ├── translate.py         # JSON/text translation
+│   ├── vocalize.py          # Niqqud/harakat vowel marks
+│   ├── languages.json       # Language metadata
+│   └── _client.py           # OpenAI client accessor (dual-path)
+├── tests/
+├── pyproject.toml
+└── CLAUDE.md
+```
+
+## Dev
+
+```bash
+pip install -e .
+pytest tests/ -v
+```
+
+**Server:** The FastAPI server has been extracted to its own repository. See `LoqalKitServer/` (`SoratoGroup/loqalkitserver`).
+
+## Consumers
+
+- **ManabuDashboard** — `pip install loqalkit` (direct import)
+- **ManabuAgent** — `pip install loqalkit` (direct import + async APIs)
+- **ManabuApple** — Swift package (LoqalKitSwift, future)
+- **ManabuAndroid** — Kotlin library (LoqalKitAndroid, future)
+
+## Architecture
+
+- **LoqalKit Server** (CPU, Vultr) — all language APIs, TTS routing. Extracted to `LoqalKitServer/` (`SoratoGroup/loqalkitserver`).
+- **LoqalKit GPU Worker** (RunPod) — Piper synthesis, MMS-LID, voice cloning

loqalkit-1.6.2/Dockerfile

@@ -0,0 +1,18 @@
+FROM python:3.12-slim
+
+WORKDIR /app
+
+# Copy only dependency metadata first for layer caching
+COPY pyproject.toml ./
+
+# Copy full source, then install in one layer
+COPY . .
+RUN pip install --no-cache-dir '.[serve]'
+
+EXPOSE 8100
+
+# Runtime env vars (must be provided by Dokploy):
+#   MANABU_APP_SECRET   �� shared secret for X-App-Secret auth
+#   OPENAI_API_KEY      — or proxy URL via MANABU_PROXY_BASE_URL
+
+CMD ["uvicorn", "loqalkit.server.app:app", "--host", "0.0.0.0", "--port", "8100"]

loqalkit-1.6.2/LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2026 Sorato Group. All rights reserved.
+
+LoqalKit is proprietary software.
+
+Permission is granted to download, install, and use this package solely for the
+purpose of accessing the Loqal platform through a valid subscription or API key
+issued by Sorato Group, subject to the applicable terms of service.
+
+You may not redistribute, sublicense, sell, or publish this software or any
+derivative of it, and you may not modify, reverse engineer, decompile, or
+disassemble it, except to the extent that such restriction is prohibited by
+applicable law.
+
+Third-party components redistributed with this package are licensed separately
+and are listed in THIRD_PARTY_NOTICES.md. Nothing in this license limits your
+rights under those licenses with respect to those components.
+
+THIS 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.

loqalkit-1.6.2/LoqalKitAndroid/build.gradle.kts

@@ -0,0 +1,48 @@
+plugins {
+    id("com.android.library") version "8.9.1"
+    id("org.jetbrains.kotlin.android") version "2.1.0"
+    id("org.jetbrains.kotlin.plugin.serialization") version "2.1.0"
+    id("maven-publish")
+}
+
+group = "com.sorato"
+version = "1.0.0"
+
+android {
+    namespace = "com.sorato.loqalkit"
+    compileSdk = 36
+    defaultConfig { minSdk = 26 }
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_17
+        targetCompatibility = JavaVersion.VERSION_17
+    }
+    kotlinOptions { jvmTarget = "17" }
+}
+
+dependencies {
+    implementation("com.squareup.okhttp3:okhttp:4.12.0")
+    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.9.0")
+    implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3")
+    implementation("androidx.core:core-ktx:1.15.0")
+
+    // On-device TTS: Piper via sherpa-onnx + OpenVoice via ONNX Runtime
+    implementation("com.github.k2-fsa:sherpa-onnx:1.12.34")
+    implementation("com.microsoft.onnxruntime:onnxruntime-android:1.23.2")
+
+    // Japanese morphological analysis for furigana
+    implementation("com.atilika.kuromoji:kuromoji-ipadic:0.9.0")
+
+    testImplementation("org.jetbrains.kotlin:kotlin-test")
+    testImplementation("org.jetbrains.kotlin:kotlin-test-junit")
+}
+
+publishing {
+    publications {
+        register<MavenPublication>("release") {
+            afterEvaluate {
+                from(components["release"])
+            }
+            artifactId = "loqalkit"
+        }
+    }
+}

loqalkit-1.6.2/LoqalKitAndroid/gradle/libs.versions.toml

@@ -0,0 +1,146 @@
+[versions]
+agp = "8.9.1"
+kotlin = "2.1.0"
+ksp = "2.1.0-1.0.29"
+compose-bom = "2025.01.01"
+hilt = "2.54"
+navigation = "2.8.5"
+serialization = "1.7.3"
+coroutines = "1.9.0"
+retrofit = "2.11.0"
+okhttp = "4.12.0"
+supabase = "3.1.4"
+ktor = "3.0.3"
+livekit = "2.23.5"
+media3 = "1.5.1"
+billing = "7.1.1"
+coil = "3.0.4"
+maps-compose = "6.4.1"
+lifecycle = "2.8.7"
+activity-compose = "1.9.3"
+core-ktx = "1.15.0"
+datastore = "1.1.1"
+work = "2.10.0"
+facebook = "17.0.2"
+junit = "4.13.2"
+
+[libraries]
+# Compose
+compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "compose-bom" }
+compose-ui = { group = "androidx.compose.ui", name = "ui" }
+compose-ui-graphics = { group = "androidx.compose.ui", name = "ui-graphics" }
+compose-ui-tooling = { group = "androidx.compose.ui", name = "ui-tooling" }
+compose-ui-tooling-preview = { group = "androidx.compose.ui", name = "ui-tooling-preview" }
+compose-material3 = { group = "androidx.compose.material3", name = "material3" }
+compose-material-icons = { group = "androidx.compose.material", name = "material-icons-extended" }
+compose-animation = { group = "androidx.compose.animation", name = "animation" }
+
+# AndroidX
+activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activity-compose" }
+core-ktx = { group = "androidx.core", name = "core-ktx", version.ref = "core-ktx" }
+lifecycle-runtime = { group = "androidx.lifecycle", name = "lifecycle-runtime-compose", version.ref = "lifecycle" }
+lifecycle-viewmodel = { group = "androidx.lifecycle", name = "lifecycle-viewmodel-compose", version.ref = "lifecycle" }
+
+# DataStore
+datastore-preferences = { group = "androidx.datastore", name = "datastore-preferences", version.ref = "datastore" }
+
+# Navigation
+navigation-compose = { group = "androidx.navigation", name = "navigation-compose", version.ref = "navigation" }
+
+# Hilt
+hilt-android = { group = "com.google.dagger", name = "hilt-android", version.ref = "hilt" }
+hilt-compiler = { group = "com.google.dagger", name = "hilt-compiler", version.ref = "hilt" }
+hilt-navigation-compose = { group = "androidx.hilt", name = "hilt-navigation-compose", version = "1.2.0" }
+
+# Serialization
+serialization-json = { group = "org.jetbrains.kotlinx", name = "kotlinx-serialization-json", version.ref = "serialization" }
+
+# Coroutines
+coroutines-android = { group = "org.jetbrains.kotlinx", name = "kotlinx-coroutines-android", version.ref = "coroutines" }
+coroutines-core = { group = "org.jetbrains.kotlinx", name = "kotlinx-coroutines-core", version.ref = "coroutines" }
+
+# Networking
+retrofit = { group = "com.squareup.retrofit2", name = "retrofit", version.ref = "retrofit" }
+retrofit-serialization = { group = "com.squareup.retrofit2", name = "converter-kotlinx-serialization", version.ref = "retrofit" }
+okhttp = { group = "com.squareup.okhttp3", name = "okhttp", version.ref = "okhttp" }
+okhttp-logging = { group = "com.squareup.okhttp3", name = "logging-interceptor", version.ref = "okhttp" }
+
+# Supabase
+supabase-auth = { group = "io.github.jan-tennert.supabase", name = "auth-kt", version.ref = "supabase" }
+supabase-postgrest = { group = "io.github.jan-tennert.supabase", name = "postgrest-kt", version.ref = "supabase" }
+supabase-realtime = { group = "io.github.jan-tennert.supabase", name = "realtime-kt", version.ref = "supabase" }
+ktor-client-android = { group = "io.ktor", name = "ktor-client-android", version.ref = "ktor" }
+
+# LiveKit
+livekit-android = { group = "io.livekit", name = "livekit-android", version.ref = "livekit" }
+
+# Media
+media3-exoplayer = { group = "androidx.media3", name = "media3-exoplayer", version.ref = "media3" }
+media3-exoplayer-hls = { group = "androidx.media3", name = "media3-exoplayer-hls", version.ref = "media3" }
+media3-effect = { group = "androidx.media3", name = "media3-effect", version.ref = "media3" }
+media3-ui = { group = "androidx.media3", name = "media3-ui", version.ref = "media3" }
+media3-common = { group = "androidx.media3", name = "media3-common", version.ref = "media3" }
+media3-datasource = { group = "androidx.media3", name = "media3-datasource", version.ref = "media3" }
+media3-datasource-okhttp = { group = "androidx.media3", name = "media3-datasource-okhttp", version.ref = "media3" }
+media3-database = { group = "androidx.media3", name = "media3-database", version.ref = "media3" }
+media3-session = { group = "androidx.media3", name = "media3-session", version.ref = "media3" }
+
+# Billing
+billing-ktx = { group = "com.android.billingclient", name = "billing-ktx", version.ref = "billing" }
+
+# Images
+coil-compose = { group = "io.coil-kt.coil3", name = "coil-compose", version.ref = "coil" }
+coil-network = { group = "io.coil-kt.coil3", name = "coil-network-okhttp", version.ref = "coil" }
+
+# Google Maps
+maps-compose = { group = "com.google.maps.android", name = "maps-compose", version.ref = "maps-compose" }
+
+# Google Sign-In (Credential Manager)
+credentials = { group = "androidx.credentials", name = "credentials", version = "1.5.0" }
+credentials-play-services = { group = "androidx.credentials", name = "credentials-play-services-auth", version = "1.5.0" }
+google-id = { group = "com.google.android.libraries.identity.googleid", name = "googleid", version = "1.1.1" }
+
+# WorkManager
+work-runtime = { group = "androidx.work", name = "work-runtime-ktx", version.ref = "work" }
+
+# Facebook
+facebook-core = { group = "com.facebook.android", name = "facebook-core", version.ref = "facebook" }
+
+# ML Kit (text recognition for camera scan, matching iOS DataScannerViewController)
+mlkit-text = { group = "com.google.mlkit", name = "text-recognition", version = "16.0.1" }
+
+# CameraX (for camera preview in scan mode)
+camerax-core = { group = "androidx.camera", name = "camera-core", version = "1.4.1" }
+camerax-camera2 = { group = "androidx.camera", name = "camera-camera2", version = "1.4.1" }
+camerax-lifecycle = { group = "androidx.camera", name = "camera-lifecycle", version = "1.4.1" }
+camerax-view = { group = "androidx.camera", name = "camera-view", version = "1.4.1" }
+
+# On-device TTS
+# IMPORTANT: onnxruntime-android version MUST match the ONNX Runtime that
+# sherpa-onnx bundles in its AAR. sherpa-onnx 1.12.34 ships a libonnxruntime.so
+# built from ORT 1.23.2 (exports OrtGetApiBase@@VERS_1.23.2). Mismatched
+# versions cause:
+#   java.lang.UnsatisfiedLinkError: cannot locate symbol "OrtGetApiBase"
+#     referenced by "libonnxruntime4j_jni.so"
+# at VoiceConverter load time, because Android merges the duplicate
+# libonnxruntime.so entries to one file and the JNI ends up calling a
+# differently-versioned libonnxruntime.so than it was built against.
+# When bumping sherpa-onnx, re-verify the bundled ORT version with:
+#   llvm-readelf --dyn-symbols libonnxruntime.so | grep OrtGetApiBase
+# and update this version to match (downgrade if necessary).
+sherpa-onnx = { group = "com.github.k2-fsa", name = "sherpa-onnx", version = "1.12.34" }
+onnxruntime-android = { group = "com.microsoft.onnxruntime", name = "onnxruntime-android", version = "1.23.2" }
+
+# Testing
+junit = { group = "junit", name = "junit", version.ref = "junit" }
+
+[plugins]
+android-application = { id = "com.android.application", version.ref = "agp" }
+android-library = { id = "com.android.library", version.ref = "agp" }
+kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
+kotlin-serialization = { id = "org.jetbrains.kotlin.plugin.serialization", version.ref = "kotlin" }
+kotlin-compose = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }
+ksp = { id = "com.google.devtools.ksp", version.ref = "ksp" }
+hilt = { id = "com.google.dagger.hilt.android", version.ref = "hilt" }
+kotlin-jvm = { id = "org.jetbrains.kotlin.jvm", version.ref = "kotlin" }
+play-publisher = { id = "com.github.triplet.play", version = "3.12.1" }

loqalkit-1.6.2/LoqalKitAndroid/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,7 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.11.1-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

loqalkit-1.6.2/LoqalKitAndroid/gradle.properties

@@ -0,0 +1,2 @@
+android.useAndroidX=true
+org.gradle.jvmargs=-Xmx2048m