Skip to content

インストール ​

このページではCLIをインストールし、ai-i18n-tools コマンド単体が動作するようにします。インストール済みの場合は、クイックスタート に進んでください。

公開されているパッケージはESM専用です。Node.jsまたはバンドラーでimportまたはimport()を使用してください。require('ai-i18n-tools')は使用しないでください。このパッケージはengines.node >=22.16.0を宣言しており、古いNode.jsバージョンはサポートされていません。npm tarballには、docs/ai-i18n-tools-context.mdにあるコンシューマーコンテキストと完全なskills/ツリーが含まれており、完全なドキュメントサイトは含まれていません。translated-docs/以下のロケール固有のコピーは、GitHubリポジトリにあります。

bash
npm install ai-i18n-tools
# or
pnpm add ai-i18n-tools
# or
yarn add ai-i18n-tools

スタンドアロン実行ファイル ​

GitHubリリースにはNode.jsの単一実行可能ビルドが添付されています。プロジェクトがNode.jsで実行されない場合は、そのバイナリを使用してください。Pythonおよび.NETプロジェクトは、Node.jsのインストールなしで、extract、translate-ui、およびsuggest-modelsを含む同じCLIをそこから実行できます。

LinuxおよびmacOS:

bash
curl -fsSL https://raw.githubusercontent.com/wsj-br/ai-i18n-tools/main/install.sh | bash

Windows (PowerShell):

powershell
irm https://raw.githubusercontent.com/wsj-br/ai-i18n-tools/main/install.ps1 | iex

インストーラーはシステムを検出し、一致する実行可能ファイルのgzipアーカイブをダウンロードし、SHA256SUMS.txtをチェックし、それを展開し、コマンドをai-i18n-toolsとしてインストールし(Windowsではai-i18n-tools.exe)、インストールディレクトリをPATHに追加します。LinuxとmacOSはgzipで展開します。Windows PowerShellは、Windowsに既に含まれている.NET gzipリーダーで展開します。デフォルトのディレクトリは~/.local/binです。コマンドがまだ見つからない場合は、新しいターミナルを開いてください。リリースを固定するにはAI_I18N_VERSION(例: v1.11.0)を設定するか、別のディレクトリを選択するにはAI_I18N_INSTALL_DIRを設定します。gzipアーカイブより前に公開されたリリースには、まだ生の実行可能ファイルが含まれており、インストーラーはそのファイルを受け入れます。

バイナリは公証されておらず、Authenticode署名もされていません。macOSは、署名されていないプログラムの承認を求める場合があります。Windows SmartScreenは警告を表示する場合があります。macOSインストーラーは、チェックサムが一致した後、隔離フラグをクリアします。

各リリースには、さらにSHA256SUMS.txt、ai-i18n-tools-python-examples.zip(4つのPythonサンプル)、およびai-i18n-tools-dotnet-examples.zip(dotnet-console、dotnet-resx、およびそれらのプロジェクトがコンパイルするassets/dotnetヘルパー)が添付されています。.NETアーカイブより前に公開されたリリースには、それは含まれていません。スキルアーカイブが追加されたリリース以降、同じページに、すべてのコーディングエージェントスキルディレクトリであるai-i18n-tools-skill.zipが含まれています。そのスキルzipより前に公開されたリリースには、それは含まれておらず、最初のスキルzipにはai-i18n-tools/のみが含まれています。install.shとinstall.ps1はリポジトリのルートにあり、上記のコマンドはそこからそれらをダウンロードします。npm tarballと実行可能ファイルには、サンプルアーカイブやスキルzipは含まれていません。サンプルはリポジトリに残ります。スキルディレクトリはnpm tarball内にあります。コーディングエージェントスキルを参照してください。

