Skip to content

Installation ja

Jump to bottom
andershsueh edited this page Feb 10, 2026 · 1 revision

📖 他の言語: English | 中文 | 日本語

インストールガイド

このガイドでは、システムに ALICE をインストールする方法を説明します。

前提条件

  • Node.js: バージョン 18.0.0 以上
  • LLM バックエンド: 以下のいずれか:
    • LM Studio（ローカル使用に推奨）
    • Ollama
    • OpenAI API アカウント
    • OpenAI 互換 API

方法1: ビルド済みバイナリのダウンロード（推奨）

ダウンロード

リリースページにアクセスし、適切なバージョンをダウンロードしてください:

プラットフォーム ファイル 備考
Windows x64 alice-win-x64.zip 64ビット Windows 用
macOS Intel alice-macos-x64.tar.gz Intel Mac 用
macOS Apple Silicon alice-macos-arm64.tar.gz M1/M2/M3 Mac 用
Linux x64 alice-linux-x64.tar.gz 64ビット Linux 用

インストール手順

Windows

# zip ファイルを解凍
# alice.exe をダブルクリックするか、PowerShell から実行:
.\alice.exe

macOS / Linux

# 解凍
tar -xzf alice-*.tar.gz

# 実行権限を付与
chmod +x alice-*

# オプション: システムパスに移動
sudo mv alice-* /usr/local/bin/alice

# 実行
alice

方法2: ソースからインストール

ステップ1: リポジトリをクローン

git clone https://github.com/AndersHsueh/Alice.git
cd Alice

ステップ2: 依存関係をインストール

npm install

以下を含む必要なパッケージがインストールされます:

  • ink - CLI UI フレームワーク
  • axios - LLM API 用 HTTP クライアント
  • ajv - ツール用 JSON Schema バリデーション
  • glob - ファイル検索
  • simple-git - Git 操作

ステップ3: ビルド

npm run build

これにより TypeScript が dist/ ディレクトリ内の JavaScript にコンパイルされます。

ステップ4: 実行

# 開発モード（ライブ編集をサポート）
npm run dev

# 本番モード
npm start

# または直接実行
node dist/index.js

方法3: npm 経由でインストール（近日公開予定）

npm install -g alice-cli
alice

⚠️ 注意: npm パッケージの公開は将来のリリースで予定されています。

LLM バックエンドのセットアップ

オプション A: LM Studio（推奨）

  1. LM Studio をダウンロード: https://lmstudio.ai/
  2. インストールして起動: LM Studio をインストールし起動します
  3. モデルをダウンロード:
    • 「Search」タブをクリック
    • モデルを検索（例: "qwen", "llama", "mistral"）
    • お好みのモデルをダウンロード
  4. ローカルサーバーを起動:
    • 「Local Server」タブをクリック
    • モデルを読み込む
    • 「Start Server」をクリック
    • デフォルト URL: http://127.0.0.1:1234/v1

オプション B: Ollama

  1. Ollama をインストール: https://ollama.ai/
  2. モデルをプル: 
    ollama pull qwen2.5:7b
  3. Ollama を起動（通常は自動的に実行されます）
    • デフォルト URL: http://localhost:11434/v1

オプション C: OpenAI API

  1. API キーを取得: https://platform.openai.com/
  2. 環境変数を設定: 
    # macOS / Linux
export OPENAI_API_KEY="sk-xxxxx"

# Windows
set OPENAI_API_KEY=sk-xxxxx

インストールの確認

--help フラグを使って ALICE を実行してください:

alice --help

ヘルプメッセージが表示されれば、インストール成功です！

初回起動

初回起動時、ALICE は以下を実行します:

  1. ウェルカムバナーを表示（--no-banner でスキップ可能）
  2. ~/.alice/ に設定ディレクトリを作成
  3. デフォルトの settings.jsonc を生成
# 初回起動
alice

# またはバナーをスキップ
alice --no-banner

次のステップ

トラブルシューティング

"Cannot find module" エラー

まず npm install を実行したことを確認してください。

"Connection refused" エラー

LLM バックエンドが実行されていません。LM Studio または Ollama を起動してください。

macOS/Linux での Permission denied

chmod +x alice を実行して実行権限を追加してください。

その他の問題については、トラブルシューティングを参照してください。

Clone this wiki locally