haynoi - GitLite

KO | EN

gitlite — search

#agents #docker #tensorflow #react-native #chatgpt #pdf #svg #deep-learning #awesome-list #sql

haynoi

(★ 18)

Push-to-talk dictation for macOS — Vietnamese-first, English-friendly. Hold a key, speak, text appears in any app. Powered by Kyma API.

파일 탐색기

ZIP 다운로드

- - release.yml
- haynoi-glyph-black.svg
- haynoi-glyph-white.svg
- haynoi-glyph.svg
- haynoi-icon.svg
- haynoi-wordmark.svg
- make-icons.sh
- README.md
- - Contents.json
- - background.png
  - background.svg
- Haynoi.entitlements
- Info.plist
- build-dmg.sh
- changelog-to-html.sh
- deploy-site.sh
- generate_sounds.py
- make_appcast.sh
- package_app.sh
- release.sh
- sign-and-notarize.sh
- - index.html
- - index.html
- - index.html
- - index.html
- analytics.js
- icon.png
- index.html
- llms.txt
- og.png
- robots.txt
- sitemap.xml
- CorrectionLearningTests.swift
- CorrectionPassTests.swift
- MediaPolicyTests.swift
- PhoneticsTests.swift
- RewritePromptTests.swift
.gitignore
appcast.xml
CHANGELOG.md
CONTRIBUTING.md
LICENSE
Makefile
project.yml
README.md
run.sh
version.env

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

명령어 용어집

이 문서에서 사용된 명령어를 모아봤습니다. 낯선 명령어가 있다면 펼쳐서 확인해보세요.

🔍

`brew install`

설명 보기 ▼

Install a Homebrew formula or cask.

brew install {{formula|cask}}

Install a formula/cask:

brew install {{[-s|--build-from-source]}} {{formula}}

Build and install a formula from source (dependencies will still be installed from bottles):

brew install {{[-n|--dry-run]}} {{formula|cask}}

Download the manifest, print what would be installed but don't actually install anything:

🔍

`git clone`

설명 보기 ▼

Clone an existing repository.

git clone {{remote_repository_location}} {{path/to/directory}}

Clone an existing repository into a new directory (the default directory is the repository name):

git clone --recursive {{remote_repository_location}}

Clone an existing repository and its submodules:

git clone {{[-n|--no-checkout]}} {{remote_repository_location}}

Clone only the `.git` directory of an existing repository:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">Haynoi</h1>

<p align="center">
  <b>Push-to-talk dictation for macOS.</b><br />
  Hold a key, speak, release — your words appear in whatever app you're typing in.
</p>

<p align="center">
  Vietnamese-first, English-friendly. Powered by <a href="https://kymaapi.com">Kyma API</a>.
</p>

<p align="center">
  <a href="https://haynoi.com"><b>haynoi.com</b></a> · <a href="https://github.com/sonpiaz/haynoi/releases/latest"><b>Download for macOS</b></a>
</p>

<p align="center">
  <a href="https://github.com/sonpiaz/haynoi/blob/main/LICENSE"><img src="https://img.shields.io/github/license/sonpiaz/haynoi" alt="License" /></a>
  <a href="https://github.com/sonpiaz/haynoi/stargazers"><img src="https://img.shields.io/github/stars/sonpiaz/haynoi" alt="Stars" /></a>
  <a href="https://github.com/sonpiaz/haynoi/releases"><img src="https://img.shields.io/github/v/release/sonpiaz/haynoi?include_prereleases&label=release" alt="Release" /></a>
  <img src="https://img.shields.io/badge/macOS-14%2B-black" alt="macOS 14+" />
  <img src="https://img.shields.io/badge/Swift-5.9-orange" alt="Swift 5.9" />
  <img src="https://img.shields.io/badge/100%25-native-blue" alt="Native" />
</p>

---

## Why Haynoi

Most dictation tools treat Vietnamese as an afterthought. **Haynoi is built for the way Vietnamese people actually speak** — tiếng Việt with English mixed in mid-sentence ("deadline", "deploy", "team marketing") — and keeps both languages intact instead of translating or mangling one of them.

- **Speaks your language(s).** Vietnamese-optimized speech-to-text that handles Vi/En code-switching — and a personal dictionary that **learns from your corrections**, so names and jargon come out right the next time without you configuring anything.
- **Works in every app.** Text is inserted directly where your cursor is — editor, browser, chat, terminal — via the Accessibility API, with clipboard fallback.
- **Nothing to configure.** Sign in once with Google. No API keys to paste, no model menus to study. Free tier included.

## How it works

```
Hold ⌥  →  speak  →  release  →  text appears
```

That's the whole product. A floating bar shows the waveform while you talk; a layered chord confirms start/stop.

## Smart modes

| Mode | What it does |
|------|--------------|
| **Normal** | Transcribes exactly what you say |
| **Clean** | Drops filler words (ừm, à, uh…) |
| **Email / Formal** | Rewrites your rambling into a professional message |
| **Auto** | Picks a mode from the app you're in — formal in Mail, clean in chat |

## It learns you

Haynoi's dictionary fills itself instead of asking you to maintain it:

- **Fix it once, it sticks.** Say "fix that" (⌃⌥) and re-dictate, edit the inserted text in place, or just repeat yourself — Haynoi notices the correction and suggests remembering it. Confirmed fixes are applied automatically from then on.
- **It knows when it wasn't sure.** When the transcriber hesitates on a word that *sounds like* a name you use — "Afider" for "Affitor", "Sun" for "Sơn" — that one dictation gets an extra cleanup pass with your personal terms. Confident dictations skip it, so nothing gets slower.
- **You stay in charge.** A master learning switch, a counter of what's been learned, and a one-tap "Forget all" live in Settings → Dictionary. Learning runs on transcript text only — never audio — and your dictionary never leaves your Mac.

