Metadata-Version: 2.4
Name: search-api-webui
Version: 0.1.7
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.4
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
Description-Content-Type: text/markdown

# Search API WebUI

A lightweight, local WebUI for testing and visualizing Search APIs (Querit, You, etc.).

(images)

## 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.
* **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.

### Prerequisites

Python 3.7+
### Install via Pip

```
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.
