インストールとアカウント
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
- 自分のMac(Apple SiliconまたはIntel)用の
.dmgをダウンロードします。 - 開いて、Embedr を Applications のリンクにドラッグします。
- アプリケーションフォルダからEmbedrを起動します。
- 初回にmacOSが開くのを拒否した場合は、アプリケーションフォルダでアプリをControlキーを押しながらクリックして Open を選ぶか、システム設定 → プライバシーとセキュリティで許可します。
Apple Siliconでは、一部のArduinoツールチェーンがIntel専用です。ビルドにRosettaが必要な場合、Embedrがそのことを伝え、インストール用のコマンドを表示します。
softwareupdate --install-rosetta --agree-to-license
macOSがマイクへのアクセスを求めるのは、Voice Modeを開いたときだけです。
Windows
Embedr-Setup-<version>-x64.exeを実行します。- インストーラーはユーザー単位で、管理者権限は不要です。インストール先は変更でき、既定は
%LOCALAPPDATA%\Programs\Embedrです。 - スタートメニューとデスクトップにショートカットが作られます。
- 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は動き続けますが、一部のフォルダでアプリの外で行った変更が、プロジェクトを開き直すまで反映されないことがあります。その場合は上限を引き上げてください。
初回起動
- サインインまたはアカウント作成。 アプリはサインイン画面で開きます。
- Welcome to Embedr。 "I agree to the Terms of Service and Privacy Policy." にチェックを入れます。Session recording スイッチは、問題の診断に役立つようマスク済みの操作記録を共有します。ここで、または後から設定 → Privacy でオフにできます。Continue をクリックします。
- 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は起動の数秒後と、実行中は数時間ごとにアップデートを確認します。アップデートはバックグラウンドでダウンロードされます。
- 左下にアップデートのカードが表示されます。Update available、続いて進行状況バー付きの Updating Embedr("12.4 MB of 98.1 MB"、割合)。
- ダウンロードが終わると、カードに Update ready と表示されます: "Restart Embedr to finish installing. Otherwise, it will update when you next quit."
- 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 は開いたフォルダをディスクに残します。プロジェクトの構造を参照してください。
