インストールとアカウント

Embedrのインストール、サインイン、ChatGPTやOpenCodeの接続、プラン、アップデート。

Embedrは embedr.app/download からダウンロードします。インストールせずに、Webアプリ studio.embedr.app を使うこともできます。ブラウザ版Embedrを参照してください。

インストーラー

システム ファイル アーキテクチャ
macOS .dmg(アップデート用の .zip もあります) Apple Silicon(arm64)とIntel(x64)。ダウンロードは別々です
Windows Embedr-Setup-<version>-x64.exe x64
Linux Embedr-<version>-x64.AppImage と Embedr-<version>-x64.deb x64

macOS

  1. 自分のMac(Apple SiliconまたはIntel)用の .dmg をダウンロードします。
  2. 開いて、Embedr を Applications のリンクにドラッグします。
  3. アプリケーションフォルダからEmbedrを起動します。
  4. 初回にmacOSが開くのを拒否した場合は、アプリケーションフォルダでアプリをControlキーを押しながらクリックして Open を選ぶか、システム設定 → プライバシーとセキュリティで許可します。

Apple Siliconでは、一部のArduinoツールチェーンがIntel専用です。ビルドにRosettaが必要な場合、Embedrがそのことを伝え、インストール用のコマンドを表示します。

softwareupdate --install-rosetta --agree-to-license

macOSがマイクへのアクセスを求めるのは、Voice Modeを開いたときだけです。

Windows

  1. Embedr-Setup-<version>-x64.exe を実行します。
  2. インストーラーはユーザー単位で、管理者権限は不要です。インストール先は変更でき、既定は %LOCALAPPDATA%\Programs\Embedr です。
  3. スタートメニューとデスクトップにショートカットが作られます。
  4. Windows SmartScreenがダウンロードについて警告した場合、embedr.appからダウンロードしたファイルであることを確認できれば、More info、続いて Run anyway を選びます。

アンインストールしても設定とプロジェクトは残ります。

ボードが Device の選択肢に表示されない場合は、そのボードのUSBシリアルドライバをインストールしてください。よく使われるのはCH340/CH341(多くのArduino互換ボード)、CP210x(多くのESP32ボード)、FTDIです。

Linux

  • AppImage: 実行可能にして(chmod +x Embedr-<version>-x64.AppImage)実行します。
  • .deb: パッケージマネージャでインストールします(例: sudo apt install ./Embedr-<version>-x64.deb)。パッケージは /opt/Embedr にインストールされ、デスクトップ版のサインインで使う embedr:// リンクのハンドラとしてEmbedrを登録します。

ボードへの書き込みやシリアルポートを開くには、通常ユーザーがシリアルグループ(DebianとUbuntuでは dialout、Archでは uucp)に入っている必要があります。追加した後は、一度ログアウトしてログインし直してください。

sudo usermod -aG dialout "$USER"

非常に大きなプロジェクトでは、Linuxのファイル監視数(fs.inotify.max_user_watches)が不足することがあります。Embedrは動き続けますが、一部のフォルダでアプリの外で行った変更が、プロジェクトを開き直すまで反映されないことがあります。その場合は上限を引き上げてください。

初回起動

  1. サインインまたはアカウント作成。 アプリはサインイン画面で開きます。
  2. Welcome to Embedr。 "I agree to the Terms of Service and Privacy Policy." にチェックを入れます。Session recording スイッチは、問題の診断に役立つようマスク済みの操作記録を共有します。ここで、または後から設定 → Privacy でオフにできます。Continue をクリックします。
  3. AIアカウントの接続。 Embedrには無料のモデルが含まれているため、この手順は任意です。自分のサブスクリプションや残高を使うにはここでChatGPTやOpenCodeを接続し、使わない場合は Skip for now をクリックします。終わったら Start building をクリックします。

ホーム画面が開きます。最初のプロジェクトについてはまず読むを参照してください。

サインイン

