loren-code 0.1.0 → 0.1.2

package/README.md

@@ -1,45 +1,29 @@
-# LOREN CODE
+# loren-code
 
-Ollama Cloud model manager and local bridge for Claude Code, with dynamic model switching, API key rotation, and first-run bootstrap.
+`loren-code` installs the `loren` CLI for working with a local Ollama Cloud bridge.
 
-## Features
+It is built to rotate multiple Ollama Cloud API keys, including the common setup where users configure more than one free-tier key for longer uninterrupted bridge usage.
 
-- Dynamic model switching without restarting the server
-- Live model list fetched from Ollama Cloud
-- API key add/remove/rotate commands
-- First-run setup for `.env.local` and `.runtime`
-- Local bridge on port `8788`
-- Claude Code wrapper support
+Loren manages rotation and failover, but it does not bypass upstream limits or service terms.
 
-## Quick Start
-
-### Prerequisites
-
-- Node.js 18+
-- Ollama Cloud API key(s)
-
-### Clone And Run Locally
+## Install
 
 ```bash
-git clone https://github.com/lorenzune/loren-code.git
-cd loren-code
-npm install
-node scripts/loren.js help
+npm install -g loren-code
 ```
 
-If `.env.local` is missing, Loren creates it automatically from `.env.example`.
-You still need to add real `OLLAMA_API_KEYS`.
-
-### Install From npm
+Verify:
 
 ```bash
-npm install -g loren-code
 loren help
 ```
 
-The published package exposes `loren` via the `bin` field automatically.
+## First Run
 
-## Configuration
+Loren creates `.env.local` automatically if it does not exist.
+
+You must add valid `OLLAMA_API_KEYS` before the bridge can make upstream requests.
+If you configure multiple keys, Loren rotates them automatically.
 
 Example `.env.local`:
 
@@ -52,16 +36,17 @@ DEFAULT_MODEL_ALIAS=gpt-oss:20b
 OLLAMA_MODEL_ALIASES={"ollama-free-auto":"gpt-oss:20b","ollama-free-fast":"gemma3:12b"}
 ```
 
-## Usage
-
-### CLI
+## Main Commands
 
 ```bash
 loren help
 loren config:show
 loren status
+loren start
+loren stop
 loren model:list
 loren model:set gpt-oss:20b
+loren model:current
 loren model:refresh
 loren keys:list
 loren keys:add sk-your-new-key
@@ -69,56 +54,34 @@ loren keys:remove 0
 loren keys:rotate
 ```
 
-### Server
-
-```bash
-npm start
-```
-
-or:
+## Start The Bridge
 
 ```bash
 loren start
-loren stop
-loren status
 ```
 
-## Bridge Endpoints
-
-- `GET /health`
-- `GET /v1/models`
-- `GET /v1/models?refresh=true`
-- `POST /v1/refresh`
-- `POST /v1/messages`
-- `POST /v1/messages/count_tokens`
-- `GET /metrics`
-- `GET /dashboard`
-
-## Claude Code Integration
+The local bridge runs on:
 
-1. Start the bridge.
-2. Point Claude Code to `http://127.0.0.1:8788`.
-3. Use `loren model:set` to switch model aliases.
-4. Use `loren model:refresh` to refresh the model list.
+```text
+http://127.0.0.1:8788
+```
 
 ## Troubleshooting
 
-### `Command not found: loren`
+### `loren` not found
 
-Install the package globally:
+Make sure the package was installed globally:
 
 ```bash
 npm install -g loren-code
 ```
 
-If you are working from a local clone, use `node scripts/loren.js ...`.
-
 ### `npm` blocked in PowerShell
 
-Use `npm.cmd` instead:
+Use:
 
 ```powershell
-npm.cmd run help
+npm.cmd install -g loren-code
 ```
 
 ### Missing API keys
@@ -129,25 +92,8 @@ Populate `OLLAMA_API_KEYS` in `.env.local`.
 
 Change `BRIDGE_PORT` in `.env.local`.
 
