webscout 7.9__py3-none-any.whl → 8.1__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.

Potentially problematic release.


This version of webscout might be problematic. Click here for more details.

Files changed (69) hide show
  1. webscout/Extra/GitToolkit/__init__.py +10 -0
  2. webscout/Extra/GitToolkit/gitapi/__init__.py +12 -0
  3. webscout/Extra/GitToolkit/gitapi/repository.py +195 -0
  4. webscout/Extra/GitToolkit/gitapi/user.py +96 -0
  5. webscout/Extra/GitToolkit/gitapi/utils.py +62 -0
  6. webscout/Extra/YTToolkit/ytapi/video.py +232 -103
  7. webscout/Provider/AISEARCH/DeepFind.py +1 -1
  8. webscout/Provider/AISEARCH/ISou.py +1 -1
  9. webscout/Provider/AISEARCH/__init__.py +6 -1
  10. webscout/Provider/AISEARCH/felo_search.py +1 -1
  11. webscout/Provider/AISEARCH/genspark_search.py +1 -1
  12. webscout/Provider/AISEARCH/hika_search.py +194 -0
  13. webscout/Provider/AISEARCH/iask_search.py +436 -0
  14. webscout/Provider/AISEARCH/monica_search.py +246 -0
  15. webscout/Provider/AISEARCH/scira_search.py +320 -0
  16. webscout/Provider/AISEARCH/webpilotai_search.py +281 -0
  17. webscout/Provider/AllenAI.py +255 -122
  18. webscout/Provider/DeepSeek.py +1 -2
  19. webscout/Provider/Deepinfra.py +17 -9
  20. webscout/Provider/ExaAI.py +261 -0
  21. webscout/Provider/ExaChat.py +8 -1
  22. webscout/Provider/GithubChat.py +2 -1
  23. webscout/Provider/Jadve.py +2 -2
  24. webscout/Provider/Netwrck.py +3 -2
  25. webscout/Provider/OPENAI/__init__.py +17 -0
  26. webscout/Provider/OPENAI/base.py +46 -0
  27. webscout/Provider/OPENAI/c4ai.py +347 -0
  28. webscout/Provider/OPENAI/chatgptclone.py +460 -0
  29. webscout/Provider/OPENAI/deepinfra.py +284 -0
  30. webscout/Provider/OPENAI/exaai.py +419 -0
  31. webscout/Provider/OPENAI/exachat.py +421 -0
  32. webscout/Provider/OPENAI/freeaichat.py +355 -0
  33. webscout/Provider/OPENAI/glider.py +314 -0
  34. webscout/Provider/OPENAI/heckai.py +337 -0
  35. webscout/Provider/OPENAI/llmchatco.py +325 -0
  36. webscout/Provider/OPENAI/netwrck.py +348 -0
  37. webscout/Provider/OPENAI/scirachat.py +459 -0
  38. webscout/Provider/OPENAI/sonus.py +294 -0
  39. webscout/Provider/OPENAI/typegpt.py +361 -0
  40. webscout/Provider/OPENAI/utils.py +211 -0
  41. webscout/Provider/OPENAI/venice.py +428 -0
  42. webscout/Provider/OPENAI/wisecat.py +381 -0
  43. webscout/Provider/OPENAI/x0gpt.py +389 -0
  44. webscout/Provider/OPENAI/yep.py +329 -0
  45. webscout/Provider/OpenGPT.py +199 -0
  46. webscout/Provider/PI.py +39 -24
  47. webscout/Provider/Venice.py +1 -1
  48. webscout/Provider/Youchat.py +326 -296
  49. webscout/Provider/__init__.py +16 -6
  50. webscout/Provider/ai4chat.py +58 -56
  51. webscout/Provider/akashgpt.py +34 -22
  52. webscout/Provider/freeaichat.py +1 -1
  53. webscout/Provider/labyrinth.py +121 -20
  54. webscout/Provider/llmchatco.py +306 -0
  55. webscout/Provider/scira_chat.py +274 -0
  56. webscout/Provider/typefully.py +280 -0
  57. webscout/Provider/typegpt.py +3 -184
  58. webscout/prompt_manager.py +2 -1
  59. webscout/version.py +1 -1
  60. webscout/webscout_search.py +118 -54
  61. webscout/webscout_search_async.py +109 -45
  62. webscout-8.1.dist-info/METADATA +683 -0
  63. {webscout-7.9.dist-info → webscout-8.1.dist-info}/RECORD +67 -33
  64. webscout/Provider/flowith.py +0 -207
  65. webscout-7.9.dist-info/METADATA +0 -995
  66. {webscout-7.9.dist-info → webscout-8.1.dist-info}/LICENSE.md +0 -0
  67. {webscout-7.9.dist-info → webscout-8.1.dist-info}/WHEEL +0 -0
  68. {webscout-7.9.dist-info → webscout-8.1.dist-info}/entry_points.txt +0 -0
  69. {webscout-7.9.dist-info → webscout-8.1.dist-info}/top_level.txt +0 -0
