hex README

README проекта с github.com/anomalyco/hex. Одним файлом markdown: README.md.

Hex

Hex is local voice dictation for Mac, Windows and Linux. Hold a key, speak, and it pastes.

How it works

What it does

Output and History:

Hex output: the steps every dictation runs, a Try box, and different steps per app Hex history: past dictations, a search field, and one entry's raw transcript, app, processing and model

Speech models

Hex downloads one model the first time it runs and transcribes with it on your machine from then on. On an English system that's Parakeet Unified English: it writes while you talk, so the text is ready when you let go. Other languages start with the model recommended for them. That model also serves meetings and hex transcribe.

Settings' picker offers more, among others:

Add a GGUF model of your own with "Add model file…" in the picker; see your own speech models.

Downloads

Stable is the current release. Dev is the newest build of dev and updates itself from the dev channel.

Platform Stable Dev
macOS (Apple silicon) DMG DMG
Windows x64 Installer Installer
Windows ARM64 Installer Installer
Linux x86_64 Executable Executable
Linux x86_64 (Debian, Ubuntu) .deb .deb
Linux x86_64 (Fedora, openSUSE) .rpm .rpm
Linux ARM64 Executable Executable
Linux ARM64 (Debian, Ubuntu) .deb .deb
Linux ARM64 (Fedora, openSUSE) .rpm .rpm

Or install with:

Command line

hex transcribe meeting.m4a prints a recording's transcript, whether or not the app is running. It reads WAV, AIFF, CAF, FLAC, MP3, Ogg, WebM, and MP4/M4A/MOV, including a video's soundtrack. The same hex controls the running app (hex status, hex dictation, hex settings); see docs/cli.md.

On macOS the CLI is inside the app. Homebrew links it for you; otherwise link it somewhere on your PATH that you own:

ln -s /Applications/Hex.app/Contents/MacOS/hex ~/.local/bin/hex

Linux and Windows installs put hex on your PATH.

More docs are in docs/.

Contributing

We don't take pull requests. Open an issue describing the bug or idea, and our agents usually turn it around fast.

MIT licensed.

hex (anomalyco/hex)

Ищем в базе…

7.3K ·GitHub
Что это?HEX — это инструмент голосового ввода с локальной обработкой: зажмите горячую клавишу, говорите, отпустите, и он распознает речь прямо на вашем устройстве и вставит текст в то приложение, которое вы используете. Есть нативная поддержка macOS, а также бета-версии для Windows и Linux.
Это просто приложение для Mac или на его основе тоже можно что-то создавать?В первую очередь это подписанное нативное настольное приложение (на Rust, с интерфейсом в строке меню). Также есть SDK '@kitlangton/hex' на TypeScript, который позволяет разработчикам добавлять локальное распознавание речи в свои приложения через API на Promise или Effect.
Как установить HEX?На macOS установите cask из Homebrew и запустите приложение из папки «Программы», либо скачайте подписанный DMG-образ и перетащите Hex.app в «Программы». Для Windows есть отдельный установщик для x64 и ARM64, а Linux распространяется как подписанный релиз для x86_64 Arch Linux или как сборка из исходников либо через Nix.
Нужен ли мне чип Apple silicon или определённая версия macOS, чтобы это запустить?Приложение для macOS требует Mac с чипом Apple silicon и macOS 15 или новее. Бета-версия для Windows поддерживает x64 и ARM64, а бета-версия для Linux требует сборку из исходников или Nix, а также драйвер Vulkan для производительности при потоковом распознавании.
Готова ли бета-версия для Windows к установке без дополнительных действий?Она работает, но пока не подписана цифровой подписью кода, поэтому SmartScreen в Windows будет выдавать предупреждение при запуске установщика. Нужно нажать «Подробнее», а затем «Всё равно запустить». Кроме того, в ней нет голосовых команд, встреч и локального API транскрибации, который есть в других версиях.
Покидает ли что-нибудь из моей диктовки устройство?По умолчанию нет: распознавание речи и команд выполняется полностью локально, а HEX не сохраняет аудио. Только необязательные функции на базе OpenCode (Voice Action и переписывание) отправляют расшифровку и некоторый контекст приложения или сайта вашему настроенному облачному провайдеру моделей.
Что такое Voice Action?Voice Action — это необязательная функция на базе OpenCode, по умолчанию выключенная. Зажмите Option-Command, опишите, что нужно сделать, и HEX отправит эту инструкцию, выделенный текст и контекст приложения или сайта провайдеру модели, а затем вставит результат.
Почему режим с учётом сайта работает только в одном браузере?Согласно заметкам по устранению неполадок, режимы и команды с учётом сайта сейчас требуют именно Brave Browser, поэтому сопоставление контекста пока не работает в других браузерах.
Как долго HEX хранит историю диктовки?По умолчанию в History сохраняется текст диктовки и Voice Action, успешно вставленный в приложение, в течение 7 дней (с ограничениями по количеству записей и объёму в байтах). Аудио, полные URL-адреса и заголовки окон никогда не сохраняются. Хранение можно отключить или очистить в любой момент.
Можно ли настроить экспериментальные голосовые команды?Да, опытные пользователи могут писать собственные команды на TypeScript в файле ~/.config/hex/hex.config.ts, для этого нужен Bun. HEX даже предоставляет подсказку, которую можно передать агенту для программирования, чтобы он помог их настроить.
Какие есть похожие проекты?gyotaku, SCM, parrot, lipflow, no-tipe-releases, phorminx, FluidVoice, omarchy-meeting-recorder
Автор
anomalyco
Размер
481.2 MB
Звёзды
7.3K
Возраст
4 мес
Коммиты · 90 дней