PyPI - magic-answer - Versions diffs - 0.1.0__py3-none-any.whl - Mend

magic-answer 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

magic_answer/__init__.py +13 -0
magic_answer/_ask.py +84 -0
magic_answer/api.py +9 -0
magic_answer/assets/supabase.html +179 -0
magic_answer/config.py +3 -0
magic_answer/models.py +5 -0
magic_answer/supabase_manager.py +8 -0
magic_answer-0.1.0.dist-info/METADATA +120 -0
magic_answer-0.1.0.dist-info/RECORD +12 -0
magic_answer-0.1.0.dist-info/WHEEL +5 -0
magic_answer-0.1.0.dist-info/licenses/LICENSE +21 -0
magic_answer-0.1.0.dist-info/top_level.txt +1 -0

magic_answer/__init__.py ADDED Viewed

@@ -0,0 +1,13 @@
+__all__ = [
+    "ask",
+    "ask_clipboard",
+    "open_key_manager"
+]
+from magic_answer.api import ask_clipboard
+from magic_answer.api import ask
+from magic_answer.supabase_manager import open_key_manager
+import config
+import models

magic_answer/_ask.py ADDED Viewed

@@ -0,0 +1,84 @@
+import openai
+from openai import OpenAI
+import requests
+import pyperclip
+from magic_answer.config import SUPABASE_URL, SUPABASE_KEY, CUSTOM_INSTRUCTION
+from magic_answer.models import models
+def v(k):
+    url = f"{SUPABASE_URL}/rest/v1/kv"
+    params = {
+        "key": f"eq.{k}"
+    }
+    headers = {
+        "apikey": SUPABASE_KEY,
+        "Authorization": f"Bearer {SUPABASE_KEY}"
+    }
+    res = requests.get(url, params=params, headers=headers)
+    data = res.json()
+    if len(data) == 0:
+        return None
+    return data[0]["value"]
+def clip_input(_):
+    return pyperclip.paste()
+def clip_print(text):
+    pyperclip.copy(text)
+def _ask(key, use_clipboard=False):
+    read = clip_input if use_clipboard else input
+    write = clip_print if use_clipboard else print
+    try:
+        client = OpenAI(
+            api_key=v(key),
+            base_url="https://openrouter.ai/api/v1"
+        )
+    except openai.OpenAIError:
+        print(
+            "ОШИБКА: API-ключ по вашему ключу не найден. Проверьте правильность введённого ключа при вызове функции `answer`.")
+        quit()
+    content = read("Enter request: ")
+    content += CUSTOM_INSTRUCTION
+    # noinspection PyTypeChecker
+    def response(model):
+        try:
+            r = client.chat.completions.create(
+                model=model,
+                messages=[
+                    {"role": "user", "content": content}
+                ]
+            )
+            # check if response is valid
+            if not r or not hasattr(r, "choices") or len(r.choices) == 0:
+                return None
+            return r
+        except Exception as e:
+            print(f"[ERROR] model {model} failed:", e)
+            return None
+    result = None
+    for m in models:
+        res = response(m)
+        if res is not None:
+            # noinspection PyTypeChecker
+            result = res.choices[0].message.content
+            break
+    write(result if result else "All models failed")

magic_answer/api.py ADDED Viewed

@@ -0,0 +1,9 @@
+from magic_answer._ask import _ask
+def ask(key):
+    _ask(key)
+def ask_clipboard(key):
+    _ask(key, True)

magic_answer/assets/supabase.html ADDED Viewed