サインイン画面では、Continue with Google か、メールアドレスとパスワード(Or use email)を選べます。

  • デスクトップでのGoogle はブラウザを開きます("Opening browser for authentication...")。ブラウザでサインインすると、embedr:// リンクを通じてアプリに戻ります。ブラウザがEmbedrを開くか尋ねてきたら許可してください。
  • Create account では Full Name、Email address、Password(6文字以上)の入力と規約への同意が必要です。使い捨てのメールアドレスは使えません。
  • メールアドレスの確認。 新しいメールアカウントには確認リンクが届きます("Check your inbox")。リンクをクリックするまでは、サインインすると "Please verify your email before logging in." と表示され、リンクが再送されます。届かない場合は Resend verification email を使ってください。
  • Forgot password? をクリックすると Reset password が開きます。メールアドレスを入力して Send reset link をクリックします。

デスクトップでサインアウトするには、設定 → Profile → Account Session → Sign Out を開きます。

ChatGPTやOpenCodeの接続

自分のモデルアカウントは、初回設定の途中か、後から設定 → AI Accounts で接続できます。

アカウント 接続方法(初回設定の場合。設定画面では Open ChatGPT と Save Key を使います) 得られるもの
ChatGPT Plus / Pro Connect をクリックします。"Enter code in your browser:" の下にコードが表示されます。Copy code、続いて Open browser ↗ をクリックし、OpenAIのページでコードを入力します。 モデル選択に ChatGPT グループが追加され、OpenAIのサブスクリプションの上限で使えます。接続中は "Signed in as …" と表示されます。
OpenCode Connect をクリックし、OpenCode API key にキーを貼り付け(opencode.aiでキーを作るには Get API key)、Connect OpenCode をクリックします。 モデル選択に OpenCode Zen と OpenCode Go のグループが追加され、OpenCodeの残高に課金されます。

接続はFreeを含むすべてのプランで使えます。接続するまでは、モデル選択にこれらのグループの代わりに Connect ChatGPT と Connect OpenCode の行が表示されます。接続の解除も同じ場所で行います。

デスクトップでは、接続情報はコンピュータ上のアプリのデータフォルダに保存されます。接続したアカウントで行ったリクエストは、Embedrのプランではなくそのアカウントの使用量として数えられます。モデルを参照してください。

プラン

プランによって、使えるEmbedr提供のモデルと含まれる使用量が決まります。設定 → Usage & billing に現在のプランが表示されます。

プラン アプリでの表示
Free "Free tier includes 60 AI requests per 30-day cycle." 追加使用はできません。
Embedr Access $25分のクレジットを含む30日間のパスです。GPT-6.2 SolとGPT-6 Lunaが含まれます。終了するとFreeに戻ります。
Hobby "$25 monthly AI compute credits with cloud compiler and standard models." モデル選択で Hobby+ と表示されたモデルにはHobbyかProが必要です。
Pro "$100 monthly AI compute credits with priority access and cloud compiler." Pro と表示されたモデルにはProが必要です。

モデル選択でロックされたモデルには "View plans to use this model" と表示されます。

Usage & billing

セクション 内容
Active Plan "{Plan} Plan" と Upgrade Plan(Free)または Manage Subscription(有料)。
Usage limits "Resets {date}"、"{n}% remaining" 付きの Monthly plan limit、Included in plan、Extra usage("Not enabled on Free tier" または "Billed pay-as-you-go at the end of the billing cycle")、Prepaid balance。
Billing & Invoices Customer Portal で、請求と請求書をブラウザで開きます。

チャット入力欄にも使用量メーターがあります。Usage remaining、使用枠(Freeでは 30-day allowance、有料プランでは Monthly plan credit)、"Plan usage resets {date}" が表示され、アップグレード、クレジットの追加、請求の管理を行うボタンがあります。

上限に達したとき

