Zamiana OPENAI_API_KEY na GITHUB_TOKEN w kodzie, dokumentacji i konfiguracji

.env.example

@@ -1,5 +1,5 @@
-# OpenAI API Configuration (Required)
-OPENAI_API_KEY=your_api_key_here
+# GitHub Token Configuration (Required)
+GITHUB_TOKEN=your_token_here
 
 # LLM Configuration
 LLM_MODEL=gpt-4o

CLAUDE.md

@@ -25,7 +25,7 @@ pip install -r requirements.txt
 
 # Configure environment
 cp .env.example .env
-# Then edit .env and add your OPENAI_API_KEY
+# Then edit .env and add your GITHUB_TOKEN
 ```
 
 ### Database Management
@@ -90,7 +90,7 @@ python -c "import lancedb; db = lancedb.connect('./lancedb'); print(len(db.open_
 - `demo.queue()` must be called explicitly (see app.py:238-243)
 - Do NOT use `atexit.register()` for cleanup (causes premature shutdown)
 - LanceDB is read-only; must be tracked with Git LFS
-- API key stored as HF Spaces Secret: `OPENAI_API_KEY`
+- Token stored as HF Spaces Secret: `GITHUB_TOKEN`
 - The `if __name__ == "__main__"` block handles both local and HF deployments
 
 ### LanceDB Database
@@ -112,7 +112,7 @@ The agent has **strict language enforcement**:
 ### Configuration
 
 All settings in `config.py` are loaded from environment variables:
-- `OPENAI_API_KEY` (required)
+- `GITHUB_TOKEN` (required)
 - `LLM_MODEL` (default: gpt-4o)
 - `LLM_BASE_URL` (optional, supports GitHub Models)
 - `EMBEDDING_MODEL` (default: text-embedding-3-large)

HF_SPACES_GUIDE.md

@@ -36,7 +36,7 @@
 W ustawieniach Space → Settings → Repository secrets:
 
 ```
-Name: OPENAI_API_KEY
+Name: GITHUB_TOKEN
 Value: sk-proj-... (twój klucz)
 ```
 
@@ -105,7 +105,7 @@ Running on public URL: https://...
 
 ### ❌ Jeśli widzisz błędy:
 
-#### Error: "OPENAI_API_KEY is required"
+#### Error: "GITHUB_TOKEN is required"
 **Rozwiązanie:** Dodaj klucz w Secrets (Krok 2B)
 
 #### Error: "Table 'a11y_expert' doesn't exist"
@@ -194,7 +194,7 @@ Przed ogłoszeniem Space jako "Production Ready":
 - [ ] Język jest wykrywany prawidłowo
 - [ ] Przykładowe pytania działają
 - [ ] Brak ostrzeżeń w logach
-- [ ] OPENAI_API_KEY jest w Secrets (NIE w kodzie!)
+- [ ] GITHUB_TOKEN jest w Secrets (NIE w kodzie!)
 - [ ] README.md jest czytelny i informacyjny
 - [ ] Space ma odpowiedni tytuł i opis
 

QUICK_REFERENCE.md

@@ -58,7 +58,7 @@ python app.py
 ### 1. Secrets (KRYTYCZNE!)
 ```
 Settings → Repository secrets