@@ -0,0 +1,179 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title>KV Store</title>
+  <style>
+    body {
+      margin: 0;
+      font-family: Arial, sans-serif;
+      background: #0f172a;
+      color: #e2e8f0;
+      display: flex;
+      justify-content: center;
+      align-items: center;
+      height: 100vh;
+    }
+    .card {
+      background: #1e293b;
+      padding: 25px;
+      border-radius: 12px;
+      width: 320px;
+      box-shadow: 0 10px 30px rgba(0,0,0,0.4);
+    }
+    h2 {
+      margin-top: 0;
+      text-align: center;
+    }
+    input {
+      width: calc(100% - 20px);
+      padding: 10px;
+      margin: 8px 0;
+      border: none;
+      border-radius: 6px;
+      background: #334155;
+      color: white;
+      outline: none;
+    }
+    button {
+      width: 100%;
+      padding: 10px;
+      margin-top: 10px;
+      border: none;
+      border-radius: 6px;
+      background: #3b82f6;
+      color: white;
+      font-weight: bold;
+      cursor: pointer;
+    }
+    button:hover {
+      background: #2563eb;
+    }
+    .msg {
+      margin-top: 12px;
+      text-align: center;
+      font-size: 14px;
+      min-height: 20px;
+    }
+    .ok { color: #22c55e; }
+    .err { color: #ef4444; }
+  </style>
+</head>
+<body>
+  <div class="card">
+    <h2>KV Store</h2>
+    <!-- WRITE -->
+    <label for="key"></label><input id="key" placeholder="key (e.g. Lastname Name)">
+    <label for="value"></label><input id="value" placeholder="value (e.g. API_KEY)">
+    <button id="btnSave">Save</button>
+    <hr style="margin: 15px 0; border-color:#334155">
+    <!-- READ -->
+    <label for="lookupKey"></label><input id="lookupKey" placeholder="check key exists...">
+    <button id="btnCheck">Check</button>
+    <div id="msg" class="msg"></div>
+  </div>
+  <script>
+    const SUPABASE_URL = "https://gxralozqwlifabqykgle.supabase.co";
+    const SUPABASE_KEY = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6Imd4cmFsb3pxd2xpZmFicXlrZ2xlIiwicm9sZSI6ImFub24iLCJpYXQiOjE3ODI3MzY1OTQsImV4cCI6MjA5ODMxMjU5NH0.cxrJxRoDiRCjCLrFmzIUy9lL4fPO-XZ0JqjeHHoJC8c";
+    const msg = document.getElementById("msg");
+    function setMsg(text, ok=true) {
+      msg.textContent = text;
+      msg.className = "msg " + (ok ? "ok" : "err");
+    }
+    // =========================
+    // SAVE (INSERT / UPDATE)
+    // =========================
+    async function send() {
+      const key = document.getElementById("key").value.trim();
+      const value = document.getElementById("value").value.trim();
+      if (!key || !value) {
+        setMsg("Please fill both fields", false);
+        return;
+      }
+      setMsg("Saving...");
+      try {
+        const res = await fetch(`${SUPABASE_URL}/rest/v1/kv?on_conflict=key`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "apikey": SUPABASE_KEY,
+            "Authorization": "Bearer " + SUPABASE_KEY,
+            "Prefer": "resolution=merge-duplicates"
+          },
+          body: JSON.stringify({ key, value })
+        });
+        if (res.ok) {
+          setMsg("Saved successfully ✔");
+        } else {
+          setMsg("Error: " + await res.text(), false);
+        }
+      } catch (e) {
+        setMsg("Network error", false);
+      }
+    }
+    // =========================
+    // LOOKUP (GET VALUE)
+    // =========================
+    async function check() {
+      const key = document.getElementById("lookupKey").value.trim();
+      if (!key) {
+        setMsg("Enter a key to check", false);
+        return;
+      }
+      setMsg("Checking...");
+      try {
+        const res = await fetch(
+          `${SUPABASE_URL}/rest/v1/kv?key=eq.${encodeURIComponent(key)}`,
+          {
+            method: "GET",
+            headers: {
+              "apikey": SUPABASE_KEY,
+              "Authorization": "Bearer " + SUPABASE_KEY
+            }
+          }
+        );
+        const data = await res.json();
+        if (data.length > 0) {
+          setMsg(`Found ✔ Value: ${data[0].value}`);
+        } else {
+          setMsg("Not found ❌", false);
+        }
+      } catch (e) {
+        setMsg("Network error", false);
+      }
+    }
+    document.getElementById("btnSave").addEventListener("click", send);
+    document.getElementById("btnCheck").addEventListener("click", check);
+  </script>
+</body>
+</html>

magic_answer/config.py ADDED Viewed

@@ -0,0 +1,3 @@
+SUPABASE_URL = "https://gxralozqwlifabqykgle.supabase.co"
+SUPABASE_KEY = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6Imd4cmFsb3pxd2xpZmFicXlrZ2xlIiwicm9sZSI6ImFub24iLCJpYXQiOjE3ODI3MzY1OTQsImV4cCI6MjA5ODMxMjU5NH0.cxrJxRoDiRCjCLrFmzIUy9lL4fPO-XZ0JqjeHHoJC8c"
+CUSTOM_INSTRUCTION = ". Отвечай по делу, не используй MD форматирование. Отвечай только на заданные вопросы или выполняй заданные инструкции, если это практическое задание, не преподноси лишнюю информацию. Формулируй ответ, как будто это ответ на экзаменационный билет"

magic_answer/models.py ADDED Viewed

@@ -0,0 +1,5 @@
+models = [
+    "nvidia/nemotron-3-nano-30b-a3b:free",
+    "qwen/qwen3-235b-a22b:free",
+    "deepseek/deepseek-r1:free"
+]

magic_answer/supabase_manager.py ADDED Viewed

@@ -0,0 +1,8 @@
+import webbrowser
+from importlib.resources import files
+def open_key_manager():
+    html = files("magic_answer.assets").joinpath("supabase.html")
+    # noinspection PyUnresolvedReferences
+    webbrowser.open(html.as_uri())

magic_answer-0.1.0.dist-info/METADATA ADDED Viewed