ai-i18n-tools 実行可能ファイルの手動インストール手順
プラットフォームアセット
Linux x64ai-i18n-tools-linux-x64.gz
Linux arm64ai-i18n-tools-linux-arm64.gz
macOS arm64ai-i18n-tools-macos-arm64.gz
macOS x64ai-i18n-tools-macos-x64.gz
Windows x64ai-i18n-tools-win-x64.exe.gz
  1. マシンに一致するアセットとSHA256SUMS.txtを、GitHub Releases ページからダウンロードします。
  2. gzipアーカイブのチェックサムを確認します。Linuxでは、grep ' ai-i18n-tools-linux-x64.gz$' SHA256SUMS.txt | sha256sum -c -(ダウンロードしたアセット名を使用してください)。macOSでは、shasum -a 256 -c -と同じ行です。Windowsでは、(Get-FileHash -Algorithm SHA256 .\ai-i18n-tools-win-x64.exe.gz).Hashを実行し、SHA256SUMS.txtのハッシュと比較します。
  3. アーカイブを展開し、コマンドをPATHに配置します。

LinuxとmacOS、Linux x64アセットを例として使用 (ダウンロードしたアセットに置き換えてください):

bash
mkdir -p "$HOME/.local/bin"
gzip -dc ai-i18n-tools-linux-x64.gz > "$HOME/.local/bin/ai-i18n-tools"
chmod +x "$HOME/.local/bin/ai-i18n-tools"

$HOME/.local/bin がまだ PATH に含まれていない場合は、これをシェルプロファイル (.bashrc、.bash_profile、.profile、または .zshrc) に追加して、新しいターミナルを開いてください:

bash
export PATH="$HOME/.local/bin:$PATH"

Windows (PowerShell)。GZipStreamはWindows PowerShellの一部であり、個別のgzipインストールは不要です。

powershell
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.local\bin" | Out-Null
Add-Type -AssemblyName System.IO.Compression
$gz = [System.IO.File]::OpenRead("$PWD\ai-i18n-tools-win-x64.exe.gz")
$outPath = "$env:USERPROFILE\.local\bin\ai-i18n-tools.exe"
try {
  $gzipStream = New-Object System.IO.Compression.GZipStream($gz, [System.IO.Compression.CompressionMode]::Decompress)
  try {
    $out = [System.IO.File]::Create($outPath)
    try { $gzipStream.CopyTo($out) } finally { $out.Dispose() }
  } finally { $gzipStream.Dispose() }
} finally { $gz.Dispose() }
$installDir = "$env:USERPROFILE\.local\bin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
if ([string]::IsNullOrEmpty($userPath)) {
  [Environment]::SetEnvironmentVariable("Path", $installDir, "User")
} elseif ($userPath -notlike "*${installDir}*") {
  [Environment]::SetEnvironmentVariable("Path", "$installDir;$userPath", "User")
}

新しいターミナルを開き、ai-i18n-tools --version を実行します。コマンド名はすべてのプラットフォームで ai-i18n-tools です。

アクティブなプロバイダーのAPIキーは、npmインストールと同じ方法で設定します(下記参照)。次に、プロジェクトのinitテンプレートを選択して翻訳します。Pythonプロジェクトは-t ui-pythonを使用します。.NETプロジェクトは-t ui-dotnetを使用します。すでにResourceManagerまたはIStringLocalizerで文字列をロードしているアプリは-t ui-dotnet-resxを使用します。以下のinit行を実行します。

bash
# Python
ai-i18n-tools init -t ui-python -P cheaperinference
# .NET
# ai-i18n-tools init -t ui-dotnet -P cheaperinference
# .NET ResourceManager or IStringLocalizer
# ai-i18n-tools init -t ui-dotnet-resx -P cheaperinference
ai-i18n-tools suggest-models --apply
ai-i18n-tools sync

新しい設定の場合にのみinitを使用してください。これは選択された設定ファイルを上書きします。既存のプロジェクトの場合は、代わりに設定を編集してください。syncは、UI抽出を含む、設定済み/有効化されたすべての翻訳パイプラインを処理します。

ウォークスルー:Pythonアプリにi18nを追加する、.NETアプリにi18nを追加する、および.NET ResourceManagerアプリにi18nを追加する。コマンドリファレンス:suggest-models。

APIキーを設定する ​

