supermegaexplosion 0.3.1__tar.gz → 0.4.0__tar.gz

{supermegaexplosion-0.3.1 → supermegaexplosion-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: supermegaexplosion
-Version: 0.3.1
+Version: 0.4.0
 Summary: DSA utility library — input helpers, algorithms, data structures, and AI assistant
 Author-email: "Hadoopnb.ai" <hadoopnb@example.com>
 License-Expression: MIT
@@ -8,11 +8,12 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 Provides-Extra: ai
-Requires-Dist: google-genai; extra == "ai"
+Requires-Dist: groq; extra == "ai"
+Requires-Dist: azure-ai-inference; extra == "ai"
 
 # supermegaexplosion
 
-DSA utility library — interactive input helpers, string/math/array algorithms, data structures, and an AI assistant powered by Google Gemini.
+DSA utility library — interactive input helpers, string/math/array algorithms, data structures, and an AI assistant powered by Groq (primary), GitHub Models, and Stack Overflow.
 
 ```python
 from libbs import *
@@ -24,26 +25,35 @@ sieve(100)               # primes up to 100
 max_subarray_sum([-2,1,-3,4,-1,2,1,-5,4])  # 6
 ListNode.from_list([1,2,3,4,5])
 
-# AI assistant (requires API key + dependency)
+# AI assistant — works out of the box (free embedded Groq key)
 respond_help("How to reverse a linked list?")
+
+# Direct Stack Overflow search — also works out of the box
+stack_overflow("python reverse linked list")
 ```
 
 ## Install
 
 ```bash
 pip install supermegaexplosion              # core (zero deps)
-pip install supermegaexplosion[ai]          # with AI assistant (google-genai)
+pip install supermegaexplosion[ai]          # with Groq + GitHub Models
 ```
 
 ## AI Setup
 
-Get a free API key from https://aistudio.google.com/ and set it:
+`respond_help` works immediately with the embedded Groq key. For better quota, set your own:
+
+```bash
+set GROQ_API_KEY=gsk_your_key_here
+```
+
+Optional — GitHub Models fallback:
 
 ```bash
-set GEMINI_API_KEY=your_api_key_here
+set GITHUB_TOKEN=ghp_your_token_here
 ```
 
-Then use `respond_help("your question")` — free tier gives 60 requests/min, 1500/day.
+Provider chain: Groq (fastest) -> GitHub Models -> Stack Overflow -> built-in DSA answers.
 
 ## Adding New Functions
 

{supermegaexplosion-0.3.1 → supermegaexplosion-0.4.0}/README.md

@@ -1,6 +1,6 @@
 # supermegaexplosion
 
-DSA utility library — interactive input helpers, string/math/array algorithms, data structures, and an AI assistant powered by Google Gemini.
+DSA utility library — interactive input helpers, string/math/array algorithms, data structures, and an AI assistant powered by Groq (primary), GitHub Models, and Stack Overflow.
 
 ```python
 from libbs import *
@@ -12,26 +12,35 @@ sieve(100)               # primes up to 100
 max_subarray_sum([-2,1,-3,4,-1,2,1,-5,4])  # 6
 ListNode.from_list([1,2,3,4,5])
 
-# AI assistant (requires API key + dependency)
+# AI assistant — works out of the box (free embedded Groq key)
 respond_help("How to reverse a linked list?")
+
+# Direct Stack Overflow search — also works out of the box
+stack_overflow("python reverse linked list")
 ```
 
 ## Install
 
 ```bash
 pip install supermegaexplosion              # core (zero deps)
-pip install supermegaexplosion[ai]          # with AI assistant (google-genai)
+pip install supermegaexplosion[ai]          # with Groq + GitHub Models
 ```
 
 ## AI Setup
 
-Get a free API key from https://aistudio.google.com/ and set it:
+`respond_help` works immediately with the embedded Groq key. For better quota, set your own:
+
+```bash
+set GROQ_API_KEY=gsk_your_key_here
+```
+
+Optional — GitHub Models fallback:
 
 ```bash
-set GEMINI_API_KEY=your_api_key_here
+set GITHUB_TOKEN=ghp_your_token_here
 ```
 
-Then use `respond_help("your question")` — free tier gives 60 requests/min, 1500/day.
+Provider chain: Groq (fastest) -> GitHub Models -> Stack Overflow -> built-in DSA answers.
 
 ## Adding New Functions
 

{supermegaexplosion-0.3.1 → supermegaexplosion-0.4.0}/libbs/__init__.py

@@ -4,6 +4,7 @@ from libbs.math_utils import *
 from libbs.arrays import *
 from libbs.ds import *
 from libbs.ai_helper import respond_help
+from libbs.so_helper import stack_overflow
 from libbs.catalog import show_commands, show_command
 
-__version__ = "0.3.1"
+__version__ = "0.4.0"

{supermegaexplosion-0.3.1 → supermegaexplosion-0.4.0}/libbs/ai_helper.py

@@ -1,19 +1,17 @@
-import os
-import json
 import base64
+import json
+import os
 import re
-import time
 import threading
+import time
 
 _CONFIG_DIR = os.path.expanduser("~/.config/supermegaexplosion")
 _CONFIG_FILE = os.path.join(_CONFIG_DIR, "config.json")
 
-_EMBEDDED_KEY = base64.b64decode(
-    "QVEuQWI4Uk42SVhxTFVmcEpqVlhaTjY3S3lkRFUtNFoxWHZKWXFWMnBPMGMzZHZoSTRISXc="
+_EMBEDDED_GROQ_KEY = base64.b64decode(
+    "Z3NrX3A5cWdDQlp3OFFSWDBQdkhtdXphV0dkeWIzRllTd1lJT29Kd25YSnBlRHVod2ZIWHgyQng="
 ).decode()
 
-_MODELS = ["gemini-2.0-flash-lite", "gemini-2.0-flash"]
-
 _lock = threading.Lock()
 _request_times = []
 
@@ -151,8 +149,21 @@ def _save_config(data):
         json.dump(data, f)
 
 
-def _get_key(api_key):
-    return api_key or os.environ.get("GEMINI_API_KEY") or _load_config().get("api_key")
+def _get_groq_key(api_key=None):
+    if api_key:
+        return api_key
+    env = os.environ.get("GROQ_API_KEY")
+    if env:
+        return env
+    cfg = _load_config()
+    return cfg.get("groq_key") or _EMBEDDED_GROQ_KEY
+
+
+def _get_github_token():
+    token = os.environ.get("GITHUB_TOKEN")
+    if token:
+        return token
+    return _load_config().get("github_token")
 
 
 def _rate_limit_wait():
@@ -199,6 +210,52 @@ def _find_fallback(query):
     return None
 
 
+def _groq_answer(query, api_key=None):
+    from groq import Groq
+    key = _get_groq_key(api_key)
+    client = Groq(api_key=key)
+    response = client.chat.completions.create(
+        model="llama-3.1-8b-instant",
+        messages=[
+            {"role": "system", "content": "You are a DSA and Python coding assistant. Answer concisely with code examples."},
+            {"role": "user", "content": query},
+        ],
+        max_tokens=512,
+        temperature=0.3,
+    )
+    return response.choices[0].message.content
+
+
+def _github_answer(query):
+    token = _get_github_token()
+    if not token:
+        raise RuntimeError("GITHUB_TOKEN not set")
+    from azure.ai.inference import ChatCompletionsClient
+    from azure.core.credentials import AzureKeyCredential
+    client = ChatCompletionsClient(
+        endpoint="https://models.inference.ai.azure.com",
+        credential=AzureKeyCredential(token),
+    )
+    response = client.complete(
+        messages=[
+            {"role": "system", "content": "You are a DSA and Python coding assistant. Answer concisely with code examples."},
+            {"role": "user", "content": query},
+        ],
+        model="gpt-4o-mini",
+        max_tokens=512,
+        temperature=0.3,
+    )
+    return response.choices[0].message.content
+
+
+def _so_answer(query):
+    from libbs.so_helper import stack_overflow
+    result = stack_overflow(query)
+    if not result or result.startswith("No results") or "error" in result.lower():
+        raise RuntimeError(result or "No answer from Stack Overflow")
+    return result
+
+
 def respond_help(query=None, api_key=None):
     interactive = query is None
     if interactive:
@@ -208,81 +265,37 @@ def respond_help(query=None, api_key=None):
 
     fallback = _find_fallback(query)
 
-    try:
-        from google import genai
-    except ImportError:
-        print(
-            "Missing dependency. Install with:\n"
-            "  pip install supermegaexplosion[ai]"
-        )
-        if fallback:
-            print("\n  Here's a built-in answer:\n")
-            print(fallback)
-        return
-
-    key = _get_key(api_key)
-
-    if not key:
-        print(
-            "No API key found. Using a shared demo key (rate-limited).\n"
-            "Set your own free key at https://aistudio.google.com/ for better quota.\n"
-        )
-        key = _EMBEDDED_KEY
-        _save_config({"api_key": ""})
-
-    if key == _EMBEDDED_KEY and not _load_config().get("api_key"):
-        if interactive:
-            try:
-                ans = input("Enter your Gemini API key (or press Enter to use the demo key): ").strip()
-                if ans:
-                    key = ans
-                    _save_config({"api_key": ans})
-            except (EOFError, OSError):
-                pass
-
-    wait = _rate_limit_wait()
-    if wait > 0:
-        _countdown(wait, "Cooling down")
-
-    client = genai.Client(api_key=key)
-    last_error = None
-
-    for attempt in range(4):
-        for model_name in _MODELS:
+    providers = [
+        ("Groq", lambda: _groq_answer(query, api_key)),
+        ("GitHub Models", lambda: _github_answer(query)),
+        ("Stack Overflow", lambda: _so_answer(query)),
+    ]
+
+    for name, func in providers:
+        for attempt in range(3):
+            wait = _rate_limit_wait()
+            if wait > 0:
+                _countdown(wait, "Cooling down")
+
             try:
-                resp = client.models.generate_content(
-                    model=model_name,
-                    contents=(
-                        "You are a DSA and Python coding assistant. "
-                        "Answer concisely with code examples.\n\n"
-                        f"Question: {query}"
-                    ),
-                    config={"max_output_tokens": 512, "temperature": 0.3},
-                )
-                print(resp.text)
-                return
+                result = func()
+                if result:
+                    print(result)
+                    return
+            except ImportError:
+                break
             except Exception as e:
-                last_error = e
-                msg = str(e)
-
-                if "limit: 0" in msg or "PERMISSION_DENIED" in msg:
-                    continue
-
-                if "429" in msg or "RESOURCE_EXHAUSTED" in msg:
-                    delay = _extract_retry_delay(msg)
-                    if delay:
-                        _countdown(min(delay, 30), "Quota hit")
-                    elif attempt < 3:
-                        _countdown(5 * (attempt + 1), f"Retry {attempt + 1}/3")
-                    else:
-                        break
+                error = str(e)
+                if not error:
+                    break
+                err_lower = error.lower()
+                if attempt < 2 and ("429" in error or "quota" in err_lower or "limit" in err_lower or "rate" in err_lower):
+                    delay = _extract_retry_delay(error)
+                    _countdown(delay or 5 * (attempt + 1), f"Retry {name} {attempt+1}/2")
+                else:
                     break
 
     if fallback:
-        print("\n  [!] AI unavailable. Here's a built-in answer:\n")
         print(fallback)
     else:
-        print(
-            "\n  [X] AI quota exhausted. Set your own key or try again later:\n"
-            "     set GEMINI_API_KEY=your_key"
-        )
+        print("No answer found. Try: stack_overflow('your question here')")

{supermegaexplosion-0.3.1 → supermegaexplosion-0.4.0}/libbs/catalog.py

@@ -55,7 +55,8 @@ COMMANDS = {
         "has_path_sum": "Check if root-to-leaf path sums to target.",
     },
     "AI Assistant": {
-        "respond_help": "Ask a coding/DSA question via Google Gemini (free, needs GEMINI_API_KEY env var).",
+        "respond_help": "Ask a coding/DSA question via Groq (AI, free) with automatic fallback to GitHub Models, Stack Overflow, and built-in answers.",
+        "stack_overflow": "Search Stack Overflow directly. Returns top-voted answers with code. No API key needed (embedded key provided).",
     },
 }
 

supermegaexplosion-0.4.0/libbs/so_helper.py

@@ -0,0 +1,62 @@
+import base64
+import html
+import json
+import os
+import re
+import urllib.parse
+import urllib.request
+import urllib.error
+
+_EMBEDDED_SO_KEY = base64.b64decode("cmxfUWFuS1lNMkhWVzRRZVZGTHRqWE4xaGlOdg==").decode()
+
+
+def _resolve_key(api_key=None):
+    if api_key:
+        return api_key
+    env = os.environ.get("STACK_OVERFLOW_KEY")
+    if env:
+        return env
+    return _EMBEDDED_SO_KEY
+
+
+def stack_overflow(query, api_key=None):
+    key = _resolve_key(api_key)
+    params = {
+        "order": "desc",
+        "sort": "votes",
+        "q": query,
+        "key": key,
+        "site": "stackoverflow",
+        "pagesize": 2,
+        "filter": "withbody",
+    }
+    url = "https://api.stackexchange.com/2.3/search/advanced?" + urllib.parse.urlencode(params)
+
+    try:
+        with urllib.request.urlopen(url, timeout=15) as resp:
+            data = json.loads(resp.read().decode())
+    except Exception as e:
+        return f"Stack Overflow API error: {e}"
+
+    if "items" not in data or not data["items"]:
+        return "No results found on Stack Overflow."
+
+    result_parts = []
+    for item in data["items"][:2]:
+        title = item.get("title", "Untitled")
+        score = item.get("score", 0)
+        body = item.get("body", "")
+
+        codes = re.findall(r"<pre><code>(.*?)</code></pre>", body, re.DOTALL)
+        text = html.unescape(re.sub(r"<[^>]+>", "", body))[:300].strip()
+
+        result_parts.append(f"[{score} votes] {title}")
+        result_parts.append(f"  {text}\n")
+        for code in codes[:2]:
+            cleaned = html.unescape(code.strip())
+            result_parts.append(f"  ---")
+            for line in cleaned.split("\n"):
+                result_parts.append(f"  {line}")
+            result_parts.append("")
+
+    return "\n".join(result_parts).strip()

{supermegaexplosion-0.3.1 → supermegaexplosion-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "supermegaexplosion"
-version = "0.3.1"
+version = "0.4.0"
 description = "DSA utility library — input helpers, algorithms, data structures, and AI assistant"
 readme = "README.md"
 authors = [{ name = "Hadoopnb.ai", email = "hadoopnb@example.com" }]
@@ -15,4 +15,4 @@ classifiers = [
 requires-python = ">=3.8"
 
 [project.optional-dependencies]
-ai = ["google-genai"]
+ai = ["groq", "azure-ai-inference"]

{supermegaexplosion-0.3.1 → supermegaexplosion-0.4.0}/supermegaexplosion.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: supermegaexplosion
-Version: 0.3.1
+Version: 0.4.0
 Summary: DSA utility library — input helpers, algorithms, data structures, and AI assistant
 Author-email: "Hadoopnb.ai" <hadoopnb@example.com>
 License-Expression: MIT
@@ -8,11 +8,12 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 Provides-Extra: ai
-Requires-Dist: google-genai; extra == "ai"
+Requires-Dist: groq; extra == "ai"
+Requires-Dist: azure-ai-inference; extra == "ai"
 
 # supermegaexplosion
 
-DSA utility library — interactive input helpers, string/math/array algorithms, data structures, and an AI assistant powered by Google Gemini.
+DSA utility library — interactive input helpers, string/math/array algorithms, data structures, and an AI assistant powered by Groq (primary), GitHub Models, and Stack Overflow.
 
 ```python
 from libbs import *
@@ -24,26 +25,35 @@ sieve(100)               # primes up to 100
 max_subarray_sum([-2,1,-3,4,-1,2,1,-5,4])  # 6
 ListNode.from_list([1,2,3,4,5])
 
-# AI assistant (requires API key + dependency)
+# AI assistant — works out of the box (free embedded Groq key)
 respond_help("How to reverse a linked list?")
+
+# Direct Stack Overflow search — also works out of the box
+stack_overflow("python reverse linked list")
 ```
 
 ## Install
 
 ```bash
 pip install supermegaexplosion              # core (zero deps)
-pip install supermegaexplosion[ai]          # with AI assistant (google-genai)
+pip install supermegaexplosion[ai]          # with Groq + GitHub Models
 ```
 
 ## AI Setup
 
-Get a free API key from https://aistudio.google.com/ and set it:
+`respond_help` works immediately with the embedded Groq key. For better quota, set your own:
+
+```bash
+set GROQ_API_KEY=gsk_your_key_here
+```
+
+Optional — GitHub Models fallback:
 
 ```bash
-set GEMINI_API_KEY=your_api_key_here
+set GITHUB_TOKEN=ghp_your_token_here
 ```
 
-Then use `respond_help("your question")` — free tier gives 60 requests/min, 1500/day.
+Provider chain: Groq (fastest) -> GitHub Models -> Stack Overflow -> built-in DSA answers.
 
 ## Adding New Functions
 

{supermegaexplosion-0.3.1 → supermegaexplosion-0.4.0}/supermegaexplosion.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ libbs/catalog.py
 libbs/ds.py
 libbs/input_utils.py
 libbs/math_utils.py
+libbs/so_helper.py
 libbs/strings.py
 libbs/tools/__init__.py
 libbs/tools/add_func.py

supermegaexplosion-0.4.0/supermegaexplosion.egg-info/requires.txt

@@ -0,0 +1,4 @@
+
+[ai]
+groq
+azure-ai-inference

supermegaexplosion-0.3.1/supermegaexplosion.egg-info/requires.txt

@@ -1,3 +0,0 @@
-
-[ai]
-google-genai