インストール
このページでは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リポジトリにあります。
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:
curl -fsSL https://raw.githubusercontent.com/wsj-br/ai-i18n-tools/main/install.sh | bashWindows (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 x64 | ai-i18n-tools-linux-x64.gz |
| Linux arm64 | ai-i18n-tools-linux-arm64.gz |
| macOS arm64 | ai-i18n-tools-macos-arm64.gz |
| macOS x64 | ai-i18n-tools-macos-x64.gz |
| Windows x64 | ai-i18n-tools-win-x64.exe.gz |
- マシンに一致するアセットと
SHA256SUMS.txtを、GitHub Releases ページからダウンロードします。 - 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のハッシュと比較します。 - アーカイブを展開し、コマンドを
PATHに配置します。
LinuxとmacOS、Linux x64アセットを例として使用 (ダウンロードしたアセットに置き換えてください):
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) に追加して、新しいターミナルを開いてください:
export PATH="$HOME/.local/bin:$PATH"Windows (PowerShell)。GZipStreamはWindows PowerShellの一部であり、個別のgzipインストールは不要です。
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行を実行します。
# 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 に渡すプロバイダーに一致するキーを設定します (プリセットの表 を参照):
# 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キーがまだ設定されていない場合にのみ読み込まれます。
OPENROUTER_API_KEY=sk-or-v1-your-key-hereCLI の使用方法
プロジェクトに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 を参照):
PATH_add node_modules/.bindirenv allow の後、プロジェクトに cd すれば、いつでもコマンド単体が利用可能になります。
手動でのPATH設定 — これらをプロジェクトルート (node_modules/.bin を含むディレクトリ) から実行します。その後、PATH エントリをそのままにしておけば、サブディレクトリでも引き続き動作します。ネストされたフォルダーからエクスポートを再実行すると、$PWD がプロジェクトルートを指さなくなるため失敗します。
# bash/zsh — from the project root
export PATH="$PWD/node_modules/.bin:$PATH"
ai-i18n-tools sync# Windows PowerShell — from the project root
$env:Path = "$PWD\node_modules\.bin;$env:Path"
ai-i18n-tools syncグローバルインストール — CLIを一度インストールすれば、どのディレクトリからでも呼び出せます:
npm install -g ai-i18n-tools
# or
pnpm add -g ai-i18n-toolspnpmの場合、グローバルコマンドが見つからない場合はマシンごとに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を変更しなくても、スクリプト内でコマンド名単体で動作します:
"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を含む各スキルディレクトリ(フォルダー)をすべて取得します。
- Node.js 22.20以降:
npx skills add wsj-br/ai-i18n-tools --all -yはそれらのディレクトリをエージェントのスキルフォルダーにインストールします。 - パッケージがすでにインストールされている場合:
node_modules/ai-i18n-tools/skills/.をそのフォルダーにコピーします。 - 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のシャムを生成します。
次へ: クイックスタート。