@@ -0,0 +1,381 @@
1
+ import time
2
+ import uuid
3
+ import requests
4
+ import re
5
+ import json
6
+ from typing import List, Dict, Optional, Union, Generator, Any
7
+
8
+ # Import base classes and utility structures
9
+ from .base import OpenAICompatibleProvider, BaseChat, BaseCompletions
10
+ from .utils import (
11
+ ChatCompletionChunk, ChatCompletion, Choice, ChoiceDelta,
12
+ ChatCompletionMessage, CompletionUsage
13
+ )
14
+
15
+ # Attempt to import LitAgent, fallback if not available
16
+ try:
17
+ from webscout.litagent import LitAgent
18
+ except ImportError:
19
+ # Define a dummy LitAgent if webscout is not installed or accessible
20
+ class LitAgent:
21
+ def generate_fingerprint(self, browser: str = "chrome") -> Dict[str, Any]:
22
+ # Return minimal default headers if LitAgent is unavailable
23
+ print("Warning: LitAgent not found. Using default minimal headers.")
24
+ return {
25
+ "accept": "*/*",
26
+ "accept_language": "en-US,en;q=0.9",
27
+ "platform": "Windows",
28
+ "sec_ch_ua": '"Not/A)Brand";v="99", "Google Chrome";v="127", "Chromium";v="127"',
29
+ "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36",
30
+ "browser_type": browser,
31
+ }
32
+
33
+ # --- WiseCat Client ---
34
+
35
+ class Completions(BaseCompletions):
36
+ def __init__(self, client: 'WiseCat'):
37
+ self._client = client
38
+
39
+ def create(
40
+ self,
41
+ *,
42
+ model: str,
43
+ messages: List[Dict[str, str]],
44
+ max_tokens: Optional[int] = 2049,
45
+ stream: bool = False,
46
+ temperature: Optional[float] = None,
47
+ top_p: Optional[float] = None,
48
+ **kwargs: Any
49
+ ) -> Union[ChatCompletion, Generator[ChatCompletionChunk, None, None]]:
50
+ """
51
+ Creates a model response for the given chat conversation.
52
+ Mimics openai.chat.completions.create
53
+ """
54
+ # Prepare the payload for WiseCat API
55
+ payload = {
56
+ "id": "ephemeral",
57
+ "messages": messages,
58
+ "selectedChatModel": self._client.convert_model_name(model)
59
+ }
60
+
61
+ # Add optional parameters if provided
62
+ if max_tokens is not None and max_tokens > 0:
63
+ payload["max_tokens"] = max_tokens
64
+
65
+ if temperature is not None:
66
+ payload["temperature"] = temperature
67
+
68
+ if top_p is not None:
69
+ payload["top_p"] = top_p
70
+
71
+ # Add any additional parameters
72
+ payload.update(kwargs)
73
+
74
+ request_id = f"chatcmpl-{uuid.uuid4()}"
75
+ created_time = int(time.time())
76
+
77
+ if stream:
78
+ return self._create_stream(request_id, created_time, model, payload)
79
+ else:
80
+ return self._create_non_stream(request_id, created_time, model, payload)
81
+
82
+ def _create_stream(
83
+ self, request_id: str, created_time: int, model: str, payload: Dict[str, Any]
84
+ ) -> Generator[ChatCompletionChunk, None, None]:
85
+ try:
86
+ response = self._client.session.post(
87
+ self._client.api_endpoint,
88
+ headers=self._client.headers,
89
+ json=payload,
90
+ stream=True,
91
+ timeout=self._client.timeout
92
+ )
93
+
94
+ # Handle non-200 responses
95
+ if not response.ok:
96
+ raise IOError(
97
+ f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
98
+ )
99
+
100
+ # Track token usage across chunks
101
+ prompt_tokens = 0
102
+ completion_tokens = 0
103
+ total_tokens = 0
104
+
105
+ # Estimate prompt tokens based on message length
106
+ for msg in payload.get("messages", []):
107
+ prompt_tokens += len(msg.get("content", "").split())
108
+
109
+ for line in response.iter_lines():
110
+ if line:
111
+ decoded_line = line.decode('utf-8').strip()
112
+
113
+ # WiseCat uses a different format, so we need to extract the content
114
+ match = re.search(r'0:"(.*?)"', decoded_line)
115
+ if match:
116
+ content = match.group(1)
117
+
118
+ # Format the content (replace escaped newlines)
119
+ content = self._client.format_text(content)
120
+
121
+ # Update token counts
122
+ completion_tokens += 1
123
+ total_tokens = prompt_tokens + completion_tokens
124
+
125
+ # Create the delta object
126
+ delta = ChoiceDelta(
127
+ content=content,
128
+ role="assistant",
129
+ tool_calls=None
130
+ )
131
+
132
+ # Create the choice object
133
+ choice = Choice(
134
+ index=0,
135
+ delta=delta,
136
+ finish_reason=None,
137
+ logprobs=None
138
+ )
139
+
140
+ # Create the chunk object
141
+ chunk = ChatCompletionChunk(
142
+ id=request_id,
143
+ choices=[choice],
144
+ created=created_time,
145
+ model=model,
146
+ system_fingerprint=None
147
+ )
148
+
149
+ # Convert to dict for proper formatting
150
+ chunk_dict = chunk.to_dict()
151
+
152
+ # Add usage information to match OpenAI format
153
+ usage_dict = {
154
+ "prompt_tokens": prompt_tokens,
155
+ "completion_tokens": completion_tokens,
156
+ "total_tokens": total_tokens,
157
+ "estimated_cost": None
158
+ }
159
+
160
+ chunk_dict["usage"] = usage_dict
161
+
162
+ # Return the chunk object for internal processing
163
+ yield chunk
164
+
165
+ # Final chunk with finish_reason="stop"
166
+ delta = ChoiceDelta(
167
+ content=None,
168
+ role=None,
169
+ tool_calls=None
170
+ )
171
+
172
+ choice = Choice(
173
+ index=0,
174
+ delta=delta,
175
+ finish_reason="stop",
176
+ logprobs=None
177
+ )
178
+
179
+ chunk = ChatCompletionChunk(
180
+ id=request_id,
181
+ choices=[choice],
182
+ created=created_time,
183
+ model=model,
184
+ system_fingerprint=None
185
+ )
186
+
187
+ chunk_dict = chunk.to_dict()
188
+ chunk_dict["usage"] = {
189
+ "prompt_tokens": prompt_tokens,
190
+ "completion_tokens": completion_tokens,
191
+ "total_tokens": total_tokens,
192
+ "estimated_cost": None
193
+ }
194
+
195
+ yield chunk
196
+
197
+ except Exception as e:
198
+ print(f"Error during WiseCat stream request: {e}")
199
+ raise IOError(f"WiseCat request failed: {e}") from e
200
+
201
+ def _create_non_stream(
202
+ self, request_id: str, created_time: int, model: str, payload: Dict[str, Any]
203
+ ) -> ChatCompletion:
204
+ try:
205
+ # For non-streaming, we still use streaming internally to collect the full response
206
+ response = self._client.session.post(
207
+ self._client.api_endpoint,
208
+ headers=self._client.headers,
209
+ json=payload,
210
+ stream=True,
211
+ timeout=self._client.timeout
212
+ )
213
+
214
+ # Handle non-200 responses
215
+ if not response.ok:
216
+ raise IOError(
217
+ f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
218
+ )
219
+
220
+ # Collect the full response
221
+ full_text = ""
222
+ for line in response.iter_lines(decode_unicode=True):
223
+ if line:
224
+ match = re.search(r'0:"(.*?)"', line)
225
+ if match:
226
+ content = match.group(1)
227
+ full_text += content
228
+
229
+ # Format the text (replace escaped newlines)
230
+ full_text = self._client.format_text(full_text)
231
+
232
+ # Estimate token counts
233
+ prompt_tokens = 0
234
+ for msg in payload.get("messages", []):
235
+ prompt_tokens += len(msg.get("content", "").split())
236
+
237
+ completion_tokens = len(full_text.split())
238
+ total_tokens = prompt_tokens + completion_tokens
239
+
240
+ # Create the message object
241
+ message = ChatCompletionMessage(
242
+ role="assistant",
243
+ content=full_text
244
+ )
245
+
246
+ # Create the choice object
247
+ choice = Choice(
248
+ index=0,
249
+ message=message,
250
+ finish_reason="stop"
251
+ )
252
+
253
+ # Create the usage object
254
+ usage = CompletionUsage(
255
+ prompt_tokens=prompt_tokens,
256
+ completion_tokens=completion_tokens,
257
+ total_tokens=total_tokens
258
+ )
259
+
260
+ # Create the completion object
261
+ completion = ChatCompletion(
262
+ id=request_id,
263
+ choices=[choice],
264
+ created=created_time,
265
+ model=model,
266
+ usage=usage,
267
+ )
268
+
269
+ return completion
270
+
271
+ except Exception as e:
272
+ print(f"Error during WiseCat non-stream request: {e}")
273
+ raise IOError(f"WiseCat request failed: {e}") from e
274
+
275
+ class Chat(BaseChat):
276
+ def __init__(self, client: 'WiseCat'):
277
+ self.completions = Completions(client)
278
+
279
+ class WiseCat(OpenAICompatibleProvider):
280
+ """
281
+ OpenAI-compatible client for WiseCat API.
282
+
283
+ Usage:
284
+ client = WiseCat()
285
+ response = client.chat.completions.create(
286
+ model="chat-model-large",
287
+ messages=[{"role": "user", "content": "Hello!"}]
288
+ )
289
+ """
290
+
291
+ AVAILABLE_MODELS = [
292
+ "chat-model-small",
293
+ "chat-model-large",
294
+ "chat-model-reasoning",
295
+ ]
296
+
297
+ # No model mapping needed as we use the model names directly
298
+
299
+ def __init__(
300
+ self,
301
+ timeout: Optional[int] = None,
302
+ browser: str = "chrome"
303
+ ):
304
+ """
305
+ Initialize the WiseCat client.
306
+
307
+ Args:
308
+ timeout: Request timeout in seconds (None for no timeout)
309
+ browser: Browser to emulate in user agent
310
+ """
311
+ self.timeout = timeout
312
+ self.api_endpoint = "https://wise-cat-groq.vercel.app/api/chat"
313
+ self.session = requests.Session()
314
+
315
+ # Initialize LitAgent for user agent generation
316
+ agent = LitAgent()
317
+ self.fingerprint = agent.generate_fingerprint(browser)
318
+
319
+ # Use the fingerprint for headers
320
+ self.headers = self.fingerprint
321
+
322
+ self.session.headers.update(self.headers)
323
+
324
+ # Initialize the chat interface
325
+ self.chat = Chat(self)
326
+
327
+ def format_text(self, text: str) -> str:
328
+ """
329
+ Format text by replacing escaped newlines with actual newlines.
330
+
331
+ Args:
332
+ text: Text to format
333
+
334
+ Returns:
335
+ Formatted text
336
+ """
337
+ # Use a more comprehensive approach to handle all escape sequences
338
+ try:
339
+ # First handle double backslashes to avoid issues
340
+ text = text.replace('\\\\', '\\')
341
+
342
+ # Handle common escape sequences
343
+ text = text.replace('\\n', '\n')
344
+ text = text.replace('\\r', '\r')
345
+ text = text.replace('\\t', '\t')
346
+ text = text.replace('\\"', '"')
347
+ text = text.replace("\\'", "'")
348
+
349
+ # Handle any remaining escape sequences using JSON decoding
350
+ # This is a fallback in case there are other escape sequences
351
+ try:
352
+ # Add quotes to make it a valid JSON string
353
+ json_str = f'"{text}"'
354
+ # Use json module to decode all escape sequences
355
+ decoded = json.loads(json_str)
356
+ return decoded
357
+ except json.JSONDecodeError:
358
+ # If JSON decoding fails, return the text with the replacements we've already done
359
+ return text
360
+ except Exception as e:
361
+ # If any error occurs, return the original text
362
+ print(f"Warning: Error formatting text: {e}")
363
+ return text
364
+
365
+ def convert_model_name(self, model: str) -> str:
366
+ """
367
+ Convert model names to ones supported by WiseCat.
368
+
369
+ Args:
370
+ model: Model name to convert
371
+
372
+ Returns:
373
+ WiseCat model name
374
+ """
375
+ # If the model is already a valid WiseCat model, return it
376
+ if model in self.AVAILABLE_MODELS:
377
+ return model
378
+
379
+ # Default to the most capable model
380
+ print(f"Warning: Unknown model '{model}'. Using 'chat-model-large' instead.")
381
+ return "chat-model-large"