search-api-webui 0.2.0__py3-none-any.whl → 0.2.2__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.
@@ -5,8 +5,8 @@
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
6
  <link rel="icon" type="image/x-icon" href="/favicon.ico" />
7
7
  <title>Search API WebUI</title>
8
- <script type="module" crossorigin src="/assets/index-NR55tr9D.js"></script>
9
- <link rel="stylesheet" crossorigin href="/assets/index-CgRy5JvN.css">
8
+ <script type="module" crossorigin src="/assets/index-CEkM4WD5.js"></script>
9
+ <link rel="stylesheet" crossorigin href="/assets/index-BWsitD55.css">
10
10
  </head>
11
11
  <body>
12
12
  <div id="root"></div>
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: search-api-webui
3
- Version: 0.2.0
3
+ Version: 0.2.2
4
4
  Summary: A Search API WebUI for testing and comparing Querit, You, and other search providers.
5
5
  Project-URL: Homepage, https://github.com/querit-ai/search-api-webui
6
6
  Project-URL: Repository, https://github.com/querit-ai/search-api-webui.git
@@ -28,26 +28,28 @@ Description-Content-Type: text/markdown
28
28
 
29
29
  # Search API WebUI
30
30
 
31
- A lightweight, cross-platform WebUI and native Mac App for testing, comparing, and visualizing Search APIs (Querit, You, Tavily, Exa, Baidu, Brave, Parallel etc.).
31
+ Python WebUI with native Mac/Windows Apps for testing, comparing, and visualizing Search APIs (Querit, You, Tavily, Exa, Baidu, Brave, Parallel etc.).
32
32
 
33
33
  ![Screenshot](docs/images/screenshot.webp)
34
34
 
35
35
  ## Features
36
36
 
