amicalhq/amical

Amical – ローカル優先のAI音声入力

何であるか – Amical は、あなたのマシン上で完全に動作するオープンソースのデスクトップアプリです。AIを活用してテキストを音声入力し、メモを取ることができます。OpenAIのWhisperを音声認識に、Ollama経由でローカルで実行されるLLM（大規模言語モデル）を用いて文脈を理解し、現在使用中のアプリ（メール、IDE、チャットなど）に適した形式で出力します。インターネット接続は不要で、音声データはデバイスから外に出ることはありません。

主な機能

• 高速で正確な音声入力 – Whisperはローカルで実行され、ほぼリアルタイムの変換が可能。
• 文脈に応じたフォーマット – アクティブなウィンドウを検出し、出力形式を自動調整（例：メール形式、コードスニペット、チャットメッセージ）。
• 拡張可能なワークフロー – ホットキー、音声マクロ、カスタムパイプラインを追加可能。
• プライバシー最優先 – すべてのモデルはローカルにダウンロード・実行され、音声データはクラウドに送信されません。
• フローティングウィジェット – フローを妨げず、開始/停止を簡単に行える小さな画面内コントロール。
• 計画中 – 音声メモの要約、タスク抽出、会議記録、アプリ制御連携の強化。

技術スタック

• 音声認識：Whisper（ネイティブアドオンとしてコンパイル）
• LLM推論：Ollama（オープンソースモデルをローカルで実行）
• デスクトップフレームワーク：Electron + TypeScript
• UI：TailwindCSS + Shadcn UI コンポーネント
• 認証・検証：Better-Auth, Zod
• ビルド・テスト：Turborepo, Vitest, TypeScript 7（ネイティブコンパイラ）

開発者向けセットアップ手順

1. サブモジュール付きでクローン – git clone --recurse-submodules https://github.com/amicalhq/amical.git
2. ツールのインストール – Node 24、pnpm 10.15、CMake ≥ 3.20、macOSならXcode、WindowsならVisual Studio 2022。
3. Corepackの有効化と依存関係のインストール – corepack enable && pnpm install --frozen-lockfile
4. Whisperが使用するNodeバイナリのダウンロード – pnpm --filter @amical/desktop download-node
5. アプリの実行 – pnpm turbo run dev --filter=@amical/desktop
6. PR提出前のチェック実行 – pnpm type:check && pnpm test

エンドユーザー向けインストール方法

• macOS: brew install --cask amical または最新リリースからダウンロード。
• Windows: リリースページからインストーラーをダウンロード。
• Android: Google Playで利用可能（README内のリンク参照）。
• iOS: ベータ登録用リンクを提供。

貢献について – PRやバグ報告を歓迎しています。ディスカッションやコミュニティサポートはDiscordサーバーで行っています。PRを開く前に、タイプチェックとテストを実行する貢献チェックリストに従ってください。

ライセンス – MIT。