AI Localizator v1.0.0

AI Localizator is a Visual Studio Code extension designed to assist developers in translating text efficiently using AI models and APIs.

✨ What's New in v1.0.0

🔒 Enhanced Security

• Secure API Key Storage: API keys are now stored using VS Code's secure storage system
• Input Validation: Validation for all user inputs and API endpoints
• Provider Detection: Automatic detection and validation of supported translation providers

🎨 Improved User Experience

• Progress Indicators: Real-time translation progress with visual feedback
• Status Bar Integration: Shows current provider status and configuration state
• Keyboard Shortcuts: Quick access with Ctrl+Shift+T (translate), Ctrl+Shift+P (popup), Ctrl+Shift+H (history)
• Translation History: Complete history of translations with undo functionality
• Popup Translation: Option to preview translations before applying them

🏗️ Better Architecture

• Modular Design: Clean separation of concerns with dedicated modules for each provider
• Utility Functions: Eliminated code duplication with reusable utility functions

🚀 Performance & Reliability

• Optimized Code: Reduced codebase size by 37% through utility extraction
• Comprehensive Testing: 104+ tests ensuring reliability and stability

Supported Services

• Translation APIs
  • Microsoft Translator
  • Google Cloud Translator
  • DeepL
  • M2M-100 (CloudFlare)
• LLMs
  • Anthropic (Claude 4.5 Sonnet)
  • OpenAI (GPT-5, GPT-4o)
  • OpenAI Azure (GPT-4, GPT-4o)

Required Settings variables

To find Visual Studio Code extension settings, open Command Palette (Ctrl+Shift+P or Cmd+Shift+P on macOS), type Preferences: Open Settings (UI), then search for the Ai-localizator, or go to the Extensions view (Ctrl+Shift+X or Cmd+Shift+X), find the extension, click the gear icon next to it, and select Extension Settings.

Settings examples

Microsoft Translator

• apiEndpoint - https://api.cognitive.microsofttranslator.com/translate.
• apiKey - YOUR-API-KEY
• langTo - Specifies the target language for translation using ISO 639-1 codes (e.g., lt for Lithuanian).

Create Resource and get API key

Google Cloud Translate

• apiEndpoint - https://translation.googleapis.com/language/translate/v2.
• apiKey - YOUR-API-KEY
• langTo - Specifies the target language for translation using ISO 639-1 codes (e.g., lt for Lithuanian).

Get API key

DeepL

• apiEndpoint - https://api-free.deepl.com/v2/translate or https://api.deepl.com/v2/translate.
• apiKey - YOUR-API-KEY
• langTo - Specifies the target language for translation using ISO 639-1 codes (e.g., lt for Lithuanian).

Get API key

M2M-100 (CloudFlare)

• apiEndpoint - https://api.cloudflare.com/client/v4/accounts/*ACCOUNT-ID*/ai/run/@cf/meta/m2m100-1.2b.
• apiKey - YOUR-API-KEY
• langFrom - Specifies the source language for translation using ISO 639-1 codes (e.g., en for English).
• langTo - Specifies the target language for translation using ISO 639-1 codes (e.g., lt for Lithuanian).

Get Account ID and API token

Anthropic (Claude 4.5 Sonnet)

• apiEndpoint - https://api.anthropic.com/v1/messages.
• apiKey - YOUR-API-KEY
• modelName - Specifies the AI model (e.g., claude-4.5-sonnet).
• modelVersion - Specifies the AI model (e.g., 2023-06-01).
• maxTokens - Specifies the maximum number of tokens that the AI model can generate in its response (e.g., 500).
• prompt - Provides instructions to the AI (e.g., Translate provided text into English).

Get API key

OpenAI (GPT-5, GPT-4o)

• apiEndpoint - https://api.openai.com/v1/chat/completions.
• apiKey - YOUR-API-KEY
• modelName - Specifies the OpenAI model (e.g., gpt-5, gpt-4o).
• maxTokens - Specifies the maximum number of tokens that the AI model can generate in its response (e.g., 500).
• prompt - Provides instructions to the AI (e.g., Translate provided text into English).

Get API key

OpenAI Azure (GPT-4, GPT-4o)

• apiEndpoint - https://*ACCOUNT*.openai.azure.com/openai/deployments/*DEPLOYMENT*/chat/completions?api-version=*API-VERSION*.
• apiKey - YOUR-API-KEY
• maxTokens - Specifies the maximum number of tokens that the AI model can generate in its response (e.g., 500).
• prompt - Provides instructions to the AI (e.g., Translate provided text into English).

Create Resource and get API key

🚀 Quick Start

1. Configuration

1. Open VS Code settings (Ctrl+Shift+P → "Preferences: Open Settings (UI)")
2. Search for "AI Localizator"
3. Set your apiEndpoint for your chosen provider
4. Use Ctrl+Shift+P → "AI Localizator: Configure API Key" to securely store your API key

2. Translation Methods

• Quick Translate: Select text → Ctrl+Shift+T (or right-click → "AI Localizator: Translate Text")
• Preview Mode: Select text → Ctrl+Shift+P (or right-click → "AI Localizator: Translate Text (Popup)")
• View History: Ctrl+Shift+H (or Command Palette → "AI Localizator: Show Translation History")

3. Status Bar

• Click the status bar icon (🌐) to open settings
• Status shows your current provider and configuration state
• Warning icon appears if API key is missing

📋 Available Commands

🔧 Advanced Features

Translation History

• Automatically stores last 50 translations
• View original text, translation, provider, languages, and timestamp
• Copy original or translated text to clipboard
• Apply previous translations to current document
• Delete individual history entries

Popup Translation Mode

• Preview translations before applying
• Choose to replace text, copy to clipboard, or cancel

Status Bar Integration

• Real-time provider status display
• Configuration validation indicators
• Quick access to settings
• Progress indicators during translation