翻訳コマンド (translate-ui、translate-docs、translate-json、translate-svg、sync) には、ai-i18n-tools.config.json でのプロバイダー設定と、アクティブなプロバイダーの API キーが必要です。ai-i18n-tools init -P <provider> を実行して、そのプリセットをスキャフォールドしてください。プロバイダーのプリセットと API キー: LLM プロバイダー。init のモデルリストは出発点です。AI モデル を参照して、suggest-models またはダッシュボードの モデル タブで置き換えてください。Ollama は、API キーが不要な唯一の組み込みプリセットです。

init に渡すプロバイダーに一致するキーを設定します (プリセットの表 を参照):

bash
# init -P openrouter
export OPENROUTER_API_KEY=sk-or-v1-your-key-here
# init -P openai
# export OPENAI_API_KEY=sk-your-key-here

または、.env または .env.local ファイルを ai-i18n-tools.config.json の隣に作成します。これらのファイルは、プロバイダーAPIキーがまだ設定されていない場合にのみ読み込まれます。

env
OPENROUTER_API_KEY=sk-or-v1-your-key-here

CLI の使用方法 ​

プロジェクトにai-i18n-toolsを依存関係または開発依存関係としてインストールしてください(このページの上部を参照)。アプリケーションコードがai-i18n-tools/runtimeをインポートする場合、本番ランタイム/ビルド環境で利用できるようにしてください。グローバルCLIまたはスタンドアロンバイナリではそのインポートを満たすことはできません。このパッケージは、パッケージマネージャーがnode_modules/.bin/ai-i18n-toolsにリンクするbinエントリを宣言しています。そのシム(インストールされたパッケージ内のbin/ai-i18n-tools.mjs)がコンパイルされたCLIをロードします。

インタラクティブシェルで ai-i18n-tools コマンド単体を入力するには、以下のいずれかのオプションを設定してください。設定を行わない場合、ローカルインストール後であってもシェルはバイナリを見つけることができません。

direnv — プロジェクトルートの .envrc に追加します (bash/zsh; direnv.net を参照):

bash
PATH_add node_modules/.bin

direnv allow の後、プロジェクトに cd すれば、いつでもコマンド単体が利用可能になります。

手動でのPATH設定 — これらをプロジェクトルート (node_modules/.bin を含むディレクトリ) から実行します。その後、PATH エントリをそのままにしておけば、サブディレクトリでも引き続き動作します。ネストされたフォルダーからエクスポートを再実行すると、$PWD がプロジェクトルートを指さなくなるため失敗します。

bash
# bash/zsh — from the project root
export PATH="$PWD/node_modules/.bin:$PATH"
ai-i18n-tools sync
powershell
# Windows PowerShell — from the project root
$env:Path = "$PWD\node_modules\.bin;$env:Path"
ai-i18n-tools sync

グローバルインストール — CLIを一度インストールすれば、どのディレクトリからでも呼び出せます:

bash
npm install -g ai-i18n-tools
# or
pnpm add -g ai-i18n-tools

pnpmの場合、グローバルコマンドが見つからない場合はマシンごとに1回pnpm setupを実行し(新しいシェルを開いてください)— pnpmはそのグローバルbinディレクトリをPATHに配置する必要があります。グローバルインストールでは、グローバルに固定されたバージョンが使用されます。プロジェクトごとのバージョン固定には、direnvまたは手動PATHを推奨します。これにより、node_modules/.binがプロジェクトの依存関係に解決されるようになります。

既存のインストールを ai-i18n-tools upgrade でアップグレードします。このコマンドは新しいバージョンを表示し、y を待ちます。--yes を使用すると、プロンプトをスキップできます。プロジェクトの依存関係は package.json で更新され、npm、pnpm、yarn、または bun を使用してインストールされます。グローバルな Node.js インストールは、そのパッケージマネージャーのグローバルインストールを使用します。スタンドアロンの実行可能ファイルは、SHA256 チェックサムが一致した後、現在のオペレーティングシステムとアーキテクチャ用の GitHub リリースビルドに置き換えられます。アップグレード を参照してください。