## Features

- **Push-to-talk** — hold the left `⌥` Option key (or `⌘` / `⌃` / `fn`), release to transcribe
- **Language preference** — auto-detect by default, or pin Tiếng Việt / English
- **Your words are never lost** — if the network fails mid-transcription, the recording is saved locally and retried with one click
- **Survives real life** — AirPods disconnecting mid-sentence, permission hiccups, and flaky Wi-Fi all degrade gracefully instead of eating your dictation
- **Auto-paste** into the active app, with clipboard fallback — and your previous clipboard is restored afterwards (dictated text is also hidden from clipboard managers)
- **Other audio gets out of your way** — music and video pause and resume around your dictation; a live call or stream is dipped in volume instead, decided from what your Mac is actually playing
- **Living status orb** — recording, transcribing, success, and error each have their own state, so you always know where your words are
- **Snippets** — say a trigger word, get expanded text
- **Transcription history** — searchable, stored locally, grouped by date
- **Premium sound feedback** — harmonic chords for start / stop / cancel / success
- **Silent auto-updates** via Sparkle, launch at login, guided onboarding

## Install

**Download** the latest `Haynoi.dmg` from [haynoi.com](https://haynoi.com) or [GitHub Releases](https://github.com/sonpiaz/haynoi/releases/latest), drag it to Applications, and open it. The app is signed and notarized — no security warnings, and updates install themselves.

Prefer building from source?

```bash
git clone https://github.com/sonpiaz/haynoi.git
cd haynoi
brew install xcodegen    # if not installed
make run
```

First run, either way:

1. The onboarding wizard walks you through Microphone and Accessibility permissions — that's all Haynoi needs
2. **Sign in with Google** — one click, no passwords, nothing to paste
3. Hold the left `⌥` Option key, say something, release — the guided first dictation shows you the loop

## Pricing

**Free: 5,000 words per week**, resetting every Monday. That covers everyday dictation for most people — no card required, just the Google sign-in.

**Haynoi Pro** (unlimited words) is coming soon.

Two transcription tiers, switchable any time in Settings:

| Tier | Model | Best for |
|------|-------|----------|
| **Quality** (default) | `gpt-4o-mini-transcribe` | Vietnamese + English, noisy rooms, technical vocabulary |
| **Fast** | `whisper-v3-turbo` | Clear, simple speech |

## Privacy

- **Audio** is sent to Haynoi's backend for transcription, then discarded — recordings are never stored server-side
- **Your dictionary, learned corrections, and transcription history stay on your Mac** — learning uses transcript text only, never audio, and nothing about it syncs anywhere
- Your sign-in session lives in the **macOS Keychain**
- **Anonymous usage analytics** (feature counts and timings — never your words, never transcript content) help improve the app; there's an opt-out toggle in Settings

## Development

```bash
make generate    # Generate Xcode project (XcodeGen)
make build       # Build via xcodebuild
make run         # Build and run
make clean       # Clean build artifacts
```

<details>
<summary><b>Project structure</b></summary>

```
Sources/Haynoi/
├── App/
│   ├── HaynoiApp.swift           — App entry, menu bar, onboarding
│   ├── AppState.swift            — Shared state, transcription history
│   └── PipelineController.swift  — Hotkey → Record → Transcribe → Insert
├── Audio/
│   ├── AudioRecorder.swift       — 16kHz mono mic capture via AVAudioEngine
│   └── SoundFeedback.swift       — Harmonic chord audio cues
├── Auth/
│   ├── HaynoiAuth.swift          — Google sign-in via Haynoi's backend
│   └── KeychainStorage.swift     — Session storage in the macOS Keychain
├── Input/
│   ├── HotkeyManager.swift       — Global hotkey via NSEvent monitors (Accessibility)
│   └── TextInserter.swift        — AX API + clipboard text insertion
├── Transcription/
│   ├── STTProvider.swift         — Transcription + confidence-gated correction pass
│   └── TranscriptionMode.swift   — Normal / Clean / Email / Auto modes
├── Settings/
│   └── SettingsView.swift        — Account, quality, hotkey, dictionary
├── UI/                           — History list, main window, floating bar
└── System/                       — Personal dictionary + correction learning,
                                    media control, launch at login, usage stats
```

</details>

## Tech stack

| Technology | Purpose |
|-----------|---------|
| Swift 5.9 + SwiftUI | App |
| AVFoundation | Audio capture & sound synthesis |
| [Kyma API](https://kymaapi.com) | Speech-to-text (`gpt-4o-mini-transcribe` / `whisper-v3-turbo`) and rewrite (`gemini-2.5-flash`) |
| Accessibility API + NSEvent | Text insertion + global hotkey (no Input Monitoring needed) |
| [XcodeGen](https://github.com/yonaskolb/XcodeGen) | Project generation |

## Related

- [Pheme](https://github.com/sonpiaz/pheme) — AI meeting notes for macOS, Vietnamese-optimized
- [kyma-dub](https://github.com/sonpiaz/kyma-dub) — time-aligned AI video dubbing CLI
- [Kapt](https://github.com/sonpiaz/kapt) — macOS screenshot tool with annotation & OCR

## License

MIT — see [LICENSE](LICENSE).

---

<p align="center">Built by <a href="https://github.com/sonpiaz">Son Piaz</a> · Powered by <a href="https://kymaapi.com">Kyma API</a></p>