37
- * **Search**: Support for multiple search providers including:
38
- - [Querit.qi](https://www.querit.ai/en/docs/reference/post)
37
+ * **Search**: Support for multiple search api providers including:
38
+ - [Querit.ai](https://www.querit.ai/en/docs/reference/post)
39
39
  - [You.com](https://docs.you.com/api-reference/search/v1-search)
40
40
  - [Tavily.com](https://docs.tavily.com/documentation/api-reference/introduction)
41
41
  - [Exa.ai](https://docs.exa.ai/reference/search)
42
42
  - [Parallel.ai](https://docs.parallel.ai/api-reference/search-beta/search)
43
43
  - [Baidu.com](https://cloud.baidu.com/doc/WENXINWORKSHOP/s/4lilb2lpf)
44
44
  - [Brave.com](https://api-dashboard.search.brave.com/documentation)
45
- - And generic Search APIs via configuration
45
+ - [Serper.dev](https://serper.dev)
46
+ - You can add more generic Search APIs via configuration
46
47
  * **API Arena**: Compare two search providers side-by-side to benchmark latency, payload size, and result relevance.
47
48
  * **Performance Metrics**: Real-time display of request latency and payload size.
48
- * **Visual Rendering**: Renders standard search results (Title, Snippet, URL) in a clean card layout.
49
- * **Configurable**: Easy-to-edit providers.yaml to add or modify search providers.
49
+ * **Visual Rendering**: Renders standard search results (Title, URL, SiteName, SiteIcon, PageAge, Snippet) in a clean card layout.
50
+ * **Configurable**: Easy-to-edit `providers.yaml` to add or modify search providers.
50
51
  * **Secure**: API Keys are stored locally in your $HOME folder.
52
+
51
53
  ## Installation
52
54
 
53
55
  ### macOS Installation
@@ -66,9 +68,20 @@ For macOS users, you can download the DMG installer from the GitHub Releases pag
66
68
  - Look for the message about `SearchAPIWebUI` being blocked
67
69
  - Click **Open Anyway** to allow the application to run
68
70
 
69
- ### Prerequisites
71
+ ### Windows Installation
72
+
73
+ For Windows users, you can download the installer from the GitHub Releases page:
74
+
75
+ 1. Visit the [Releases page](https://github.com/querit-ai/search-api-webui/releases)
76
+ 2. Download the appropriate Setup file for your Windows system:
77
+ - **64-bit Windows** (most common): `SearchAPIWebUI-<version>-Windows-x64-Setup.exe`
78
+ - **32-bit Windows** (legacy): `SearchAPIWebUI-<version>-Windows-x86-Setup.exe`
79
+ 3. Run the Setup executable and follow the installation wizard
80
+ 4. Launch `SearchAPIWebUI` from the Start Menu or Desktop shortcut
70
81
 
71
- Python 3.7+
82
+ **Note**:
83
+ - The installer requires .NET Framework 4.5 or later (usually pre-installed on Windows 8+)
84
+ - Windows Defender SmartScreen may show a warning for unsigned applications. Click "More info" → "Run anyway" to proceed
72
85
 
73
86
  ### Install via Pip
74
87
 
@@ -90,7 +103,7 @@ Use this method if you want to contribute to the code or build from source.
90
103
 
91
104
  ### Prerequisites
92
105
 
93
- * Python 3.7+
106
+ * Python 3.8+
94
107
  * Node.js & npm (for building the frontend)
95
108
 
96
109
  ### Quick Start with Makefile
@@ -109,7 +122,9 @@ make dev
109
122
  ```
110
123
 
111
124
  This will:
112
- - Start Flask backend on http://localhost:8889
125
+ - Set up Python virtual environment and install dependencies
126
+ - Install frontend dependencies (node_modules)
127
+ - Start Flask backend on http://localhost:8889 with hot reload
113
128
  - Start Vite frontend dev server on http://localhost:5173
114
129
  - Automatically open your browser
115
130
  - Enable hot module replacement for instant updates
@@ -123,7 +138,11 @@ make # or 'make all'
123
138
  **Build macOS DMG** (macOS only)
124
139
 
125
140
  ```bash
126
- make dmg # Builds for your current architecture
141
+ make dmg # Builds DMG for your current architecture (incl. .app build)
142
+ make build-app # Build only the .app bundle (without DMG)
143
+ # Override architecture if needed:
144
+ make ARCH=arm64 dmg # Force Apple Silicon build
145
+ make ARCH=x86_64 dmg # Force Intel build (requires x86_64 Python)
127
146
  ```
128
147
 
129
148
  ### Manual Setup
@@ -157,9 +176,8 @@ python -m search_api_webui.app
157
176
  make # Build Python wheel package (default)
158
177
  make dev # Start development servers with hot reload
159
178
  make dmg # Build macOS DMG for current architecture
160
- make backend # Start backend server only
161
- make frontend # Start frontend dev server only
162
179
  make clean # Clean build artifacts
180
+ make clean-all # Clean everything including virtual environment
163
181
  make help # Show all available commands
164
182
  ```
165
183
 
@@ -175,18 +193,24 @@ Edit providers.yaml in the root directory to add custom API endpoints. The syste
175
193
 
176
194
  ```
177
195
  my_custom_search:
178
- url: https://api.example.com/search
179
- method: “GET”
180
- headers:
181
- Authorization: “Bearer {api_key}”
182
- params:
183
- q: “{query}”
184
- response_mapping:
185
- root_path: “data.items”
186
- fields:
187
- title: “title”
188
- url: “link”
189
- snippet: “snippet”
196
+ url: "https://api.example.com/search"
197
+ method: "POST"
198
+ headers:
199
+ "Accept": "application/json"
200
+ "Authorization": "Bearer {api_key}"
201
+ "Content-Type": "application/json"
202
+ payload:
203
+ query: "{query}"
204
+ count: "{limit}"
205
+ response_mapping:
206
+ root_path: "results.result"
207
+ server_latency_path: "took"
208
+ fields:
209
+ url: "url"
210
+ title: "title"
211
+ site_name: "site_name"
212
+ site_icon: "site_icon"
213
+ page_age: "page_age"
190
214
  ```
191
215
 
192
216
  ## License
@@ -0,0 +1,19 @@
1
+ search_api_webui/__init__.py,sha256=8lqDjWnBOwF_NhSK9_JZDg19zxwal21cOaN-hqBZNLE,1101
2
+ search_api_webui/app.py,sha256=k23YqnBtnNoqsLtZNLZNx0a4pOsccY1MLze6LkQl7Mc,11997
3
+ search_api_webui/providers.yaml,sha256=diNeVXRwakYDycgQuh83V_RmWSH_9kBMg94Kdibs7DU,3425
4
+ search_api_webui/ruff.toml,sha256=4XrS5KAylffZi6_DL8i0rvDVxZtfDgFLmltmTc8XXF8,608
5
+ search_api_webui/providers/__init__.py,sha256=bvCGjIyFzEFpj4gwMMhjcVz5FINkHg06HTfcI8Wt1BA,2185
6
+ search_api_webui/providers/base.py,sha256=1pOirPROqSpWrOJucQADv8xG65eVCplSs1OsDdVq1c0,5167
7
+ search_api_webui/providers/generic.py,sha256=x7jD48XYl5MmqPmkwX-5fQfWMsSjQSZ9e8QRT6_wRZQ,12583
8
+ search_api_webui/providers/querit.py,sha256=XC6CdRqxvsixqMmDh94CGD-982x_Tn5OIp-xp-F9fFY,4330
9
+ search_api_webui/static/AppIcon.icns,sha256=oQLr-jHi7RkzJoz0JIAQFyW9A4YMPsOdLh7sEtYbOT8,470797
10
+ search_api_webui/static/AppIcon.ico,sha256=xnHL8bRN41mJi_yredfLol8R4V30ijXwTha3AmMznpI,59929
11
+ search_api_webui/static/favicon.ico,sha256=U_7TbOXM0jf963y9j0jogM0rBpKNr72HVVOofnBNAVQ,15086
12
+ search_api_webui/static/index.html,sha256=0OcROEPuBextjAUFCIjLGx2qKXSoFFrNiI3_a7WRKnw,465
13
+ search_api_webui/static/assets/index-BWsitD55.css,sha256=4Cd91W8ogAPJdpt1aFPxXazB7RcPPeMlartV7fMc2E4,20841
14
+ search_api_webui/static/assets/index-CEkM4WD5.js,sha256=f7z6F8WgD13rkXqyc-ponh04onwVXr5TqdJaa7EJinw,217999
15
+ search_api_webui-0.2.2.dist-info/METADATA,sha256=bb7LNQ7JZh1WDFS96-PQDrcvDfK9TSWd-jqrg9wy0rc,6846
16
+ search_api_webui-0.2.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
17
+ search_api_webui-0.2.2.dist-info/entry_points.txt,sha256=ogYy3eeonZ_oQlrEZC-4JBWfYdB7kkkdqXUUmX0xgMs,63
18
+ search_api_webui-0.2.2.dist-info/licenses/LICENSE,sha256=B7n2gauZcaVVVdE-zvx3mABAgGzgzVKu7x1a94ZeuPU,1074
19
+ search_api_webui-0.2.2.dist-info/RECORD,,