इंस्टॉलेशन
यह पृष्ठ CLI को स्थापित करता है और ai-i18n-tools कमांड को काम करने योग्य बनाता है। पहले से स्थापित है? त्वरित शुरुआत पर जाएँ।
प्रकाशित पैकेज केवल ESM है। Node.js या अपने बंडलर में import या import() का उपयोग करें; require('ai-i18n-tools') का उपयोग न करें। पैकेज engines.node >=22.16.0 घोषित करता है; पुराने Node.js संस्करण असमर्थित हैं। npm टारबॉल में 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स्टैंडअलोन निष्पादन योग्य (Standalone executables)
GitHub रिलीज़ एक Node.js सिंगल-एक्सेक्यूटेबल बिल्ड संलग्न करते हैं। उस बाइनरी का उपयोग तब करें जब प्रोजेक्ट Node.js पर न चलता हो। Python और .NET प्रोजेक्ट इससे वही CLI चलाते हैं, जिसमें extract, translate-ui, और suggest-models शामिल हैं, बिना किसी Node.js इंस्टॉलेशन के।
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इंस्टॉलर सिस्टम का पता लगाता है, मिलान करने योग्य निष्पादन योग्य (executable) का एक gzip आर्काइव डाउनलोड करता है, SHA256SUMS.txt की जाँच करता है, इसे अनपैक करता है, कमांड को ai-i18n-tools के रूप में इंस्टॉल करता है (Windows पर ai-i18n-tools.exe), और इंस्टॉल डायरेक्टरी को PATH में जोड़ता है। Linux और macOS gzip के साथ अनपैक करते हैं। Windows PowerShell .NET gzip रीडर के साथ अनपैक करता है, जो पहले से ही Windows का हिस्सा है। डिफ़ॉल्ट डायरेक्टरी ~/.local/bin है। यदि कमांड अभी तक नहीं मिली है, तो एक नया टर्मिनल खोलें। किसी रिलीज़ को पिन करने के लिए AI_I18N_VERSION (उदाहरण के लिए v1.11.0) सेट करें, या किसी अन्य डायरेक्टरी को चुनने के लिए AI_I18N_INSTALL_DIR सेट करें। gzip आर्काइव से पहले प्रकाशित रिलीज़ में अभी भी कच्चा निष्पादन योग्य (raw executable) होता है, और इंस्टॉलर उस फ़ाइल को स्वीकार करता है।
बाइनरीज़ नोटराइज़्ड या ऑथेंटिकोड-साइन नहीं हैं। macOS आपसे एक अहस्ताक्षरित प्रोग्राम को मंज़ूरी देने के लिए कह सकता है। Windows SmartScreen एक चेतावनी दिखा सकता है। चेकसम मेल खाने के बाद macOS इंस्टॉलर क्वारंटाइन फ़्लैग को हटा देता है।
प्रत्येक रिलीज़ SHA256SUMS.txt, ai-i18n-tools-python-examples.zip (चार Python उदाहरण), और ai-i18n-tools-dotnet-examples.zip (dotnet-console, dotnet-resx, और assets/dotnet हेल्पर जो उन प्रोजेक्ट्स को कंपाइल करते हैं) भी संलग्न करती है। .NET आर्काइव से पहले प्रकाशित रिलीज़ में यह शामिल नहीं है। उस रिलीज़ से जो स्किल आर्काइव जोड़ती है, उसी पेज में ai-i18n-tools-skill.zip, हर कोडिंग-एजेंट स्किल डायरेक्टरी शामिल है। उस स्किल ज़िप से पहले प्रकाशित रिलीज़ में यह शामिल नहीं है, और पहली स्किल ज़िप में केवल ai-i18n-tools/ है। install.sh और install.ps1 रिपॉजिटरी रूट में रहते हैं, और ऊपर दिए गए कमांड उन्हें वहीं से डाउनलोड करते हैं। npm टारबॉल और एक्सेक्यूटेबल में उदाहरण आर्काइव या स्किल ज़िप शामिल नहीं हैं। उदाहरण रिपॉजिटरी में रहते हैं। स्किल डायरेक्टरी npm टारबॉल के अंदर हैं। कोडिंग-एजेंट स्किल देखें।
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 रिलीज़ पेज से डाउनलोड करें। - 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 syncinit का उपयोग केवल एक नए कॉन्फ़िगरेशन के लिए करें: यह चयनित कॉन्फ़िग फ़ाइल को अधिलेखित कर देता है। मौजूदा प्रोजेक्ट्स के लिए, इसके बजाय कॉन्फ़िग को संपादित करें। 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या ai-i18n-tools.config.json के बगल में एक .env या .env.local फ़ाइल बनाएँ। ये फ़ाइलें केवल तभी पढ़ी जाती हैं जब कोई प्रदाता API कुंजी पहले से सेट न हो:
OPENROUTER_API_KEY=sk-or-v1-your-key-hereCLI का उपयोग करना
अपने प्रोजेक्ट में ai-i18n-tools को एक डिपेंडेंसी या devDependency के रूप में स्थापित करें (इस पृष्ठ के शीर्ष पर देखें)। यदि ऐप कोड ai-i18n-tools/runtime को इम्पोर्ट करता है, तो इसे प्रोडक्शन रनटाइम/बिल्ड वातावरण में उपलब्ध रखें; एक वैश्विक CLI या स्टैंडअलोन बाइनरी उस इम्पोर्ट को पूरा नहीं कर सकता। पैकेज एक bin एंट्री घोषित करता है जिसे आपका पैकेज मैनेजर node_modules/.bin/ai-i18n-tools से लिंक करता है। वह शिम (स्थापित पैकेज के अंदर 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 के साथ, pnpm setup को एक बार प्रति मशीन (और एक नया शेल खोलें) चलाएं यदि वैश्विक कमांड गायब हैं — pnpm को 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 … (एनपीएम) या pnpm exec ai-i18n-tools … (पीएनपीएम)। बिना किसी package.json प्रविष्टि के एक बार के शून्य-इंस्टॉल के लिए: 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 टारबॉल सेpackage/skills/निकालें। जिस रिलीज़ से इसे जोड़ा गया है, उस GitHub रिलीज़ परai-i18n-tools-skill.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में लिंक नहीं करता है। इस चेकआउट का.envrcbin/को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 पर, पैकेज मैनेजर .cmd और .ps1 शिम उत्पन्न करते हैं जो Node को स्पष्ट रूप से इनवोक करते हैं।
अगला: त्वरित शुरुआत।