Files

T

Rocky df1c5ff32c feat: migrate on-device Qwen3 ASR to CoreML for background Flow dictation

Replace MLX GPU inference with CoreML bundles so transcription continues
while the host app is backgrounded. Adds model download and warm-up,
vendored Qwen3Speech, and updates onboarding, settings, and copy for the
~1.6 GB CoreML package (iOS 18+).

2026-06-23 00:46:58 +08:00

2.7 KiB

Raw Blame History

Contributing to OSGKeyboard

Thanks for your interest! OSGKeyboard is a small, opinionated iOS app. We welcome bug reports, feature ideas, and pull requests — please read this guide first.

Code of Conduct

This project follows the Contributor Covenant. By participating you agree to its terms.

Filing a bug

Open an issue using the Bug report template. Please include:

iOS version + device model
Xcode version (run xcodebuild -version)
Steps to reproduce
Relevant logs (Console.app filtered to OSGKeyboard)

Proposing a feature

Open an issue using the Feature request template. Briefly describe:

What problem it solves
Your proposed UX / API
Any alternatives you considered

Submitting a pull request

Fork & branch. Branch from main with a descriptive name (feat/custom-provider, fix/asr-timeout).

Generate the project locally:

brew install xcodegen swiftlint
xcodegen generate          # or: ./Scripts/generate-xcodeproj.sh

Code style. SwiftLint config lives in .swiftlint.yml — keep it green. We use Swift 6 strict concurrency, no Sendable shims where avoidable.
Tests. Add XCTest coverage in OSGKeyboardTests/ for any non-trivial logic.

Build & test before pushing:

xcodebuild -project OSGKeyboard.xcodeproj \
  -scheme OSGKeyboard \
  -destination 'platform=iOS Simulator,name=iPhone 17' \
  test

Commit messages. Short imperative summary (fix: handle empty transcript), longer body if needed.
Open the PR against main. The CI pipeline (.github/workflows/ci.yml) will lint + build + test automatically.

Project structure

OSGKeyboard/       Main iOS app target
OSGKeyboardExt/    Custom Keyboard Extension target
OSGKeyboardShared/ Framework shared by app + extension
OSGKeyboardTests/  XCTest unit tests
project.yml        XcodeGen project definition (source of truth)
.github/workflows/ CI

Adding a new LLM provider

The simplest contribution: add a preset to OSGKeyboardShared/Models/LLMProvider.swift. No other code change is needed — OpenAICompatibleClient handles any OpenAI-compatible endpoint.

Coding conventions

Swift 6 strict concurrency
@MainActor on any UI-touching type
async/await everywhere; no completion-handler chains
Public types use PascalCase, internal-only types can use lowerCamelCase
File headers use the // FileName.swift → // OSGKeyboard · <Target> → blank-line → doc-comment style already in the repo

Releasing

Maintainers cut releases from main via GitHub Releases. The release tag follows vX.Y.Z. CHANGELOG.md is updated as part of the release PR.

2.7 KiB Raw Blame History