チャットのメッセージ 対処
Free Tier 30-Day Limit Reached: "You've reached your 60-request allowance for this 30-day period." Upgrade to a Paid Plan をクリックするか、リセット日まで待つか、接続したChatGPTやOpenCodeのモデルに切り替えます。
Embedr Access Credit Used View plans をクリックします。ChatGPTやOpenCodeの接続は引き続き使えます。
Hobby Credit Exhausted または Pro Credit Exhausted Add Overage Credit をクリックするか、毎月のリセットを待ちます。

Freeの使用枠は、ローリング方式の30日サイクルです。リセット日は使用量メーターに表示されます。

アップデート

Embedrは起動の数秒後と、実行中は数時間ごとにアップデートを確認します。アップデートはバックグラウンドでダウンロードされます。

  1. 左下にアップデートのカードが表示されます。Update available、続いて進行状況バー付きの Updating Embedr("12.4 MB of 98.1 MB"、割合)。
  2. ダウンロードが終わると、カードに Update ready と表示されます: "Restart Embedr to finish installing. Otherwise, it will update when you next quit."
  3. Restart and update をクリックするか、そのまま作業を続け、次に終了したときにインストールさせます。Minimize update でカードを小さなピル型に縮めます。

再起動をクリックしたときにエージェントや書き込みがまだ実行中の場合、Embedrは先に確認します: "Embedr is still working on an active task. Restarting now will stop it. Restart and install the update anyway?"

ダウンロードに失敗すると、カードに Update failed と Retry が表示されます。

バージョンが古すぎてサービスを使い続けられない場合、チャットに Update Required("Update Embedr to version {version} or later to continue.")と Update Embedr ボタンが表示されます。アプリが自分で更新できない場合は、embedr.app/download から最新のインストーラーをダウンロードしてください。

Windowsでは、再起動時にアップデートが自動でインストールされます。LinuxのAppImageと .deb も同じアップデート配信を使います。

Windowsでの復旧

アップデートが中断されると、アプリの一時的なコピーが残ることがあります。Embedrがそのコピーから起動した場合は、インストール先から自動的に起動し直します。ビルドツールが見つからない場合は、Embedr needs to be repaired というタイトルのダイアログに "Embedr's build tools are missing, so projects cannot be created or built." と表示されます。Download Embedr をクリックして再インストールしてください。プロジェクトと設定は残ります。

設定

タイトルバーの歯車か Cmd+, / Ctrl+, で設定を開きます。セクションは次のとおりです。

グループ セクション
Personal General、Profile、Appearance、Usage & billing、Notifications
Integrations AI Accounts、Local tools(デスクトップのみ)
Coding Editor、Command Approval(デスクトップのみ)
System & Privacy Privacy、About

各セクションについては設定とプライバシーを参照してください。

コンピュータに保存されるもの

内容 場所
新しいプロジェクト ~/EmbedrProjects/<project-name>/(Windowsでは %USERPROFILE%\EmbedrProjects\)
開いた、取り込んだ、クローンしたフォルダ 元の場所のまま。Embedrは記録するだけで移動しません。
プロジェクト一覧とチャット履歴 ~/EmbedrProjects/.embedr/(projects.json と、プロジェクトごとにスレッドを含むフォルダ)
ChatGPTとOpenCodeの接続、記憶させたGitトークン、ローカル設定 OSごとのアプリのデータフォルダ

ファームウェア、ハードウェアのソース、仕様書はプロジェクトフォルダに残ります。サインイン、エージェント、データシートの処理、モデル一覧、アップデートにはインターネット接続が必要です。KiCad 10がローカルにインストールされていない場合のホスト型KiCadチェックなどのクラウドタスクも同様です(設定 → Local tools)。ファイルの編集、インストール済みのツールチェーンでのコンパイル、書き込み、シリアルモニターはローカルのファイルで動作します。

ホーム画面からプロジェクトを削除すると、そのチャット履歴も削除されます。Delete project はEmbedrが作成したプロジェクトのフォルダも削除します。Remove from Embedr は開いたフォルダをディスクに残します。プロジェクトの構造を参照してください。