@@ -0,0 +1,120 @@
+Metadata-Version: 2.4
+Name: magic-answer
+Version: 0.1.0
+Summary: A lightweight OpenRouter client with Supabase-based remote API key storage.
+Author: Melkii_Mel
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: openai
+Requires-Dist: requests
+Requires-Dist: pyperclip
+Dynamic: license-file
+# Magic Answer
+A lightweight Python library for querying OpenRouter LLMs using API keys stored in a Supabase key-value database.
+Instead of embedding an OpenRouter API key into your application, **Magic Answer** retrieves it from a Supabase key-value store at runtime using a lookup key. This allows API keys to be updated or rotated without modifying or redistributing client applications.
+## Features
+* Query any model available through OpenRouter
+* Automatic fallback between multiple models
+* Retrieve OpenRouter API keys from a Supabase key-value store
+* Exceptionally simple Python API
+* Optional clipboard integration
+* Built-in key manager for maintaining the Supabase database
+* Easily customizable through configuration
+## Installation
+```bash
+pip install magic-answer
+```
+## Quick Start
+Query using console input:
+```python
+import magic_answer
+magic_answer.ask("your_lookup_key")
+```
+Or use the clipboard:
+```python
+import magic_answer
+magic_answer.ask_clipboard("your_lookup_key")
+```
+## Managing API Keys
+Magic Answer includes a simple graphical key manager for maintaining your Supabase key-value store.
+```python
+import magic_answer
+magic_answer.open_key_manager()
+```
+The key manager allows you to:
+* Add or update API keys
+* Check whether a lookup key exists
+* View the stored value associated with a lookup key
+## Configuration
+Override the default Supabase configuration:
+```python
+from magic_answer import config
+config.SUPABASE_URL = "https://your-project.supabase.co"
+config.SUPABASE_KEY = "your_supabase_anon_key"
+config.CUSTOM_INSTRUCTION = "Your custom instruction"
+```
+Configure fallback models:
+```python
+from magic_answer import models
+models.models = [
+    "openai/gpt-oss-20b:free",
+    "qwen/qwen3-235b-a22b:free",
+    "deepseek/deepseek-r1:free",
+]
+```
+The library will attempt each model in order until one successfully returns a response.
+## API
+### `ask(lookup_key)`
+Prompts the user for a question, retrieves the corresponding OpenRouter API key from Supabase using `lookup_key`, queries OpenRouter, and prints the model's response.
+### `ask_clipboard(lookup_key)`
+Reads the prompt from the clipboard, retrieves the corresponding OpenRouter API key from Supabase, queries OpenRouter, and copies the model's response back to the clipboard.
+### `open_key_manager()`
+Opens the built-in HTML key manager in the default web browser, allowing you to add, update, and inspect entries in your Supabase key-value store.
+## Requirements
+* Python 3.10+
+* Internet connection
+* A Supabase project containing the key-value table
+* An OpenRouter API key stored in that table
+## License
+MIT

magic_answer-0.1.0.dist-info/RECORD ADDED Viewed

@@ -0,0 +1,12 @@
+magic_answer/__init__.py,sha256=qRqPiVMd-CRmtLloSrf1tkieKqLzO1YNmgNdZf6FqYk,251
+magic_answer/_ask.py,sha256=sx4mX7izvKRPE82Vf3jaBDRxcJo9auSO3_CWeAHXX10,2147
+magic_answer/api.py,sha256=6WYhbAQX7Ud4FsTyS3Zs40ZHqtW9DkdlctSDySW8gaQ,123
+magic_answer/config.py,sha256=fGiLAwJUQrKw7Kh7Mu9qpABurUKcyGXtPJoJ-XaBmLs,762
+magic_answer/models.py,sha256=F3tsOzeQl8Hlvl5xJ5XNlSxPc6cCFkGVq7e9dyJfgLQ,129
+magic_answer/supabase_manager.py,sha256=XfrCkVjBV79H31GgkdgoDxhMuduyaEyE-z88UAroRQA,236
+magic_answer/assets/supabase.html,sha256=8vrfGLg-DbRknKvegcgtjlLrJIwS-J_7Krs7EbpUK8w,4511
+magic_answer-0.1.0.dist-info/licenses/LICENSE,sha256=dffn-bw-FwKJ4O4cfMqB32LETA9j96F3l-sRE71IR2w,1091
+magic_answer-0.1.0.dist-info/METADATA,sha256=bCGe-76a-U6qW_CCF8PA-MPapoydX1goTawqcHWXjJ8,3126
+magic_answer-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+magic_answer-0.1.0.dist-info/top_level.txt,sha256=osk9HpwAt_bhbr3KM2Tn3g0Y7QmqF03mAtVj8JL5r7M,13
+magic_answer-0.1.0.dist-info/RECORD,,

magic_answer-0.1.0.dist-info/WHEEL ADDED Viewed

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any

magic_answer-0.1.0.dist-info/licenses/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) [year] [fullname]
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

magic_answer-0.1.0.dist-info/top_level.txt ADDED Viewed

	@@ -0,0 +1 @@
1	+ magic_answer