search-api-webui 0.1.6__tar.gz → 0.1.8__tar.gz

{search_api_webui-0.1.6 → search_api_webui-0.1.8}/.gitignore

@@ -8,7 +8,6 @@ venv/
 # Frontend / Node
 frontend/node_modules/
 frontend/dist/
-frontend/package-lock.json
 frontend/.DS_Store
 .DS_Store
 
@@ -24,6 +23,7 @@ user_config.json
 .co*/
 .tr*/
 .hi*/
+.ba*/
 
 # Build artifacts
 build/

search_api_webui-0.1.8/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: search-api-webui
+Version: 0.1.8
+Summary: A Search API WebUI for testing and comparing Querit, You, and other search providers.
+Project-URL: Homepage, https://github.com/querit-ai/search-api-webui
+Project-URL: Repository, https://github.com/querit-ai/search-api-webui.git
+Project-URL: Issues, https://github.com/querit-ai/search-api-webui/issues
+Author: querit.ai
+License: MIT
+License-File: LICENSE
+Keywords: api,arena,benchmark,llm,querit,search,tool,webui
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Flask
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Requires-Dist: flask-cors>=3.0.0
+Requires-Dist: flask>=1.1.0
+Requires-Dist: jmespath>=0.10.0
+Requires-Dist: pyyaml>=5.3
+Requires-Dist: querit
+Requires-Dist: requests>=2.22.0
+Provides-Extra: build
+Requires-Dist: pyinstaller>=6.0; extra == 'build'
+Provides-Extra: webview
+Requires-Dist: pywebview>=5.0; extra == 'webview'
+Description-Content-Type: text/markdown
+
+# Search API WebUI
+
+A lightweight, local WebUI for testing, comparing, and visualizing Search APIs (Querit, You, etc.).
+
+![Screenshot](docs/images/screenshot.webp)
+
+## Features
+
+* **Search**: Support for [Querit.ai](https://www.querit.ai/en/docs/reference/post), [You.com](https://docs.you.com/api-reference/search/v1-search), and generic Search APIs via configuration.
+* **API Arena**: Compare two search providers side-by-side to benchmark latency, payload size, and result relevance.
+* **Performance Metrics**: Real-time display of request latency and payload size.
+* **Visual Rendering**: Renders standard search results (Title, Snippet, URL) in a clean card layout.
+* **Configurable**: Easy-to-edit providers.yaml to add or modify search providers.
+* **Secure**: API Keys are stored locally in your $HOME folder.
+## Installation
+
+### macOS Installation
+
+For macOS users, you can download the DMG installer from the GitHub Releases page:
+
+1. Visit the [Releases page](https://github.com/querit-ai/search-api-webui/releases)
+2. Download the appropriate DMG file for your Mac architecture:
+   - **Apple Silicon (M1/M2/M3)**: `SearchAPIWebUI-<version>-macOS-arm64.dmg`
+   - **Intel Macs**: `SearchAPIWebUI-<version>-macOS-x86_64.dmg`
+3. Open the DMG file and drag `SearchAPIWebUI` to your Applications folder
+4. Launch `SearchAPIWebUI` from Applications
+
+**Note**: Since the application is not code-signed, macOS may block it on first launch. To allow it to run:
+- Go to **System Settings** > **Privacy & Security**
+- Look for the message about `SearchAPIWebUI` being blocked
+- Click **Open Anyway** to allow the application to run
+
+### Prerequisites
+
+Python 3.7+
+
+### Install via Pip
+
+Use this method if you just want to run the tool without modifying the code.
+
+```
+pip install search-api-webui
+```
+
+### Run the Server
+
+```
+search-api-webui
+```
+
+## Development
+
+Use this method if you want to contribute to the code or build from source.
+
+### Prerequisites
+
+* Python 3.7+
+* Node.js & npm (for building the frontend)
+
+### Setup Steps
+
+**Clone the repository**
+
+```
+git clone https://github.com/querit-ai/search-api-webui.git
+cd search-api-webui
+```
+
+**Build Frontend**
+
+```
+cd frontend
+npm install
+npm run build
+cd …
+```
+
+**Install search-api-webui (Editable Mode)**
+
+```
+pip install -e .
+```
+
+**Run the Server**
+
+```
+python -m search_api_webui.app
+```
+
+## Configuration
+
+### Add API Keys
+
+Open the WebUI settings page (click the gear icon). Enter your API Key for the selected provider (e.g., Querit). Keys are saved locally in $HOME/.search-api-webui/config.json.
+
+### Add New Providers
+
+Edit providers.yaml in the root directory to add custom API endpoints. The system uses JMESPath to map JSON responses to the UI.
+
+```
+my_custom_search:
+url: “https://api.example.com/search”
+method: “GET”
+headers:
+Authorization: “Bearer {api_key}”
+params:
+q: “{query}”
+response_mapping:
+root_path: “data.items”
+fields:
+title: “title”
+url: “link”
+snippet: “snippet”
+```
+
+## License
+
+MIT License. See LICENSE for details.

search_api_webui-0.1.6/PKG-INFO → search_api_webui-0.1.8/README.md

@@ -1,49 +1,43 @@
-Metadata-Version: 2.4
-Name: search-api-webui
-Version: 0.1.6
-Summary: A Search API WebUI for Querit, You, and other search providers.
-Project-URL: Homepage, https://github.com/querit-ai/search-api-webui
-Project-URL: Repository, https://github.com/querit-ai/search-api-webui.git
-Project-URL: Issues, https://github.com/querit-ai/search-api-webui/issues
-Author: querit.ai
-License: MIT
-License-File: LICENSE
-Keywords: api,llm,querit,search,tool,webui
-Classifier: Development Status :: 3 - Alpha
-Classifier: Framework :: Flask
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.7
-Requires-Dist: flask-cors
-Requires-Dist: flask>=2.0.0
-Requires-Dist: jmespath
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: querit
-Requires-Dist: requests>=2.25.0
-Description-Content-Type: text/markdown
-
 # Search API WebUI
 
-A lightweight, local WebUI for testing and visualizing Search APIs (Querit, You, etc.).
+A lightweight, local WebUI for testing, comparing, and visualizing Search APIs (Querit, You, etc.).
 
-(images)
+![Screenshot](docs/images/screenshot.webp)
 
 ## Features
 
 * **Search**: Support for [Querit.ai](https://www.querit.ai/en/docs/reference/post), [You.com](https://docs.you.com/api-reference/search/v1-search), and generic Search APIs via configuration.
+* **API Arena**: Compare two search providers side-by-side to benchmark latency, payload size, and result relevance.
 * **Performance Metrics**: Real-time display of request latency and payload size.
 * **Visual Rendering**: Renders standard search results (Title, Snippet, URL) in a clean card layout.
 * **Configurable**: Easy-to-edit providers.yaml to add or modify search providers.
 * **Secure**: API Keys are stored locally in your $HOME folder.
 ## Installation
 
-Use this method if you just want to run the tool without modifying the code.
+### macOS Installation
+
+For macOS users, you can download the DMG installer from the GitHub Releases page:
+
+1. Visit the [Releases page](https://github.com/querit-ai/search-api-webui/releases)
+2. Download the appropriate DMG file for your Mac architecture:
+   - **Apple Silicon (M1/M2/M3)**: `SearchAPIWebUI-<version>-macOS-arm64.dmg`
+   - **Intel Macs**: `SearchAPIWebUI-<version>-macOS-x86_64.dmg`
+3. Open the DMG file and drag `SearchAPIWebUI` to your Applications folder
+4. Launch `SearchAPIWebUI` from Applications
+
+**Note**: Since the application is not code-signed, macOS may block it on first launch. To allow it to run:
+- Go to **System Settings** > **Privacy & Security**
+- Look for the message about `SearchAPIWebUI` being blocked
+- Click **Open Anyway** to allow the application to run
 
 ### Prerequisites
 
 Python 3.7+
+
 ### Install via Pip
 
+Use this method if you just want to run the tool without modifying the code.
+
 ```
 pip install search-api-webui
 ```

{search_api_webui-0.1.6 → search_api_webui-0.1.8}/pyproject.toml

@@ -4,15 +4,15 @@ build-backend = "hatchling.build"
 
 [project]
 name = "search-api-webui"
-version = "0.1.6"
-description = "A Search API WebUI for Querit, You, and other search providers."
+version = "0.1.8"
+description = "A Search API WebUI for testing and comparing Querit, You, and other search providers."
 readme = "README.md"
-requires-python = ">=3.7"
+requires-python = ">=3.8"
 license = { text = "MIT" }
 authors = [
     { name = "querit.ai" }
 ]
-keywords = ["search", "api", "webui", "querit", "llm", "tool"]
+keywords = ["search", "api", "webui", "querit", "llm", "tool", "arena", "benchmark"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "License :: OSI Approved :: MIT License",
@@ -21,14 +21,18 @@ classifiers = [
 ]
 
 dependencies = [
-    "flask>=2.0.0",
-    "flask-cors",
-    "requests>=2.25.0",
-    "pyyaml>=6.0",
-    "jmespath",
+    "flask>=1.1.0",
+    "flask-cors>=3.0.0",
+    "requests>=2.22.0",
+    "pyyaml>=5.3",
+    "jmespath>=0.10.0",
     "querit"
 ]
 
+[project.optional-dependencies]
+webview = ["pywebview>=5.0"]
+build = ["pyinstaller>=6.0"]
+
 [project.urls]
 Homepage = "https://github.com/querit-ai/search-api-webui"
 Repository = "https://github.com/querit-ai/search-api-webui.git"

{search_api_webui-0.1.6 → search_api_webui-0.1.8}/search_api_webui/__init__.py

@@ -17,4 +17,3 @@
 # 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.
-

search_api_webui-0.1.8/search_api_webui/app.py

@@ -0,0 +1,289 @@
+# Copyright (c) 2026 QUERIT PRIVATE LIMITED
+#
+# 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.
+
+import json
+import socket
+import sys
+import threading
+import time
+import webbrowser
+from pathlib import Path
+
+from flask import Flask, jsonify, request, send_from_directory
+from flask_cors import CORS
+
+from search_api_webui.providers import load_providers
+
+try:
+    import webview
+    WEBVIEW_AVAILABLE = True
+except ImportError:
+    WEBVIEW_AVAILABLE = False
+
+
+def get_resource_path(relative_path):
+    '''Get absolute path to resource, works for dev and for PyInstaller.'''
+    try:
+        # PyInstaller creates a temp folder and stores path in _MEIPASS
+        base_path = Path(sys._MEIPASS)
+    except Exception:
+        base_path = Path(__file__).resolve().parent
+
+    return base_path / relative_path
+
+
+CURRENT_DIR = Path(__file__).resolve().parent
+
+# Handle static folder for both dev and packaged app
+if hasattr(sys, '_MEIPASS'):
+    # Running in PyInstaller bundle
+    STATIC_FOLDER = Path(sys._MEIPASS) / 'static'
+else:
+    # Running in development
+    STATIC_FOLDER = CURRENT_DIR / 'static'
+    if not STATIC_FOLDER.exists():
+        DEV_FRONTEND_DIST = CURRENT_DIR.parent / 'frontend' / 'dist'
+        if DEV_FRONTEND_DIST.exists():
+            STATIC_FOLDER = DEV_FRONTEND_DIST
+
+app = Flask(__name__, static_folder=str(STATIC_FOLDER))
+CORS(app)
+
+# Use get_resource_path for providers.yaml
+PROVIDERS_YAML = get_resource_path('providers.yaml')
+USER_CONFIG_DIR = Path.home() / '.search-api-webui'
+USER_CONFIG_JSON = USER_CONFIG_DIR / 'config.json'
+
+if not USER_CONFIG_DIR.exists():
+    USER_CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+
+if PROVIDERS_YAML.exists():
+    provider_map = load_providers(str(PROVIDERS_YAML))
+else:
+    print(f'Error: Configuration file not found at {PROVIDERS_YAML}')
+    provider_map = {}
+
+
+def get_stored_config():
+    if not USER_CONFIG_JSON.exists():
+        return {}
+    try:
+        with open(USER_CONFIG_JSON, encoding='utf-8') as f:
+            return json.load(f)
+    except Exception as e:
+        print(f'Error reading config: {e}')
+        return {}
+
+
+def save_stored_config(config_dict):
+    try:
+        with open(USER_CONFIG_JSON, 'w', encoding='utf-8') as f:
+            json.dump(config_dict, f, indent=2)
+    except Exception as e:
+        print(f'Error saving config: {e}')
+
+
+@app.route('/api/providers', methods=['GET'])
+def get_providers_list():
+    stored_config = get_stored_config()
+    providers_info = []
+
+    for name, provider_instance in provider_map.items():
+        config_details = provider_instance.config
+
+        user_conf = stored_config.get(name, {})
+
+        if isinstance(user_conf, str):
+            user_conf = {'api_key': user_conf}
+
+        has_key = bool(user_conf.get('api_key'))
+
+        providers_info.append(
+            {
+                'name': name,
+                'has_key': has_key,
+                'details': config_details,
+                'user_settings': {
+                    'api_url': user_conf.get('api_url', ''),
+                    'limit': user_conf.get('limit', '10'),
+                    'language': user_conf.get('language', 'en-US'),
+                },
+            },
+        )
+    return jsonify(providers_info)
+
+
+@app.route('/api/config', methods=['POST'])
+def update_config():
+    data = request.json
+    provider_name = data.get('provider')
+
+    if not provider_name:
+        return jsonify({'error': 'Provider name is required'}), 400
+
+    if 'api_key' not in data:
+        return jsonify({'error': 'API Key field is missing'}), 400
+
+    api_key = data.get('api_key')
+
+    api_url = data.get('api_url', '').strip()
+    limit = data.get('limit', '10')
+    language = data.get('language', 'en-US')
+
+    all_config = get_stored_config()
+
+    if provider_name in all_config and isinstance(all_config[provider_name], str):
+        all_config[provider_name] = {'api_key': all_config[provider_name]}
+
+    if not api_key:
+        if provider_name in all_config:
+            all_config[provider_name]['api_key'] = ''
+    else:
+        if provider_name not in all_config:
+            all_config[provider_name] = {}
+
+        all_config[provider_name]['api_key'] = api_key
+        all_config[provider_name]['api_url'] = api_url
+        all_config[provider_name]['limit'] = limit
+        all_config[provider_name]['language'] = language
+
+    save_stored_config(all_config)
+    return jsonify({'status': 'success'})
+
+
+@app.route('/api/search', methods=['POST'])
+def search_api():
+    data = request.json
+    query = data.get('query')
+    provider_name = data.get('provider', 'querit')
+
+    api_key = data.get('api_key')
+
+    stored_config = get_stored_config()
+    provider_config = stored_config.get(provider_name, {})
+
+    if isinstance(provider_config, str):
+        provider_config = {'api_key': provider_config}
+
+    if not api_key:
+        api_key = provider_config.get('api_key')
+
+    if not api_key:
+        return (
+            jsonify({'error': f'API Key for {provider_name} is missing. Please configure it.'}),
+            401,
+        )
+
+    provider = provider_map.get(provider_name)
+    if not provider:
+        return jsonify({'error': 'Provider not found'}), 404
+
+    search_kwargs = {
+        'api_url': provider_config.get('api_url'),
+        'limit': provider_config.get('limit'),
+        'language': provider_config.get('language'),
+    }
+
+    result = provider.search(query, api_key, **search_kwargs)
+    return jsonify(result)
+
+
+# Host React Frontend
+@app.route('/', defaults={'path': ''})
+@app.route('/<path:path>')
+def serve(path):
+    if path != '' and (STATIC_FOLDER / path).exists():
+        return send_from_directory(str(STATIC_FOLDER), path)
+    else:
+        return send_from_directory(str(STATIC_FOLDER), 'index.html')
+
+
+def wait_for_server_ready(host, port):
+    start_time = time.time()
+    while time.time() - start_time < 10:
+        try:
+            with socket.create_connection((host, port), timeout=1):
+                return True
+        except (OSError, ConnectionRefusedError):
+            time.sleep(0.1)
+    return False
+
+
+def main():
+    import argparse
+
+    parser = argparse.ArgumentParser(description='Search API WebUI')
+    parser.add_argument('--port', type=int, default=8889, help='Port to run the server on')
+    parser.add_argument('--host', type=str, default='127.0.0.1', help='Host to run the server on')
+    parser.add_argument('-w', '--webview', action='store_true', help='Use webview to open the application')
+    args = parser.parse_args()
+
+    url = f'http://{args.host}:{args.port}'
+    print('Starting Search API WebUI...')
+    print(f'  - Config Storage: {USER_CONFIG_JSON}')
+    print(f'  - Serving on: {url}')
+    if args.webview:
+        print('  - Mode: webview')
+
+    if args.webview:
+        if not WEBVIEW_AVAILABLE:
+            print('Warning: webview library not installed. Falling back to webbrowser.')
+            # Start server in background thread and wait for it to be ready
+            server_thread = threading.Thread(
+                target=lambda: app.run(
+                    host=args.host, port=args.port, use_reloader=False,
+                ),
+                daemon=True,
+            )
+            server_thread.start()
+            if wait_for_server_ready(args.host, args.port):
+                print(f'Server is ready! Opening browser: {url}')
+                webbrowser.open(url)
+            else:
+                print('Error: Server took too long to start. Browser not opened.')
+        else:
+            # Start server in background thread and wait for it to be ready, then start webview
+            server_thread = threading.Thread(
+                target=lambda: app.run(
+                    host=args.host, port=args.port, use_reloader=False,
+                ),
+                daemon=True,
+            )
+            server_thread.start()
+            if wait_for_server_ready(args.host, args.port):
+                print('Server is ready! Using webview mode...')
+                webview.create_window('Search API WebUI', url, width=1200, height=800)
+                webview.start()
+            else:
+                print('Error: Server took too long to start. Webview not opened.')
+    else:
+        # Start a background thread to check server status and open the browser automatically
+        def open_browser():
+            if wait_for_server_ready(args.host, args.port):
+                print(f'Server is ready! Opening browser: {url}')
+                webbrowser.open(url)
+            else:
+                print('Error: Server took too long to start. Browser not opened.')
+        threading.Thread(target=open_browser, daemon=True).start()
+        app.run(host=args.host, port=args.port)
+
+
+if __name__ == '__main__':
+    main()

{search_api_webui-0.1.6 → search_api_webui-0.1.8}/search_api_webui/providers/__init__.py

@@ -19,25 +19,28 @@
 # DEALINGS IN THE SOFTWARE.
 
 import os
+
 import yaml
+
 from .generic import GenericProvider
 from .querit import QueritSdkProvider
 
+
 def load_providers(file_path='providers.yaml'):
-    """
+    '''
     Parses the YAML configuration file and instantiates the appropriate provider classes.
-    
+
     Args:
         file_path (str): Path to the providers configuration file.
-        
+
     Returns:
         dict: A dictionary mapping provider names to their initialized instances.
-    """
+    '''
     if not os.path.exists(file_path):
-        print(f"Warning: Provider config file not found at {file_path}")
+        print(f'Warning: Provider config file not found at {file_path}')
         return {}
-        
-    with open(file_path, 'r', encoding='utf-8') as f:
+
+    with open(file_path, encoding='utf-8') as f:
         configs = yaml.safe_load(f)
 
     providers = {}