-Name: OPENAI_API_KEY
+Name: GITHUB_TOKEN
 Value: sk-proj-...
 ```
 
@@ -91,7 +91,7 @@ app_file: app.py
 | Błąd | Rozwiązanie |
 |------|-------------|
 | "Event loop is closed" | Użyj zaktualizowanego `app.py` |
-| "OPENAI_API_KEY is required" | Dodaj klucz w HF Secrets |
+| "GITHUB_TOKEN is required" | Dodaj token w HF Secrets |
 | "Table doesn't exist" | Upload folder `lancedb/` |
 | Pydantic validation error | Sprawdź `.env` lub HF Secrets |
 
@@ -99,7 +99,7 @@ app_file: app.py
 
 - [ ] `python test_startup.py` - wszystkie testy ✅
 - [ ] Wszystkie pliki skommitowane (oprócz `.env`, `cache/`)
-- [ ] OPENAI_API_KEY w HF Secrets
+- [ ] GITHUB_TOKEN w HF Secrets
 - [ ] README.md ma poprawny YAML header
 - [ ] Folder `lancedb/` jest w repo (Git LFS dla >10MB)
 

README.md

@@ -36,7 +36,7 @@ Inteligentny agent AI wyspecjalizowany w dostępności cyfrowej (a11y), wykorzys
 ### 1. Wymagania wstępne
 
 - Python 3.10+
-- Klucz API OpenAI
+- Token GitHub (GITHUB_TOKEN)
 
 ### 2. Instalacja lokalna
 
@@ -56,10 +56,10 @@ Inteligentny agent AI wyspecjalizowany w dostępności cyfrowej (a11y), wykorzys
       ```bash
       cp .env.example .env
       ```
-    - Otwórz plik `.env` i wklej swój klucz API OpenAI:
-      ```
-      OPENAI_API_KEY="sk-..."
-      ```
+        - Otwórz plik `.env` i wklej swój token GitHub:
+            ```
+            GITHUB_TOKEN="ghp_..."
+            ```
 
 4.  **Uruchom aplikację:**
     ```bash
@@ -82,7 +82,7 @@ Aplikacja jest skonfigurowana do wdrożenia jako Gradio App na Hugging Face Spac
 
 ### 1. Konfiguracja w Hugging Face
 
-- W ustawieniach swojego Space, w sekcji **Secrets**, dodaj sekret o nazwie `OPENAI_API_KEY` i wklej swój klucz API.
+- W ustawieniach swojego Space, w sekcji **Secrets**, dodaj sekret o nazwie `GITHUB_TOKEN` i wklej swój token GitHub.
 
 ### 2. Kluczowe aspekty wdrożenia
 

TODO_DEPLOYMENT.md

@@ -85,7 +85,7 @@ Fixes #[issue_number] - App closing on Hugging Face Spaces"
 ### 2. Dodaj Secret (NAJWAŻNIEJSZE!)
 - [ ] Przejdź do Settings → Repository secrets
 - [ ] Kliknij "Add a secret"
-- [ ] Nazwa: `OPENAI_API_KEY`
+- [ ] Nazwa: `GITHUB_TOKEN`
 - [ ] Wartość: Twój klucz OpenAI (sk-proj-...)
 - [ ] Zapisz
 