-## Project Structure
-
-```text
-loren-code/
-|- scripts/
-|  |- loren.js
-|  |- claude-wrapper.js
-|  `- install-claude-ollama.ps1
-|- src/
-|  |- bootstrap.js
-|  |- server.js
-|  |- config.js
-|  |- key-manager.js
-|  `- ...
-|- .env.example
-|- package.json
-`- README.md
-```
+## Repository
 
-## License
+Source code and project documentation:
 
-MIT
+https://github.com/lorenzune/loren-code

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loren-code",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Ollama Cloud Model Manager - Dynamic model switching, API key rotation, and real-time configuration updates",
   "author": "lorenzune",
   "license": "MIT",
@@ -55,6 +55,8 @@
     "help": "node scripts/loren.js help",
     "smoke": "node scripts/smoke-test.js",
     "check:publish": "node scripts/publish-check.js",
+    "prepack": "node scripts/sync-readme.js npm",
+    "postpack": "node scripts/sync-readme.js github",
     "prepublishOnly": "npm test && npm run lint",
     "test": "node scripts/publish-check.js",
     "lint": "node -e \"console.log('No linter configured')\""

package/scripts/install-claude-ollama.ps1

@@ -12,7 +12,7 @@ $launcherExePath = Join-Path $repoRoot "scripts\\ClaudeWrapperLauncher.exe"
 $envPath = Join-Path $repoRoot ".env.local"
 
 if (-not (Test-Path $envPath)) {
-  throw ".env.local non trovato. Crea prima il file con OLLAMA_API_KEYS."
+  throw ".env.local not found. Create it first with OLLAMA_API_KEYS."
 }
 
 New-Item -ItemType Directory -Force -Path $workspaceSettingsDir | Out-Null
@@ -70,6 +70,19 @@ function Get-EnvValue {
 }
 
 function Get-CSharpCompiler {
+  $command = Get-Command csc -ErrorAction SilentlyContinue
+  if ($command -and $command.Source -and (Test-Path $command.Source)) {
+    return $command.Source
+  }
+
+  $runtimeDir = [Runtime.InteropServices.RuntimeEnvironment]::GetRuntimeDirectory()
+  if (-not [string]::IsNullOrWhiteSpace($runtimeDir)) {
+    $runtimeCandidate = Join-Path $runtimeDir "csc.exe"
+    if (Test-Path $runtimeCandidate) {
+      return $runtimeCandidate
+    }
+  }
+
   $candidates = @(
     "C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe",
     "C:\Windows\Microsoft.NET\Framework\v4.0.30319\csc.exe"
@@ -81,7 +94,7 @@ function Get-CSharpCompiler {
     }
   }
 
-  throw "Compilatore C# non trovato. Impossibile generare il launcher .exe."
+  throw "C# compiler not found. Unable to generate the launcher .exe."
 }
 
 function Get-OllamaAvailableModels {
@@ -133,7 +146,7 @@ function Get-OllamaAvailableModels {
       }
     }
   } catch {
-    Write-Warning "Impossibile caricare la lista modelli da Ollama Cloud. Continuo con alias e target locali."
+    Write-Warning "Unable to load the model list from Ollama Cloud. Continuing with local aliases and targets."
   }
 
   return $models
@@ -143,21 +156,51 @@ $compilerPath = Get-CSharpCompiler
 & $compilerPath "/nologo" "/target:exe" "/out:$launcherExePath" $launcherSourcePath | Out-Null
 if ($LASTEXITCODE -ne 0 -or -not (Test-Path $launcherExePath)) {
   if (Test-Path $launcherExePath) {
-    Write-Warning "Compilazione launcher fallita, ma uso il launcher esistente."
+    Write-Warning "Launcher compilation failed, but an existing launcher will be used."
   } else {
-    throw "Compilazione del launcher fallita."
+    throw "Launcher compilation failed."
   }
 }
 
 $workspaceSettings = Read-JsonFile -Path $workspaceSettingsPath
+$bridgeHost = Get-EnvValue -Path $envPath -Name "BRIDGE_HOST"
+if (-not $bridgeHost) {
+  $bridgeHost = "127.0.0.1"
+}
+
+$bridgePort = Get-EnvValue -Path $envPath -Name "BRIDGE_PORT"
+if (-not $bridgePort) {
+  $bridgePort = "8788"
+}
+
+$bridgeBaseUrl = "http://${bridgeHost}:${bridgePort}"
+
 $workspaceSettings["claudeCode.claudeProcessWrapper"] = $launcherExePath
 $workspaceSettings["claudeCode.disableLoginPrompt"] = $true
+$workspaceSettings["claudeCode.environmentVariables"] = @(
+  @{
+    name = "ANTHROPIC_BASE_URL"
+    value = $bridgeBaseUrl
+  },
+  @{
+    name = "ANTHROPIC_API_KEY"
+    value = "bridge-local"
+  },
+  @{
+    name = "ANTHROPIC_AUTH_TOKEN"
+    value = ""
+  },
+  @{
+    name = "CLAUDE_CODE_SKIP_AUTH_LOGIN"
+    value = "1"
+  }
+)
 Write-JsonFile -Path $workspaceSettingsPath -Data $workspaceSettings
 
 $claudeSettings = Read-JsonFile -Path $claudeSettingsPath
 $aliasJson = Get-EnvValue -Path $envPath -Name "OLLAMA_MODEL_ALIASES"
 if (-not $aliasJson) {
-  throw "OLLAMA_MODEL_ALIASES non trovato in .env.local"
+  throw "OLLAMA_MODEL_ALIASES not found in .env.local"
 }
 
 $parsedAliases = $aliasJson | ConvertFrom-Json
@@ -168,7 +211,7 @@ foreach ($property in $parsedAliases.PSObject.Properties) {
 $availableModels = Get-OllamaAvailableModels -EnvPath $envPath -Aliases $aliases
 
 if ($availableModels.Count -eq 0) {
-  throw "OLLAMA_MODEL_ALIASES non contiene modelli"
+  throw "OLLAMA_MODEL_ALIASES does not contain any models"
 }
 
 $defaultModel = if ($aliases.ContainsKey("ollama-free-auto")) { "ollama-free-auto" } else { $availableModels[0] }
@@ -176,9 +219,9 @@ $claudeSettings["model"] = $defaultModel
 $claudeSettings["availableModels"] = $availableModels
 Write-JsonFile -Path $claudeSettingsPath -Data $claudeSettings
 
-Write-Host "Installazione completata."
-Write-Host "Launcher Claude:" $launcherExePath
+Write-Host "Installation completed."
+Write-Host "Claude launcher:" $launcherExePath
 Write-Host "VS Code user settings:" $workspaceSettingsPath
 Write-Host "Claude user settings:" $claudeSettingsPath
 Write-Host ""
-Write-Host "Riavvia VS Code. Claude Code usera il bridge in qualsiasi progetto."
+Write-Host "Restart VS Code. Claude Code will use the bridge in any project."

package/scripts/loren.js

@@ -13,6 +13,8 @@ const runtimeDir = path.join(projectRoot, ".runtime");
 const pidFilePath = path.join(runtimeDir, "loren.pid");
 const logFilePath = path.join(runtimeDir, "bridge.log");
 const errorLogFilePath = path.join(runtimeDir, "bridge.err.log");
+const userHome = process.env.USERPROFILE || process.env.HOME || projectRoot;
+const claudeSettingsPath = path.join(userHome, ".claude", "settings.json");
 
 // Force working directory to project root for config loading
 process.chdir(projectRoot);
@@ -53,7 +55,7 @@ const COMMANDS = {
 
 function main() {
   const args = process.argv.slice(2);
-  const [command, subcommand, ...rest] = args;
+  const [command] = args;
 
   if (!command || command === "help" || command === "--help" || command === "-h") {
     printHelp();
@@ -78,7 +80,7 @@ function main() {
   }
 
   if (category && action && COMMANDS[category] && COMMANDS[category][action]) {
-    COMMANDS[category][action](rest);
+    COMMANDS[category][action](args.slice(1));
     return;
   }
 
@@ -194,9 +196,13 @@ function setModel(args) {
   const envVars = loadEnvFile(envFilePath);
   envVars.DEFAULT_MODEL_ALIAS = requestedModel;
   saveEnvFile(envFilePath, envVars);
+  syncClaudeSelectedModel(requestedModel);
 
   console.log(`\n✓ Default model set to: ${requestedModel}`);
   console.log("  New requests will use this model immediately.");
+  if (fs.existsSync(claudeSettingsPath)) {
+    console.log("  Claude Code settings were updated as well.");
+  }
   console.log("");
 }
 
@@ -469,6 +475,28 @@ function safeUnlink(filePath) {
   }
 }
 
+function syncClaudeSelectedModel(model) {
+  const settingsDir = path.dirname(claudeSettingsPath);
+  fs.mkdirSync(settingsDir, { recursive: true });
+
+  let settings = {};
+  if (fs.existsSync(claudeSettingsPath)) {
+    try {
+      settings = JSON.parse(fs.readFileSync(claudeSettingsPath, "utf8").replace(/^\uFEFF/, ""));
+    } catch {
+      settings = {};
+    }
+  }
+
+  const availableModels = Array.isArray(settings.availableModels) ? settings.availableModels : [];
+  if (!availableModels.includes(model)) {
+    settings.availableModels = [model, ...availableModels];
+  }
+
+  settings.model = model;
+  fs.writeFileSync(claudeSettingsPath, `${JSON.stringify(settings, null, 2)}\n`, "utf8");
+}
+
 // ============== HELP ==============
 
 function printHelp() {

package/scripts/uninstall-claude-ollama.ps1

@@ -47,6 +47,7 @@ if (Test-Path $workspaceSettingsPath) {
   $settings = Read-JsonFile -Path $workspaceSettingsPath
   [void]$settings.Remove("claudeCode.claudeProcessWrapper")
   [void]$settings.Remove("claudeCode.disableLoginPrompt")
+  [void]$settings.Remove("claudeCode.environmentVariables")
   Write-JsonFile -Path $workspaceSettingsPath -Data $settings
 }
 
@@ -70,4 +71,4 @@ if (Test-Path $launcherExePath) {
   Remove-Item -LiteralPath $launcherExePath -Force -ErrorAction SilentlyContinue
 }
 
-Write-Host "Configurazione globale rimossa."
+Write-Host "Global configuration removed."

package/src/cache.js

@@ -1,21 +1,21 @@
 import NodeCache from 'node-cache';
 import logger from './logger.js';
 
-// Cache per i modelli (5 minuti di TTL)
+// Cache for models (5 minute TTL)
 export const modelCache = new NodeCache({
-  stdTTL: 300, // 5 minuti
-  checkperiod: 60, // Controlla ogni minuto se ci sono entry scadute
-  useClones: false // Performance migliore se non usiamo clones
+  stdTTL: 300, // 5 minutes
+  checkperiod: 60, // Check for expired entries every minute
+  useClones: false // Better performance when values are not cloned
 });
 
-// Cache per le risposte delle API (30 secondi)
+// Cache for API responses (30 seconds)
 export const apiCache = new NodeCache({
   stdTTL: 30,
   checkperiod: 10,
   useClones: false
 });
 
-// Funzione helper per il caching con error handling
+// Helper for cache access with error handling
 export function getFromCache(cache, key) {
   try {
     const value = cache.get(key);
@@ -51,7 +51,7 @@ export function deleteFromCache(cache, key) {
   }
 }
 
-// Stats per il monitoraggio
+// Monitoring stats
 export function getCacheStats(cache, name) {
   const stats = cache.getStats();
   return {
@@ -61,4 +61,4 @@ export function getCacheStats(cache, name) {
     keys: cache.keys().length,
     hitRate: stats.hits > 0 ? (stats.hits / (stats.hits + stats.misses) * 100).toFixed(2) : 0
   };
-}
+}

package/src/config-watcher.js

@@ -7,7 +7,7 @@ export class ConfigWatcher {
     this.configFile = configFile;
     this.onChange = onChange;
     this.watcher = null;
-    this.debounceTimeout = 1000; // 1 secondo
+    this.debounceTimeout = 1000; // 1 second
     this.debounceTimer = null;
   }
 
@@ -45,7 +45,7 @@ export class ConfigWatcher {
   }
 
   handleChange() {
-    // Debounce per evitare multipli reload rapidi
+    // Debounce to avoid multiple rapid reloads
     if (this.debounceTimer) {
       clearTimeout(this.debounceTimer);
     }
@@ -62,7 +62,7 @@ export class ConfigWatcher {
   }
 }
 
-// Funzione helper per creare un config watcher con reload automatico
+// Helper to create a config watcher with automatic reload
 export function createConfigWatcher(configFile, loadConfigFunction) {
   const watcher = new ConfigWatcher(configFile, async () => {
     const newConfig = loadConfigFunction();
@@ -70,4 +70,4 @@ export function createConfigWatcher(configFile, loadConfigFunction) {
   });
 
   return watcher;
-}
+}

package/src/http-agents.js

@@ -55,7 +55,7 @@ export function getAgentStats() {
   };
 }
 
-// Cleanup function per chiudere tutti gli agent
+// Cleanup function to close all agents
 export function closeAgents() {
   return new Promise((resolve) => {
     let pending = 2;
@@ -77,4 +77,4 @@ export function closeAgents() {
       done();
     });
   });
-}
+}

package/src/key-manager.js

@@ -11,7 +11,7 @@ export class KeyManager {
     }));
     this.index = 0;
     this.maxFailures = 3;
-    this.failureWindowMs = 5 * 60 * 1000; // 5 minuti
+    this.failureWindowMs = 5 * 60 * 1000; // 5 minutes
   }
 
   async getHealthyKey() {
@@ -21,7 +21,7 @@ export class KeyManager {
     do {
       const keyInfo = this.keys[this.index];
 
-      // Resetta lo stato se è passato abbastanza tempo dall'ultimo fallimento
+      // Reset key state if enough time has passed since the last failure
       if (keyInfo.lastFailure && (now - keyInfo.lastFailure) > this.failureWindowMs) {
         keyInfo.failureCount = 0;
         keyInfo.healthy = true;
@@ -66,4 +66,4 @@ export class KeyManager {
       }))
     };
   }
-}
+}

package/src/metrics.js

@@ -1,8 +1,8 @@
 import logger from './logger.js';
 
-// Metriche raccolte
+// Collected metrics
 const metrics = {
-  // Contatori
+  // Counters
   requests: {
     total: 0,
     byEndpoint: {
@@ -29,7 +29,7 @@ const metrics = {
       other: 0
     }
   },
-  // Tempi di risposta
+  // Response times
   responseTimes: [],
   // Token usage
   tokens: {
@@ -39,13 +39,13 @@ const metrics = {
   },
   // Uptime
   startTime: Date.now(),
-  // Connessioni attive
+  // Active connections
   activeConnections: 0,
   // Cache stats
   cacheStats: {}
 };
 
-// Funzioni per incrementare metriche
+// Metric update helpers
 export function incrementRequest(endpoint, statusCode) {
   metrics.requests.total++;
   if (metrics.requests.byEndpoint[endpoint] === undefined) {
@@ -68,7 +68,7 @@ export function incrementError(type = 'other') {
 
 export function recordResponseTime(duration) {
   metrics.responseTimes.push(duration);
-  // Mantieni solo gli ultimi 1000 tempi
+  // Keep only the latest 1000 samples
   if (metrics.responseTimes.length > 1000) {
     metrics.responseTimes.shift();
   }
@@ -93,7 +93,7 @@ export function setCacheStats(stats) {
   metrics.cacheStats = stats;
 }
 
-// Calcola statistiche sui tempi di risposta
+// Calculate response time stats
 function getResponseTimeStats() {
   if (metrics.responseTimes.length === 0) {
     return { avg: 0, min: 0, max: 0, p95: 0 };
@@ -109,7 +109,7 @@ function getResponseTimeStats() {
   return { avg: avg.toFixed(2), min, max, p95 };
 }
 
-// Ottieni tutte le metriche
+// Return all collected metrics
 export function getMetrics() {
   const uptime = Date.now() - metrics.startTime;
   const memoryUsage = process.memoryUsage();
@@ -155,7 +155,7 @@ export function getMetrics() {
   };
 }
 
-// Funzioni di utilità
+// Utility functions
 function formatUptime(ms) {
   const seconds = Math.floor(ms / 1000);
   const minutes = Math.floor(seconds / 60);
@@ -176,7 +176,7 @@ function formatBytes(bytes) {
   return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
 }
 
-// Middleware per tracciare richieste
+// Middleware for request tracking
 export function metricsMiddleware(req, res, next) {
   const start = Date.now();
   const endpoint = (() => {
@@ -187,12 +187,12 @@ export function metricsMiddleware(req, res, next) {
     }
   })();
 
-  // Override res.end per catturare la risposta
+  // Override res.end to capture the response
   const originalEnd = res.end;
   res.end = function(chunk, encoding) {
     const duration = Date.now() - start;
 
-    // Registra metriche
+    // Record metrics
     incrementRequest(endpoint, res.statusCode);
     recordResponseTime(duration);
 
@@ -201,7 +201,7 @@ export function metricsMiddleware(req, res, next) {
       incrementError(errorType);
     }
 
-    // Ripristina il metodo originale
+    // Restore the original method
     res.end = originalEnd;
     res.end(chunk, encoding);
   };

package/src/server.js

@@ -15,7 +15,7 @@ import { getMetrics, incrementError, recordTokenUsage, metricsMiddleware } from
 import { createConfigWatcher } from "./config-watcher.js";
 import usageTracker from "./usage-tracker.js";
 
-// Configurazione globale
+// Global runtime state
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const projectRoot = path.resolve(__dirname, "..");
@@ -25,7 +25,7 @@ ensureEnvLocal(projectRoot, { logger });
 
 let config = loadConfig();
 let keyManager = new KeyManager(config.apiKeys);
-const envFilePath = path.resolve(process.cwd(), ".env.local");
+const envFilePath = path.join(projectRoot, ".env.local");
 
 function reloadRuntimeConfig() {
   config = loadConfig();
@@ -35,15 +35,15 @@ function reloadRuntimeConfig() {
 }
 
 // Config watcher
-const configWatcher = createConfigWatcher('.env.local', () => {
+const configWatcher = createConfigWatcher(envFilePath, () => {
   reloadRuntimeConfig();
   void probeAllApiKeys();
 });
 
-// Avvia il watcher
+// Start the watcher
 configWatcher.start();
 
-// Cleanup alla chiusura
+// Cleanup on shutdown
 process.on('SIGINT', () => {
   logger.info('Shutting down gracefully...');
   configWatcher.stop();
@@ -62,7 +62,7 @@ if (!config.apiKeys.length) {
 }
 
 const server = http.createServer(async (req, res) => {
-  // Applica il middleware di metriche
+  // Apply metrics middleware
   metricsMiddleware(req, res, () => {});
 
   try {
@@ -106,7 +106,7 @@ async function routeRequest(req, res) {
 
   const url = new URL(req.url, `http://${req.headers.host || "localhost"}`);
 