package.jsonのスクリプト — npmまたはpnpmがスクリプトを実行すると、node_modules/.bin が PATH の前に追加されるため、シェルのPATHを変更しなくても、スクリプト内でコマンド名単体で動作します:

json
"scripts": {
  "i18n:extract": "ai-i18n-tools extract",
  "i18n:sync": "ai-i18n-tools sync",
  "i18n:dashboard": "ai-i18n-tools dashboard"
}

次に、pnpm run i18n:syncなどを実行します。推奨される完全なセットについては、推奨されるpackage.jsonスクリプトを参照してください。

代替案 — PATHを調整したくない場合: npx ai-i18n-tools … (npm) または pnpm exec ai-i18n-tools … (pnpm)。package.jsonエントリなしで、ゼロインストールで1回限り実行する場合: npx ai-i18n-tools <cmd>またはpnpm dlx ai-i18n-tools <cmd>。

コーディングエージェントスキル ​

npmパッケージまたはスタンドアロン実行可能ファイルをインストールしても、スキルはエージェントに登録されません。インストール方法、ネイティブカタログ、およびスキルフォルダーを持たないエージェントについては、コーディングエージェントスキルを参照してください。

このリポジトリをクローンせずに、SKILL.mdを含む各スキルディレクトリ(フォルダー)をすべて取得します。

  1. Node.js 22.20以降: npx skills add wsj-br/ai-i18n-tools --all -yはそれらのディレクトリをエージェントのスキルフォルダーにインストールします。
  2. パッケージがすでにインストールされている場合: node_modules/ai-i18n-tools/skills/.をそのフォルダーにコピーします。
  3. Node.jsがない場合: ai-i18n-tools --versionのバージョンに対応するnpm tarballからpackage/skills/を抽出します。それが追加されたリリース以降、そのGitHubリリースにあるai-i18n-tools-skill.zipには同じディレクトリが含まれています。そのzipより前に公開されたリリースには含まれていません。最初のzipにはai-i18n-tools/のみが含まれています。

コマンドとエージェントフォルダーについては、コーディングエージェントスキルを参照してください。

クローンしたモノレポ ​

ai-i18n-toolsの完全なクローンからパッケージを開発したり、ワークスペースのサンプルを実行したりする場合:

  • ワークスペースのサンプル (examples/console-app、examples/nextjs-app、およびpnpm-workspace.yamlにリストされているその他のパッケージ) — リポジトリのルートでpnpm installを実行し、次にcd examples/<name>を実行します。サンプルのpnpm run i18n:*スクリプトを使用するか、PATHを設定して(CLIの使用を参照)、ai-i18n-tools …を直接実行します。ワークスペースのoverridesは、ai-i18n-toolsをローカルのチェックアウトにリンクします。
  • リポジトリのルート — pnpmは、ルートパッケージ自身のbinをnode_modules/.binにリンクしません。このチェックアウトの.envrcはbin/をPATHに追加するため、コミットされたbin/ai-i18n-toolsラッパー (公開されたbin/ai-i18n-tools.mjsシムの横) はdirenv allowの後に直接コマンドを提供します。direnvがない場合は、node bin/ai-i18n-tools.mjs …、./bin/ai-i18n-tools …、またはルートのpnpm i18n:*スクリプト (あるいはシェルのエイリアス / pnpm add -g .) を使用します。
  • スタンドアロンのフィクスチャ (multi-provider、test-markdown) — フィクスチャのフォルダーから、node ../../bin/ai-i18n-tools.mjs …を使用します。

CLI ソースを変更した後、リポジトリルートで pnpm run build を実行します。ビルド手順やオプションのグローバルインストールの回避策については、開発ガイド を参照してください。

Linux、macOS、およびWSLでは、レジストリからのインストールによりCLIスクリプトの実行ビットが自動的に設定されます。Windowsでは、パッケージマネージャーがNodeを明示的に呼び出す.cmdおよび.ps1のシャムを生成します。

次へ: クイックスタート。

MITライセンスの下で公開されています。