embedist

embedistとは？

embedistは、AI支援と組み込みファームウェア開発を組み合わせたWindowsデスクトップアプリケーションです。ターゲットハードウェアのコンテキストを利用して、AI支援デバッグ、シリアル監視、ファームウェアのビルド/書き込みを単一環境で作業できるように設計されています。

プロジェクトはTauri 2、React、TypeScriptで構築されています。目標は、組み込みプロジェクトフォルダ（例: ESP32やArduinoのコードベース）を開いて、編集、ビルド、書き込み、デバイスの出力監視中にボード対応のAIサポートを得ることです。

主な機能

• チャット、計画、エージェント実行、デバッグチャットのAIモード: 組み込み作業の各段階に適したインタラクションスタイル（Chat、Plan、Agent、Debug Chat）を提供します。
• マルチプロバイダAIサポート: OpenAI、Anthropic、Google、DeepSeek、Ollama、NVIDIA NIM、カスタムvLLMエンドポイントを含むAIプロバイダを使用します。
• デバッグのためのボード対応コンテキスト: AIデバッグは検出されたボード情報（例: ESP32バリアントやArduinoボード）を活用し、ハードウェア特化の修正を提案します。
• リアルタイムシリアルモニタ: デバイス通信をストリーミングし、ボーレート設定と自動接続動作をサポートします。
• PlatformIOビルド/書き込み統合: PlatformIO CLIを使用し、ライブ出力ストリーミング、エラー/警告をProblemsパネルに解析、Stop Buildボタンを備えます。
• コードエディタとプロジェクトナビゲーション: ブレッドクラム付きファイルエクスプローラ、最近使用ファイル、インラインリネーム、マルチセレクト、Monacoベースのエディタ（タブ管理、dirtyインジケータ付き）を備えます。
• VS Codeスタイルのキーボードショートカットとコマンドパレット: 一般操作のCtrlベースショートカットとCommand Palette（Ctrl+Shift+P）をサポートします。
• 軽量Windows実行ファイル: Tauri 2 Rustバックエンドを使用。リポジトリでは実行ファイルサイズを約5.7 MBと記述しています。
• 永続的なカスタムエンドポイントAPIキー: カスタムエンドポイントのAPIキーをアプリ再起動後も保持します。

embedistの使い方

1. ダウンロードと実行: Releasesからembedist.exeをダウンロードし、Windowsで実行します。
2. プロジェクトフォルダを開く: Ctrl+Oを押すかFile > Open Folderで組み込みコードを含むフォルダを開きます。
3. AIとプロバイダの設定: Settings（Ctrl+,）でAIプロバイダと必要に応じて認証情報を設定します。
4. (ビルド/書き込みの場合オプション): ビルド/書き込み機能を使う場合はPlatformIOをインストールします。
5. ビルド、書き込み、監視: BuildパネルでPlatformIO駆動のビルド/書き込みを実行し、Serial Monitorでランタイム出力を確認します。

未署名アプリのWindows SmartScreen警告が出た場合、リポジトリでは標準のWindowsセキュリティ画面であり、More infoからRun anywayを使用するよう指示しています。

ユースケース

• ボード対応AIによるファームウェアデバッグ: プロジェクトが既知ボード（例: ESP32 Dev ModuleやArduino Uno）を対象とする場合、AI Debugモードで検出ハードウェアに基づく修正を尋ねます。
• コーディング前の計画: Planモードでコード変更前のプロジェクト計画を共同作成し、統合エディタで編集を進めます。
• アクティビティ追跡付き自律イテレーション: Agentモードで実装ステップを委任し、変更適用中にライブアクティビティログを確認します。
• シリアル経由のデバイス動作監視: デバイスに接続し、シリアルモニタでリアルタイム出力を確認。ボーレート調整と自動接続で手動設定を削減します。
• ビルドとコンパイル/書き込みエラーのトリアージ: PlatformIOビルドを実行し、ストリーム出力とProblemsパネルに解析されたエラー/警告でイテレーションを高速化します。

FAQ

embedistはWindows以外のプラットフォームで利用可能ですか？
リポジトリではWindowsデスクトップアプリケーションと記述し、Windows 10/11（64-bit）を前提条件としています。

PlatformIOは必要ですか？
PlatformIOはオプション前提条件ですが、ビルド＆書き込み機能には必須です。

アプリ使用にAI APIキー必要ですか？
前提条件にオプションの「AI API Key」を記載。AIデバッグ機能には必要です。非AIワークフロンのみならアプリは使用可能ですが、AIデバッグにはキーが必要です。

どのボードがサポートされていますか？
ESP32ファミリーボード（ESP32 Dev Module、ESP32 WROOM/WROVER、ESP32 S3、ESP32 C3/C6、ESP32 CAM）、Arduinoファミリーボード（Uno/Nano/Mega、Pro Mini、Leonardo、Due、Zero）をサポート。ESP8266も言及されています。

embedistはカスタムAIエンドポイントをどう扱いますか？
カスタムエンドポイントの編集をサポートし、再起動後もAPIキーが永続します。

代替案

• エディタ/IDE内のPlatformIO（別途AIアシスタント付き）：主にビルド/書き込みとエラー解析が必要なら、既存のIDEに統合したPlatformIOでビルドフローをカバーでき、AI支援は別ツールから得られます。
• VS Code + 組み込み開発拡張機能 + AIツール：一般的なセットアップは、編集にVS Codeを使い、組み込みワークフローのためにPlatformIO風拡張機能を組み合わせ、外部AIチャット/デバッグツールを併用するものです。
• 汎用シリアルターミナルツール：主なニーズがシリアル監視なら、専用シリアルターミナルアプリでストリーミングとボーレート設定が得られますが、ボード対応AIデバッグや統合ビルド/書き込みは含まれません。
• プロジェクトコンテキスト付きAIコーディング/チャットツール：AI支援を望みつつ好みの組み込みツールチェーンをお持ちのユーザー向け。一般的なAIコーディングアシスタントが役立ちますが、embedistで説明されたようなボード対応デバッグや組み込み特化のシリアル/ビルド統合は提供されない場合があります。