-  // Log della richiesta
+  // Request logging
   logger.info(`${req.method} ${url.pathname}`, {
     ip: req.socket.remoteAddress,
     userAgent: req.headers['user-agent']
@@ -134,7 +134,7 @@ async function routeRequest(req, res) {
     return;
   }
 
-  // Usage API endpoint (GET per dati, POST per reset)
+  // Usage API endpoint (GET for data, POST for reset)
   if (url.pathname === "/api/usage" && (req.method === "GET" || req.method === "POST")) {
     await handleUsage(req, res);
     return;
@@ -192,7 +192,7 @@ async function handleHealth(_req, res) {
 }
 
 async function handleMetrics(_req, res) {
-  // Aggiorna cache stats
+  // Refresh cache stats
   const cacheStats = {
     models: getCacheStats(modelCache, 'models')
   };
@@ -316,7 +316,7 @@ async function handleEvents(req, res) {
 
 async function handleDashboard(_req, res) {
   try {
-    // Usa il percorso corretto per il file dashboard.html
+    // Resolve the dashboard.html path relative to this module
     const __filename = fileURLToPath(import.meta.url);
     const __dirname = path.dirname(__filename);
     const dashboardPath = path.join(__dirname, 'dashboard.html');
@@ -392,7 +392,7 @@ async function handleUsage(req, res) {
   try {
     const url = new URL(req.url, `http://${req.headers.host || "localhost"}`);
 
-    // Supporta reset via query parameter: /api/usage?reset=true
+    // Support reset via query parameter: /api/usage?reset=true
     if (url.searchParams.get('reset') === 'true') {
       usageTracker.resetAll();
       sendJson(res, 200, { ok: true, message: 'Usage data reset successfully' });
@@ -401,7 +401,7 @@ async function handleUsage(req, res) {
 
     const usageData = usageTracker.getDashboardData();
 
-    // Aggiungi informazioni sui rate limit attivi
+    // Add active rate limit details
     const rateLimitedKeys = usageData.keys.filter(k => k.isRateLimited);
 
     sendJson(res, 200, {
@@ -518,7 +518,7 @@ async function handleMessages(req, res) {
   try {
     const body = await readJson(req);
 
-    // Valida input
+    // Validate input
     const validatedBody = validateInput(MessageSchema, body);
 
     const anthropicRequest = normalizeAnthropicRequest(validatedBody);
@@ -547,7 +547,7 @@ async function handleMessages(req, res) {
     const payload = await upstream.json();
     const message = ollamaToAnthropicMessage(payload, anthropicRequest.model);
 
-    // Registra token usage con la chiave specifica
+    // Record token usage for the specific API key
     usageTracker.recordUsage(apiKey, message.usage?.output_tokens || 0);
     recordTokenUsage(
       anthropicRequest.model,
@@ -602,7 +602,7 @@ async function handleCountTokens(req, res) {
   }
 }
 
-// Resto delle funzioni helper (abbreviate per brevità)
+// Remaining helper functions
 function normalizeAnthropicRequest(body) {
   const requestedModel = body.model || config.defaultModel;
   return {
@@ -765,12 +765,11 @@ function ollamaToAnthropicMessage(payload, requestedModel) {
     });
   }
 
-  // Traccia l'usage con i token reali
+  // Track usage with actual token counts
   const inputTokens = payload.prompt_eval_count || 0;
   const outputTokens = payload.eval_count || 0;
 
-  // Qui dovremmo avere l'API key usata, ma per ora usiamo un approccio diverso
-  // Lo tracceremo a livello superiore
+  // The API key is tracked at a higher level for now
 
   return {
     id: `msg_${randomUUID().replace(/-/g, "")}`,
@@ -912,7 +911,7 @@ async function pipeStreamingResponse(upstream, request, res, apiKey) {
               nextIndex += 1;
             }
 
-            // Registra token usage con la chiave specifica (anche per streaming)
+            // Record token usage for the specific API key, including streaming responses
             usageTracker.recordUsage(apiKey, outputTokens || estimateTokens(aggregatedText));
             recordTokenUsage(
               request.model,
@@ -988,7 +987,7 @@ function mapDoneReason(reason) {
 }
 
 async function fetchUpstream(pathname, init) {
-  // Controlla prima se ci sono chiavi rate limited e suggerisci la migliore
+  // Check for rate-limited keys first and pick the best candidate
   const suggestedKey = usageTracker.suggestNextKey(config.apiKeys);
   if (!suggestedKey) {
     throw new Error('All API keys are rate limited');
@@ -999,10 +998,10 @@ async function fetchUpstream(pathname, init) {
   try {
     const response = await performUpstreamFetch(apiKey, pathname, init);
 
-    // Traccia l'usage (indipendentemente dal successo)
-    usageTracker.recordUsage(apiKey, 0); // Tokens verranno aggiornati dopo
+    // Track usage regardless of request success
+    usageTracker.recordUsage(apiKey, 0); // Token counts are updated later
 
-    // Controlla risposte di rate limit
+    // Handle upstream rate limit responses
     if (response.status === 429) {
       let detailsText = '';
       let reason = 'Rate limit reached';
@@ -1040,7 +1039,7 @@ async function fetchUpstream(pathname, init) {
       usageTracker.markHealthy(apiKey);
     }
 
-    // Restituisci sia la response che la chiave usata
+    // Return both the response and the API key that was used
     return { response, apiKey };
   } catch (error) {
     keyManager.markKeyFailed(suggestedKey, error);