@@ -142,7 +142,7 @@ Running on public URL: https://...hf.space
 ```
 
 - [ ] Sprawdź czy NIE MA błędów:
-  - ❌ "OPENAI_API_KEY is required" → Dodaj Secret!
+  - ❌ "GITHUB_TOKEN is required" → Dodaj Secret!
   - ❌ "RuntimeError: Event loop is closed" → Użyj zaktualizowanego app.py
   - ❌ "Table doesn't exist" → Upload lancedb/ folder
 
@@ -206,7 +206,7 @@ Running on public URL: https://...hf.space
 
 Jeśli coś nie działa, sprawdź:
 
-1. **OPENAI_API_KEY** - czy jest dodany w Secrets?
+1. **GITHUB_TOKEN** - czy jest dodany w Secrets?
 2. **Logi** - jakie błędy są w logach?
 3. **requirements.txt** - czy wszystkie biblioteki są zainstalowane?
 4. **Python version** - czy w README.md jest `python_version: 3.10`?
@@ -216,7 +216,7 @@ Jeśli coś nie działa, sprawdź:
 
 | Problem | Fix |
 |---------|-----|
-| "API key required" | Dodaj OPENAI_API_KEY w Secrets |
+| "Token required" | Dodaj GITHUB_TOKEN w Secrets |
 | "Event loop closed" | Re-upload app.py z tego repo |
 | "Table doesn't exist" | Upload lancedb/ folder |
 | Space crashes | Sprawdź logi, może brak pamięci |

agent/a11y_agent.py

@@ -256,13 +256,12 @@ def create_agent(language: Optional[str] = None) -> A11yExpertAgent:
     logger.info("Initializing vector store client...")
     vector_store = VectorStoreClient(uri=settings.lancedb_uri)
     
-    api_key = settings.openai_api_key
-    
+    github_token = settings.github_token
+
     logger.info("Initializing OpenAI client...")
-    client_args = {"api_key": api_key}
+    client_args = {"api_key": github_token}
     if settings.llm_base_url:
         client_args["base_url"] = settings.llm_base_url
-        
     llm_client = OpenAI(**client_args)
     
     logger.info("Creating A11yExpertAgent instance...")

config.py

@@ -16,8 +16,8 @@ class Settings(BaseSettings):
     """
     Application settings loaded from environment variables or .env file.
     
-    All settings have sensible defaults except for the OpenAI API key,
-    which must be provided via the OPENAI_API_KEY environment variable.
+    All settings have sensible defaults except for the GitHub token,
+    which must be provided via the GITHUB_TOKEN environment variable.
     
     Attributes:
         openai_api_key: OpenAI API key (required)
@@ -39,10 +39,10 @@ class Settings(BaseSettings):
     """
     
     # API Configuration (required)
-    openai_api_key: str = Field(
+    github_token: str = Field(
         default="",
-        description="OpenAI API key - required for LLM and embeddings",
-        validation_alias="OPEN_API_KEY"  # Also accept OPEN_API_KEY (common typo)
+        description="GitHub token - required for LLM and embeddings",
+        validation_alias="GITHUB_TOKEN"
     )
     
     # LLM Configuration
@@ -107,17 +107,17 @@ class Settings(BaseSettings):
         description="Public URL for social media sharing"
     )
     
-    @field_validator("openai_api_key")
+    @field_validator("github_token")
     @classmethod
-    def validate_api_key(cls, v):
-        """Ensure API key is provided and not empty."""
+    def validate_github_token(cls, v):
+        """Ensure GitHub token is provided and not empty."""
         v = v or ""
         v = v.strip()
         if not v:
             import os
             if not os.getenv("SPACE_ID"):
                 raise ValueError(
-                    "OPENAI_API_KEY is required. "
+                    "GITHUB_TOKEN is required. "
                     "Set it in your .env file or environment variables."
                 )
         return v

models/embeddings.py

@@ -60,7 +60,7 @@ class EmbeddingsClient:
         
         logger.info(f"Initializing EmbeddingsClient with {self.settings.llm_base_url}")
         self.client = OpenAI(
-            api_key=self.settings.openai_api_key,
+            api_key=self.settings.github_token,
             base_url=self.settings.llm_base_url
         )
         

test_startup.py

@@ -32,7 +32,7 @@ def test_config():
         from config import get_settings
         import os
         
-        os.environ.setdefault("OPENAI_API_KEY", "test-key-for-validation")
+        os.environ.setdefault("GITHUB_TOKEN", "test-token-for-validation")
         
         settings = get_settings()
         logger.info(f"LLM Model: {settings.llm_model}")
@@ -52,7 +52,7 @@ def test_vector_store():
         from database.vector_store_client import VectorStoreClient
         import os
         
-        os.environ.setdefault("OPENAI_API_KEY", "test-key-for-validation")
+        os.environ.setdefault("GITHUB_TOKEN", "test-token-for-validation")
         
         settings = get_settings()
         client = VectorStoreClient(uri=settings.lancedb_uri)
@@ -90,7 +90,7 @@ def test_agent():
         from agent.a11y_agent import create_agent
         import os
         
-        os.environ.setdefault("OPENAI_API_KEY", "test-key-for-validation")
+        os.environ.setdefault("GITHUB_TOKEN", "test-token-for-validation")
         
         agent = create_agent()
         logger.info(f"Agent language: {agent.language}")