ダウンロードとインストール
このページでは、Elftia を初めてダウンロード、インストール、起動するまでの手順を案内します。
システム要件
インストールする前に、お使いのデバイスが次の最小要件を満たしていることを確認してください。
| プラットフォーム | 最小バージョン | アーキテクチャ |
|---|---|---|
| Windows | Windows 10 (64-bit) 以降 | x64 / arm64 |
| macOS | macOS 10.15 (Catalina) 以降 | Intel / Apple Silicon |
| Linux | Ubuntu 20.04 / Fedora 36 / Debian 11 または同等環境 | x64 |
推奨ハードウェア:
- RAM: 4 GB 以上 (8 GB 推奨)
- ディスク容量: 500 MB 以上の空き容量
- ネットワーク: LLM API を呼び出すにはインターネット接続が必要です
任意の依存関係 (Agent 機能に必要):
Elftia は初回起動時に、次のツールを自動的に検出します。Agent 機能 (コード編集、ファイル操作、Shell コマンドなど) を使用する予定がある場合は、事前にインストールしておくことをおすすめします。
| ツール | 用途 | ダウンロード |
|---|---|---|
| Node.js 18+ | MCP サーバーのランタイム、一部のツール実行 | nodejs.org |
| Git | バージョン管理、プロジェクト管理 | git-scm.com |
| uv / uvx | Python パッケージ管理 (一部の MCP サーバーで必要) | astral.sh/uv |
これらの依存関係は任意です。基本的な AI チャット機能だけが必要な場合は、スキップできます。
ダウンロード
公式 Web サイト
Elftia 公式 Web サイトのダウンロードページにアクセスし、お使いのオペレーティングシステム向けのバージョンを選択してください。
GitHub Releases
GitHub Releases ページから、最新バージョンまたは以前のバージョンをダウンロードすることもできます。各リリースには、次のインストーラーが含まれています。
| プラットフォーム | インストーラー形式 | ファイル名の例 |
|---|---|---|
| Windows | NSIS インストーラー | Elftia-Setup-x.x.x.exe |
| macOS | DMG イメージ | Elftia-x.x.x.dmg / Elftia-x.x.x-arm64.dmg |
| Linux | AppImage | Elftia-x.x.x.AppImage |
インストール手順
Windows
- ダウンロードした
Elftia-Setup-x.x.x.exeファイルをダブルクリックします。 - Windows SmartScreen のプロンプトが表示された場合は、「詳細情報」をクリックしてから「実行」を選択します。
- インストール先のパスを選択します (既定では
C:\Users\<username>\AppData\Local\Elftia)。 - インストールが完了するまで待ちます。インストーラーはデスクトップショートカットとスタートメニュー項目を自動的に作成します。
- 「完了」をクリックして Elftia を起動します。
Elftia は自動更新をサポートする NSIS インストーラーを使用しています。インストール済みのアプリケーションは、システム設定から通常どおりアンインストールできます。
macOS
- ダウンロードした
.dmgファイルをダブルクリックして、ディスクイメージをマウントします。 - 開いたウィンドウで、Elftia アイコンを「Applications」フォルダーにドラッグします。
- 初回起動時に、macOS が「開発元を検証できません」というプロンプトを表示する場合があります。
- 「システム設定 → プライバシーとセキュリティ → 一般」を開きます
- 「このまま開く」ボタンをクリックします
- Elftia が起動し、使用できる状態になります。
Apple Silicon (M1/M2/M3/M4) ユーザーは、最適なパフォーマンスを得るために arm64 バージョンをダウンロードしてください。Intel Mac ユーザーは標準バージョンをダウンロードしてください。
Linux
.AppImageファイルをダウンロードします。- 実行権限を付与します。
chmod +x Elftia-x.x.x.AppImage
- ダブルクリックして実行するか、ターミナルで実行します。
./Elftia-x.x.x.AppImage
AppImage を実行できない場合は、FUSE のインストールが必要なことがあります: sudo apt install libfuse2 (Ubuntu/Debian)。
初回起動
Elftia を初めて起動すると、次の流れが表示されます。
1. 環境検出
Elftia は、お使いのシステムにインストールされているツール (Node.js、Git、ripgrep、uv/uvx など) を自動的に検出します。検出結果は、設定ページの「環境」セクションに表示され、各ツールの横に緑色 (インストール済み) または赤色 (未インストール) のステータスインジケーターが表示されます。
これらのツールは、後から 設定 → 一般 → 環境 で確認および管理できます。一部の不足しているツールは、「インストール」ボタンをクリックして直接インストールできます。
2. 言語選択
Elftia は 3 つのインターフェース言語をサポートしています。
- 簡体字中国語
- 英語
- 日本語
既定の言語は、システム言語に基づいて自動的に選択されます。いつでも 設定 → 一般 → 言語 で変更できます。
3. LLM プロバイダーの設定
AI チャットの使用を開始するには、少なくとも 1 つの LLM プロバイダーを設定する必要があります。詳しくは 初回チャット を参照してください。
Steam 版の違い
Steam 経由で Elftia をインストールする場合は、次の違いに注意してください。
| 項目 | 標準版 | Steam 版 |
|---|---|---|
| 更新方法 | アプリ内自動更新 (electron-updater) | Steam クライアント経由で更新 |
| インストールパス | ユーザー指定 | Steam ライブラリフォルダー |
| アンインストール方法 | システム設定 / コントロールパネル | Steam 経由でアンインストール |
| 機能 | 同一 | 同一 |
Steam 版の機能は標準版と同一です。異なるのは更新の仕組みのみです。
よくあるインストールの問題
インストーラーが起動しない
Windows: ウイルス対策ソフトウェアによってブロックされていないか確認してください。一部のウイルス対策プログラムは、Electron アプリケーションを誤って検出する場合があります。Elftia をウイルス対策ソフトウェアのホワイトリストに追加してください。
macOS: 「破損しているため開けません」というメッセージが表示される場合は、ターミナルで次を実行してください。
xattr -cr /Applications/Elftia.app
Linux: FUSE の依存関係がインストールされており、ファイルに実行権限があることを確認してください。
起動時に空白画面になる、またはクラッシュする
- グラフィックドライバーが最新バージョンに更新されていることを確認してください。
- 管理者権限で実行してみてください (Windows)。
- 別の Elftia インスタンスがすでに実行されていないか確認し、実行中であれば終了してください。
- 古い GPU を使用している場合は、起動時に
--disable-gpuパラメーターを追加してみてください。
.NET または Visual C++ ランタイムが不足している (Windows)
一部の Windows システムでは、必要なランタイムライブラリが不足している場合があります。Visual C++ Redistributable をインストールしてから、再試行してください。
ファイアウォールがインターネット接続をブロックしている
Elftia は LLM API を呼び出すためにインターネットアクセスを必要とします。ファイアウォールが Elftia の送信接続を許可していることを確認してください。プロキシ設定については、プロキシを使用する を参照してください。
インストールが完了したら、初回チャット を読み進めて、AI の利用を開始してください。