supervertaler 1.9.112__tar.gz → 1.9.113__tar.gz

{supervertaler-1.9.112 → supervertaler-1.9.113}/CHANGELOG.md

@@ -2,7 +2,51 @@
 
 All notable changes to Supervertaler are documented in this file.
 
-**Current Version:** v1.9.112 (January 19, 2026)
+**Current Version:** v1.9.113 (January 19, 2026)
+
+## 🔐 API Key Loading System Unified (v1.9.113) - January 19, 2026
+
+**Unified API Key Loading with Dev-First Priority**
+
+Consolidated the confusing multi-path API key loading system into a single, clear dual-path approach that fixes AI Assistant bug #107:
+
+**The Problem:**
+- Three different API key file locations existed (root, user_data, user_data_private)
+- Two different loading mechanisms (`Supervertaler.load_api_keys()` vs `llm_clients.load_api_keys()`)
+- Conflicting instructions in example files
+- **AI Assistant bug (#107)**: Keys worked for translation but failed for AI Assistant with "Incorrect API key" error
+
+**The Solution:**
+- **Unified loading in main app**: `load_api_keys()` now checks TWO locations with clear priority
+  1. `user_data_private/api_keys.txt` (Dev mode - gitignored, never uploaded to GitHub)
+  2. `user_data/api_keys.txt` (User mode - ships with app)
+- **AI Assistant fixed**: Now uses `parent_app.load_api_keys()` instead of module function
+- **Example files updated**: Both example files now give consistent, clear instructions
+
+**Developer Workflow:**
+- Store keys in `user_data_private/api_keys.txt`
+- Fully gitignored - safe from accidental commits
+- All features find keys here (translation, AI Assistant, tests)
+
+**User Workflow:**
+- Keys go in `user_data/api_keys.txt`
+- App auto-creates this location on first run
+- Simple, single location
+
+**Files Modified:**
+- `Supervertaler.py` - `load_api_keys()` method now checks dev path first (line ~39407)
+- `api_keys.example.txt` - Updated with dev/user instructions
+- `user_data/api_keys.example.txt` - Updated with dev/user instructions
+- `README.md` - Updated First Steps with API key setup
+- `AGENTS.md` - Updated API Keys section with new dual-path documentation
+
+**Result:**
+- ✅ Developers: Keys safe in gitignored location
+- ✅ Users: Simple single location
+- ✅ AI Assistant: Now works with same keys as translation
+- ✅ No more confusion about where to put keys
+
+---
 
 ## 🐛 Bug Fixes (v1.9.112) - January 19, 2026
 
@@ -3695,7 +3739,7 @@ Each match shows:
     1. 🏠 Home (NEW - welcome screen)
     2. 💡 Prompt Manager (moved up from #5)
     3. 📝 Editor (renamed from "Project Editor")
-    4. �️ Resources (organized nested tabs)
+    4. 🗂️ Resources (organized nested tabs)
     5. 🧩 Modules (renamed from "Specialised Modules")
     6. ⚙️ Settings (moved from Tools menu, includes Log)
   - **Navigation Menu:** Added "Go to Home" action (🏠 Home menu item)

{supervertaler-1.9.112 → supervertaler-1.9.113}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: supervertaler
-Version: 1.9.112
+Version: 1.9.113
 Summary: Professional AI-powered translation workbench with multi-LLM support, glossary system, TM, spellcheck, voice commands, and PyQt6 interface. Batteries included (core).
 Home-page: https://supervertaler.com
 Author: Michael Beijer
@@ -584,6 +584,10 @@ python Supervertaler.py
 ### First Steps
 
 1.  **Configure API Keys**: Set up OpenAI, Claude, or Gemini credentials
+    - Copy `user_data/api_keys.example.txt` to `user_data/api_keys.txt`
+    - Add your API keys (remove the `#` from each line you use)
+    - Format: `openai = sk-YOUR_KEY_HERE` (no quotes needed)
+    - **Developers**: Use `user_data_private/api_keys.txt` instead (gitignored)
 2.  **Explore System Prompts** (Ctrl+P) - Browse domain-specific specialist prompts
 3.  **Create Custom Instructions** - Define your translation preferences
 4.  **Open a Document** - Import DOCX, create segments

{supervertaler-1.9.112 → supervertaler-1.9.113}/README.md

@@ -511,6 +511,10 @@ python Supervertaler.py
 ### First Steps
 
 1.  **Configure API Keys**: Set up OpenAI, Claude, or Gemini credentials
+    - Copy `user_data/api_keys.example.txt` to `user_data/api_keys.txt`
+    - Add your API keys (remove the `#` from each line you use)
+    - Format: `openai = sk-YOUR_KEY_HERE` (no quotes needed)
+    - **Developers**: Use `user_data_private/api_keys.txt` instead (gitignored)
 2.  **Explore System Prompts** (Ctrl+P) - Browse domain-specific specialist prompts
 3.  **Create Custom Instructions** - Define your translation preferences
 4.  **Open a Document** - Import DOCX, create segments

{supervertaler-1.9.112 → supervertaler-1.9.113}/Supervertaler.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: supervertaler
-Version: 1.9.112
+Version: 1.9.113
 Summary: Professional AI-powered translation workbench with multi-LLM support, glossary system, TM, spellcheck, voice commands, and PyQt6 interface. Batteries included (core).
 Home-page: https://supervertaler.com
 Author: Michael Beijer
@@ -584,6 +584,10 @@ python Supervertaler.py
 ### First Steps
 
 1.  **Configure API Keys**: Set up OpenAI, Claude, or Gemini credentials
+    - Copy `user_data/api_keys.example.txt` to `user_data/api_keys.txt`
+    - Add your API keys (remove the `#` from each line you use)
+    - Format: `openai = sk-YOUR_KEY_HERE` (no quotes needed)
+    - **Developers**: Use `user_data_private/api_keys.txt` instead (gitignored)
 2.  **Explore System Prompts** (Ctrl+P) - Browse domain-specific specialist prompts
 3.  **Create Custom Instructions** - Define your translation preferences
 4.  **Open a Document** - Import DOCX, create segments

{supervertaler-1.9.112 → supervertaler-1.9.113}/Supervertaler.egg-info/SOURCES.txt

@@ -4,7 +4,6 @@ LICENSE
 MANIFEST.in
 README.md
 Supervertaler.py
-api_keys.example.txt
 pyproject.toml
 setup.py
 Supervertaler.egg-info/PKG-INFO

{supervertaler-1.9.112 → supervertaler-1.9.113}/Supervertaler.py

@@ -3,8 +3,8 @@ Supervertaler
 =============
 The Ultimate Translation Workbench.
 Modern PyQt6 interface with specialised modules to handle any problem.
-Version: 1.9.104 (Packaging + docs)
-Release Date: January 14, 2026
+Version: 1.9.113 (API key loading unified)
+Release Date: January 19, 2026
 Framework: PyQt6
 
 This is the modern edition of Supervertaler using PyQt6 framework.
@@ -34,7 +34,7 @@ License: MIT
 """
 
 # Version Information.
-__version__ = "1.9.112"
+__version__ = "1.9.113"
 __phase__ = "0.9"
 __release_date__ = "2026-01-18"
 __edition__ = "Qt"
@@ -39404,11 +39404,26 @@ OUTPUT ONLY THE SEGMENT MARKERS. DO NOT ADD EXPLANATIONS BEFORE OR AFTER."""
             return f"[MyMemory error: {str(e)}]"
     
     def load_api_keys(self) -> Dict[str, str]:
-        """Load API keys from user_data folder"""
+        """Load API keys with dev-first priority
+        
+        Priority order:
+        1. user_data_private/api_keys.txt (dev mode, gitignored)
+        2. user_data/api_keys.txt (user mode, shipped with app)
+        """
         api_keys = {}
-        api_keys_file = self.user_data_path / "api_keys.txt"
         
-        if not api_keys_file.exists():
+        # Priority 1: Dev mode (gitignored, never shipped)
+        dev_file = Path("user_data_private") / "api_keys.txt"
+        
+        # Priority 2: User mode (ships with app)
+        user_file = self.user_data_path / "api_keys.txt"
+        
+        # Check dev first, then user
+        if dev_file.exists():
+            api_keys_file = dev_file
+        elif user_file.exists():
+            api_keys_file = user_file
+        else:
             return api_keys
         
         try:

{supervertaler-1.9.112 → supervertaler-1.9.113}/modules/unified_prompt_manager_qt.py

@@ -2821,7 +2821,12 @@ If the text refers to figures (e.g., 'Figure 1A'), relevant images may be provid
     def _init_llm_client(self):
         """Initialize LLM client with available API keys"""
         try:
-            api_keys = load_api_keys()
+            # Use parent app's API key loading method (reads from user_data/api_keys.txt)
+            if hasattr(self.parent_app, 'load_api_keys'):
+                api_keys = self.parent_app.load_api_keys()
+            else:
+                # Fallback to module function (legacy path)
+                api_keys = load_api_keys()
             
             # Try to use the same provider as main app if available
             provider = None
@@ -2839,7 +2844,7 @@ If the text refers to figures (e.g., 'Figure 1A'), relevant images may be provid
                     provider = "openai"
                 elif api_keys.get("claude"):
                     provider = "claude"
-                elif api_keys.get("google"):
+                elif api_keys.get("google") or api_keys.get("gemini"):
                     provider = "gemini"
             
             if provider:

{supervertaler-1.9.112 → supervertaler-1.9.113}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "supervertaler"
-version = "1.9.112"
+version = "1.9.113"
 description = "Professional AI-powered translation workbench with multi-LLM support, glossary system, TM, spellcheck, voice commands, and PyQt6 interface. Batteries included (core)."
 readme = "README.md"
 requires-python = ">=3.10"

supervertaler-1.9.112/api_keys.example.txt

@@ -1,63 +0,0 @@
-# API Keys for Supervertaler
-# ============================================
-#
-# INSTRUCTIONS:
-# 1. Copy this file and rename it to: api_keys.txt
-# 2. Replace the placeholder values with your actual API keys
-# 3. Keep api_keys.txt secure and never commit it to version control
-#
-# Format: key_name = your_api_key_here
-#         (spaces around = are optional, no quotes needed)
-
-# ============================================
-# LLM PROVIDERS (for AI Translation & AI Assistant)
-# ============================================
-
-# OpenAI (GPT-4o, GPT-4o-mini, GPT-5)
-# Get your key at: https://platform.openai.com/api-keys
-openai = YOUR_OPENAI_API_KEY_HERE
-
-# Anthropic Claude (Claude Sonnet 4.5, Haiku 4.5, Opus 4.1)
-# Get your key at: https://console.anthropic.com/settings/keys
-claude = YOUR_ANTHROPIC_API_KEY_HERE
-
-# Google Gemini (Gemini 2.5 Flash, 2.5 Pro)
-# Get your key at: https://aistudio.google.com/app/apikey
-# NOTE: You can use either "google" or "gemini" as the key name (they're aliases)
-google = YOUR_GOOGLE_GEMINI_API_KEY_HERE
-
-# ============================================
-# LOCAL LLM (Ollama) - No API key needed!
-# ============================================
-# Ollama runs locally on your computer.
-# Install from: https://ollama.com
-# Default endpoint (change only if using non-standard port):
-ollama_endpoint = http://localhost:11434
-
-# ============================================
-# MACHINE TRANSLATION APIs (for MT Preview panel)
-# ============================================
-# These are DIFFERENT from the LLM APIs above!
-# MT APIs provide quick machine translations, not AI-powered translation.
-
-# DeepL (Recommended for European languages)
-# Get your key at: https://www.deepl.com/pro-api
-deepl = 
-
-# Google Cloud Translation API
-# NOTE: This is DIFFERENT from Gemini! It's traditional machine translation.
-# Get your key at: https://console.cloud.google.com/apis/credentials
-# (Enable "Cloud Translation API" in your Google Cloud project)
-google_translate = 
-
-# MyMemory (Free translation API - limited usage)
-mymemory = 
-
-# ============================================
-# SECURITY NOTES:
-# - Keep this file private and secure
-# - Never share your API keys publicly  
-# - Never commit api_keys.txt to version control
-# - Monitor your API usage regularly
-# - Each provider has different pricing and rate limits
-# ============================================