webscout 8.3.7__py3-none-any.whl → 2025.10.13__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 (306) hide show
  1. webscout/AIauto.py +250 -250
  2. webscout/AIbase.py +379 -379
  3. webscout/AIutel.py +60 -60
  4. webscout/Bard.py +1012 -1012
  5. webscout/Bing_search.py +417 -417
  6. webscout/DWEBS.py +529 -529
  7. webscout/Extra/Act.md +309 -309
  8. webscout/Extra/GitToolkit/__init__.py +10 -10
  9. webscout/Extra/GitToolkit/gitapi/README.md +110 -110
  10. webscout/Extra/GitToolkit/gitapi/__init__.py +11 -11
  11. webscout/Extra/GitToolkit/gitapi/repository.py +195 -195
  12. webscout/Extra/GitToolkit/gitapi/user.py +96 -96
  13. webscout/Extra/GitToolkit/gitapi/utils.py +61 -61
  14. webscout/Extra/YTToolkit/README.md +375 -375
  15. webscout/Extra/YTToolkit/YTdownloader.py +956 -956
  16. webscout/Extra/YTToolkit/__init__.py +2 -2
  17. webscout/Extra/YTToolkit/transcriber.py +475 -475
  18. webscout/Extra/YTToolkit/ytapi/README.md +44 -44
  19. webscout/Extra/YTToolkit/ytapi/__init__.py +6 -6
  20. webscout/Extra/YTToolkit/ytapi/channel.py +307 -307
  21. webscout/Extra/YTToolkit/ytapi/errors.py +13 -13
  22. webscout/Extra/YTToolkit/ytapi/extras.py +118 -118
  23. webscout/Extra/YTToolkit/ytapi/https.py +88 -88
  24. webscout/Extra/YTToolkit/ytapi/patterns.py +61 -61
  25. webscout/Extra/YTToolkit/ytapi/playlist.py +58 -58
  26. webscout/Extra/YTToolkit/ytapi/pool.py +7 -7
  27. webscout/Extra/YTToolkit/ytapi/query.py +39 -39
  28. webscout/Extra/YTToolkit/ytapi/stream.py +62 -62
  29. webscout/Extra/YTToolkit/ytapi/utils.py +62 -62
  30. webscout/Extra/YTToolkit/ytapi/video.py +232 -232
  31. webscout/Extra/autocoder/__init__.py +9 -9
  32. webscout/Extra/autocoder/autocoder.py +1105 -1105
  33. webscout/Extra/autocoder/autocoder_utiles.py +332 -332
  34. webscout/Extra/gguf.md +429 -429
  35. webscout/Extra/gguf.py +1213 -1213
  36. webscout/Extra/tempmail/README.md +487 -487
  37. webscout/Extra/tempmail/__init__.py +27 -27
  38. webscout/Extra/tempmail/async_utils.py +140 -140
  39. webscout/Extra/tempmail/base.py +160 -160
  40. webscout/Extra/tempmail/cli.py +186 -186
  41. webscout/Extra/tempmail/emailnator.py +84 -84
  42. webscout/Extra/tempmail/mail_tm.py +360 -360
  43. webscout/Extra/tempmail/temp_mail_io.py +291 -291
  44. webscout/Extra/weather.md +281 -281
  45. webscout/Extra/weather.py +193 -193
  46. webscout/Litlogger/README.md +10 -10
  47. webscout/Litlogger/__init__.py +15 -15
  48. webscout/Litlogger/formats.py +13 -13
  49. webscout/Litlogger/handlers.py +121 -121
  50. webscout/Litlogger/levels.py +13 -13
  51. webscout/Litlogger/logger.py +134 -134
  52. webscout/Provider/AISEARCH/Perplexity.py +332 -332
  53. webscout/Provider/AISEARCH/README.md +279 -279
  54. webscout/Provider/AISEARCH/__init__.py +16 -1
  55. webscout/Provider/AISEARCH/felo_search.py +206 -206
  56. webscout/Provider/AISEARCH/genspark_search.py +323 -323
  57. webscout/Provider/AISEARCH/hika_search.py +185 -185
  58. webscout/Provider/AISEARCH/iask_search.py +410 -410
  59. webscout/Provider/AISEARCH/monica_search.py +219 -219
  60. webscout/Provider/AISEARCH/scira_search.py +316 -316
  61. webscout/Provider/AISEARCH/stellar_search.py +177 -177
  62. webscout/Provider/AISEARCH/webpilotai_search.py +255 -255
  63. webscout/Provider/Aitopia.py +314 -314
  64. webscout/Provider/Andi.py +1 -1
  65. webscout/Provider/Apriel.py +306 -0
  66. webscout/Provider/ChatGPTClone.py +237 -236
  67. webscout/Provider/ChatSandbox.py +343 -343
  68. webscout/Provider/Cloudflare.py +324 -324
  69. webscout/Provider/Cohere.py +208 -208
  70. webscout/Provider/Deepinfra.py +370 -366
  71. webscout/Provider/ExaAI.py +260 -260
  72. webscout/Provider/ExaChat.py +308 -308
  73. webscout/Provider/Flowith.py +221 -221
  74. webscout/Provider/GMI.py +293 -0
  75. webscout/Provider/Gemini.py +164 -164
  76. webscout/Provider/GeminiProxy.py +167 -167
  77. webscout/Provider/GithubChat.py +371 -372
  78. webscout/Provider/Groq.py +800 -800
  79. webscout/Provider/HeckAI.py +383 -383
  80. webscout/Provider/Jadve.py +282 -282
  81. webscout/Provider/K2Think.py +307 -307
  82. webscout/Provider/Koboldai.py +205 -205
  83. webscout/Provider/LambdaChat.py +423 -423
  84. webscout/Provider/Nemotron.py +244 -244
  85. webscout/Provider/Netwrck.py +248 -248
  86. webscout/Provider/OLLAMA.py +395 -395
  87. webscout/Provider/OPENAI/Cloudflare.py +393 -393
  88. webscout/Provider/OPENAI/FalconH1.py +451 -451
  89. webscout/Provider/OPENAI/FreeGemini.py +296 -296
  90. webscout/Provider/OPENAI/K2Think.py +431 -431
  91. webscout/Provider/OPENAI/NEMOTRON.py +240 -240
  92. webscout/Provider/OPENAI/PI.py +427 -427
  93. webscout/Provider/OPENAI/README.md +959 -959
  94. webscout/Provider/OPENAI/TogetherAI.py +345 -345
  95. webscout/Provider/OPENAI/TwoAI.py +465 -465
  96. webscout/Provider/OPENAI/__init__.py +33 -18
  97. webscout/Provider/OPENAI/base.py +248 -248
  98. webscout/Provider/OPENAI/chatglm.py +528 -0
  99. webscout/Provider/OPENAI/chatgpt.py +592 -592
  100. webscout/Provider/OPENAI/chatgptclone.py +521 -521
  101. webscout/Provider/OPENAI/chatsandbox.py +202 -202
  102. webscout/Provider/OPENAI/deepinfra.py +318 -314
  103. webscout/Provider/OPENAI/e2b.py +1665 -1665
  104. webscout/Provider/OPENAI/exaai.py +420 -420
  105. webscout/Provider/OPENAI/exachat.py +452 -452
  106. webscout/Provider/OPENAI/friendli.py +232 -232
  107. webscout/Provider/OPENAI/{refact.py → gmi.py} +324 -274
  108. webscout/Provider/OPENAI/groq.py +364 -364
  109. webscout/Provider/OPENAI/heckai.py +314 -314
  110. webscout/Provider/OPENAI/llmchatco.py +337 -337
  111. webscout/Provider/OPENAI/netwrck.py +355 -355
  112. webscout/Provider/OPENAI/oivscode.py +290 -290
  113. webscout/Provider/OPENAI/opkfc.py +518 -518
  114. webscout/Provider/OPENAI/pydantic_imports.py +1 -1
  115. webscout/Provider/OPENAI/scirachat.py +535 -535
  116. webscout/Provider/OPENAI/sonus.py +308 -308
  117. webscout/Provider/OPENAI/standardinput.py +442 -442
  118. webscout/Provider/OPENAI/textpollinations.py +340 -340
  119. webscout/Provider/OPENAI/toolbaz.py +419 -416
  120. webscout/Provider/OPENAI/typefully.py +362 -362
  121. webscout/Provider/OPENAI/utils.py +295 -295
  122. webscout/Provider/OPENAI/venice.py +436 -436
  123. webscout/Provider/OPENAI/wisecat.py +387 -387
  124. webscout/Provider/OPENAI/writecream.py +166 -166
  125. webscout/Provider/OPENAI/x0gpt.py +378 -378
  126. webscout/Provider/OPENAI/yep.py +389 -389
  127. webscout/Provider/OpenGPT.py +230 -230
  128. webscout/Provider/Openai.py +243 -243
  129. webscout/Provider/PI.py +405 -405
  130. webscout/Provider/Perplexitylabs.py +430 -430
  131. webscout/Provider/QwenLM.py +272 -272
  132. webscout/Provider/STT/__init__.py +16 -1
  133. webscout/Provider/Sambanova.py +257 -257
  134. webscout/Provider/StandardInput.py +309 -309
  135. webscout/Provider/TTI/README.md +82 -82
  136. webscout/Provider/TTI/__init__.py +33 -18
  137. webscout/Provider/TTI/aiarta.py +413 -413
  138. webscout/Provider/TTI/base.py +136 -136
  139. webscout/Provider/TTI/bing.py +243 -243
  140. webscout/Provider/TTI/gpt1image.py +149 -149
  141. webscout/Provider/TTI/imagen.py +196 -196
  142. webscout/Provider/TTI/infip.py +211 -211
  143. webscout/Provider/TTI/magicstudio.py +232 -232
  144. webscout/Provider/TTI/monochat.py +219 -219
  145. webscout/Provider/TTI/piclumen.py +214 -214
  146. webscout/Provider/TTI/pixelmuse.py +232 -232
  147. webscout/Provider/TTI/pollinations.py +232 -232
  148. webscout/Provider/TTI/together.py +288 -288
  149. webscout/Provider/TTI/utils.py +12 -12
  150. webscout/Provider/TTI/venice.py +367 -367
  151. webscout/Provider/TTS/README.md +192 -192
  152. webscout/Provider/TTS/__init__.py +33 -18
  153. webscout/Provider/TTS/parler.py +110 -110
  154. webscout/Provider/TTS/streamElements.py +333 -333
  155. webscout/Provider/TTS/utils.py +280 -280
  156. webscout/Provider/TeachAnything.py +237 -237
  157. webscout/Provider/TextPollinationsAI.py +310 -310
  158. webscout/Provider/TogetherAI.py +356 -356
  159. webscout/Provider/TwoAI.py +312 -312
  160. webscout/Provider/TypliAI.py +311 -311
  161. webscout/Provider/UNFINISHED/ChatHub.py +208 -208
  162. webscout/Provider/UNFINISHED/ChutesAI.py +313 -313
  163. webscout/Provider/UNFINISHED/GizAI.py +294 -294
  164. webscout/Provider/UNFINISHED/Marcus.py +198 -198
  165. webscout/Provider/UNFINISHED/Qodo.py +477 -477
  166. webscout/Provider/UNFINISHED/VercelAIGateway.py +338 -338
  167. webscout/Provider/UNFINISHED/XenAI.py +324 -324
  168. webscout/Provider/UNFINISHED/Youchat.py +330 -330
  169. webscout/Provider/UNFINISHED/liner.py +334 -0
  170. webscout/Provider/UNFINISHED/liner_api_request.py +262 -262
  171. webscout/Provider/UNFINISHED/puterjs.py +634 -634
  172. webscout/Provider/UNFINISHED/samurai.py +223 -223
  173. webscout/Provider/UNFINISHED/test_lmarena.py +119 -119
  174. webscout/Provider/Venice.py +250 -250
  175. webscout/Provider/VercelAI.py +256 -256
  176. webscout/Provider/WiseCat.py +231 -231
  177. webscout/Provider/WrDoChat.py +366 -366
  178. webscout/Provider/__init__.py +33 -18
  179. webscout/Provider/ai4chat.py +174 -174
  180. webscout/Provider/akashgpt.py +331 -331
  181. webscout/Provider/cerebras.py +446 -446
  182. webscout/Provider/chatglm.py +394 -301
  183. webscout/Provider/cleeai.py +211 -211
  184. webscout/Provider/elmo.py +282 -282
  185. webscout/Provider/geminiapi.py +208 -208
  186. webscout/Provider/granite.py +261 -261
  187. webscout/Provider/hermes.py +263 -263
  188. webscout/Provider/julius.py +223 -223
  189. webscout/Provider/learnfastai.py +309 -309
  190. webscout/Provider/llama3mitril.py +214 -214
  191. webscout/Provider/llmchat.py +243 -243
  192. webscout/Provider/llmchatco.py +290 -290
  193. webscout/Provider/meta.py +801 -801
  194. webscout/Provider/oivscode.py +309 -309
  195. webscout/Provider/scira_chat.py +383 -383
  196. webscout/Provider/searchchat.py +292 -292
  197. webscout/Provider/sonus.py +258 -258
  198. webscout/Provider/toolbaz.py +370 -367
  199. webscout/Provider/turboseek.py +273 -273
  200. webscout/Provider/typefully.py +207 -207
  201. webscout/Provider/yep.py +372 -372
  202. webscout/__init__.py +27 -31
  203. webscout/__main__.py +5 -5
  204. webscout/auth/api_key_manager.py +189 -189
  205. webscout/auth/config.py +175 -175
  206. webscout/auth/models.py +185 -185
  207. webscout/auth/routes.py +663 -664
  208. webscout/auth/simple_logger.py +236 -236
  209. webscout/cli.py +523 -523
  210. webscout/conversation.py +438 -438
  211. webscout/exceptions.py +361 -361
  212. webscout/litagent/Readme.md +298 -298
  213. webscout/litagent/__init__.py +28 -28
  214. webscout/litagent/agent.py +581 -581
  215. webscout/litagent/constants.py +59 -59
  216. webscout/litprinter/__init__.py +58 -58
  217. webscout/models.py +181 -181
  218. webscout/optimizers.py +419 -419
  219. webscout/prompt_manager.py +288 -288
  220. webscout/sanitize.py +1078 -1078
  221. webscout/scout/README.md +401 -401
  222. webscout/scout/__init__.py +8 -8
  223. webscout/scout/core/__init__.py +6 -6
  224. webscout/scout/core/crawler.py +297 -297
  225. webscout/scout/core/scout.py +706 -706
  226. webscout/scout/core/search_result.py +95 -95
  227. webscout/scout/core/text_analyzer.py +62 -62
  228. webscout/scout/core/text_utils.py +277 -277
  229. webscout/scout/core/web_analyzer.py +51 -51
  230. webscout/scout/element.py +599 -599
  231. webscout/scout/parsers/__init__.py +69 -69
  232. webscout/scout/parsers/html5lib_parser.py +172 -172
  233. webscout/scout/parsers/html_parser.py +236 -236
  234. webscout/scout/parsers/lxml_parser.py +178 -178
  235. webscout/scout/utils.py +37 -37
  236. webscout/search/__init__.py +51 -0
  237. webscout/search/base.py +195 -0
  238. webscout/search/duckduckgo_main.py +54 -0
  239. webscout/search/engines/__init__.py +48 -0
  240. webscout/search/engines/bing.py +84 -0
  241. webscout/search/engines/bing_news.py +52 -0
  242. webscout/search/engines/brave.py +43 -0
  243. webscout/search/engines/duckduckgo/__init__.py +25 -0
  244. webscout/search/engines/duckduckgo/answers.py +78 -0
  245. webscout/search/engines/duckduckgo/base.py +187 -0
  246. webscout/search/engines/duckduckgo/images.py +97 -0
  247. webscout/search/engines/duckduckgo/maps.py +168 -0
  248. webscout/search/engines/duckduckgo/news.py +68 -0
  249. webscout/search/engines/duckduckgo/suggestions.py +21 -0
  250. webscout/search/engines/duckduckgo/text.py +211 -0
  251. webscout/search/engines/duckduckgo/translate.py +47 -0
  252. webscout/search/engines/duckduckgo/videos.py +63 -0
  253. webscout/search/engines/duckduckgo/weather.py +74 -0
  254. webscout/search/engines/mojeek.py +37 -0
  255. webscout/search/engines/wikipedia.py +56 -0
  256. webscout/search/engines/yahoo.py +65 -0
  257. webscout/search/engines/yahoo_news.py +64 -0
  258. webscout/search/engines/yandex.py +43 -0
  259. webscout/search/engines/yep/__init__.py +13 -0
  260. webscout/search/engines/yep/base.py +32 -0
  261. webscout/search/engines/yep/images.py +99 -0
  262. webscout/search/engines/yep/suggestions.py +35 -0
  263. webscout/search/engines/yep/text.py +114 -0
  264. webscout/search/http_client.py +156 -0
  265. webscout/search/results.py +137 -0
  266. webscout/search/yep_main.py +44 -0
  267. webscout/swiftcli/Readme.md +323 -323
  268. webscout/swiftcli/__init__.py +95 -95
  269. webscout/swiftcli/core/__init__.py +7 -7
  270. webscout/swiftcli/core/cli.py +308 -308
  271. webscout/swiftcli/core/context.py +104 -104
  272. webscout/swiftcli/core/group.py +241 -241
  273. webscout/swiftcli/decorators/__init__.py +28 -28
  274. webscout/swiftcli/decorators/command.py +221 -221
  275. webscout/swiftcli/decorators/options.py +220 -220
  276. webscout/swiftcli/decorators/output.py +302 -302
  277. webscout/swiftcli/exceptions.py +21 -21
  278. webscout/swiftcli/plugins/__init__.py +9 -9
  279. webscout/swiftcli/plugins/base.py +135 -135
  280. webscout/swiftcli/plugins/manager.py +269 -269
  281. webscout/swiftcli/utils/__init__.py +59 -59
  282. webscout/swiftcli/utils/formatting.py +252 -252
  283. webscout/swiftcli/utils/parsing.py +267 -267
  284. webscout/update_checker.py +117 -117
  285. webscout/version.py +1 -1
  286. webscout/version.py.bak +2 -0
  287. webscout/zeroart/README.md +89 -89
  288. webscout/zeroart/__init__.py +134 -134
  289. webscout/zeroart/base.py +66 -66
  290. webscout/zeroart/effects.py +100 -100
  291. webscout/zeroart/fonts.py +1238 -1238
  292. {webscout-8.3.7.dist-info → webscout-2025.10.13.dist-info}/METADATA +936 -937
  293. webscout-2025.10.13.dist-info/RECORD +329 -0
  294. webscout/Provider/AISEARCH/DeepFind.py +0 -254
  295. webscout/Provider/OPENAI/Qwen3.py +0 -303
  296. webscout/Provider/OPENAI/qodo.py +0 -630
  297. webscout/Provider/OPENAI/xenai.py +0 -514
  298. webscout/tempid.py +0 -134
  299. webscout/webscout_search.py +0 -1183
  300. webscout/webscout_search_async.py +0 -649
  301. webscout/yep_search.py +0 -346
  302. webscout-8.3.7.dist-info/RECORD +0 -301
  303. {webscout-8.3.7.dist-info → webscout-2025.10.13.dist-info}/WHEEL +0 -0
  304. {webscout-8.3.7.dist-info → webscout-2025.10.13.dist-info}/entry_points.txt +0 -0
  305. {webscout-8.3.7.dist-info → webscout-2025.10.13.dist-info}/licenses/LICENSE.md +0 -0
  306. {webscout-8.3.7.dist-info → webscout-2025.10.13.dist-info}/top_level.txt +0 -0
@@ -1,309 +1,309 @@
1
- from curl_cffi import CurlError
2
- from curl_cffi.requests import Session, Response # Import Response
3
- import json
4
- import uuid
5
- from typing import Any, Dict, Union, Optional, List, Generator
6
- from datetime import datetime
7
- from webscout.AIutel import Optimizers, Conversation, AwesomePrompts, sanitize_stream # Import sanitize_stream
8
- from webscout.AIbase import Provider
9
- from webscout import exceptions
10
- from webscout.litagent import LitAgent
11
-
12
- # Model configurations
13
- MODEL_CONFIGS = {
14
- "gemini": {
15
- "endpoint": "https://ayle.chat/api/gemini",
16
- "models": [
17
- "gemini-2.0-flash",
18
- "gemini-2.5-flash",
19
-
20
-
21
- ],
22
- },
23
- "cerebras": {
24
- "endpoint": "https://ayle.chat/api/cerebras",
25
- "models": [
26
- "llama3.1-8b",
27
- "llama-3.3-70b",
28
- "llama-4-scout-17b-16e-instruct",
29
- "qwen-3-32b"
30
- ],
31
- },
32
- }
33
-
34
- class ExaChat(Provider):
35
- """
36
- A class to interact with multiple AI APIs through the Exa Chat interface.
37
- """
38
- required_auth = False
39
- AVAILABLE_MODELS = [
40
- "gemini-2.0-flash",
41
- "gemini-2.5-flash",
42
-
43
- # Cerebras Models
44
- "llama3.1-8b",
45
- "llama-3.3-70b",
46
- "llama-4-scout-17b-16e-instruct",
47
- "qwen-3-32b",
48
-
49
- ]
50
-
51
- def __init__(
52
- self,
53
- is_conversation: bool = True,
54
- max_tokens: int = 4000,
55
- timeout: int = 30,
56
- intro: str = None,
57
- filepath: str = None,
58
- update_file: bool = True,
59
- proxies: dict = {},
60
- history_offset: int = 10250,
61
- act: str = None,
62
- model: str = "exaanswer",
63
- system_prompt: str = "You are a friendly, helpful AI assistant.",
64
- temperature: float = 0.5,
65
- presence_penalty: int = 0,
66
- frequency_penalty: int = 0,
67
- top_p: float = 1
68
- ):
69
- """Initializes the ExaChat client."""
70
- if model not in self.AVAILABLE_MODELS:
71
- raise ValueError(f"Invalid model: {model}. Choose from: {self.AVAILABLE_MODELS}")
72
-
73
- self.session = Session() # Use curl_cffi Session
74
- self.is_conversation = is_conversation
75
- self.max_tokens_to_sample = max_tokens
76
- self.timeout = timeout
77
- self.last_response = {}
78
- self.model = model
79
- self.system_prompt = system_prompt
80
- self.temperature = temperature
81
- self.presence_penalty = presence_penalty
82
- self.frequency_penalty = frequency_penalty
83
- self.top_p = top_p
84
-
85
- # Initialize LitAgent for user agent generation
86
- self.agent = LitAgent()
87
-
88
- self.headers = {
89
- "accept": "*/*",
90
- "accept-language": "en-US,en;q=0.9",
91
- "content-type": "application/json",
92
- "origin": "https://ayle.chat/",
93
- "referer": "https://ayle.chat/",
94
- "user-agent": self.agent.random(),
95
- }
96
-
97
- self.session.headers.update(self.headers)
98
- self.session.proxies = proxies # Assign proxies directly
99
- self.session.cookies.update({"session": uuid.uuid4().hex})
100
-
101
- self.__available_optimizers = (
102
- method for method in dir(Optimizers)
103
- if callable(getattr(Optimizers, method)) and not method.startswith("__")
104
- )
105
-
106
- Conversation.intro = (
107
- AwesomePrompts().get_act(
108
- act, raise_not_found=True, default=None, case_insensitive=True
109
- )
110
- if act
111
- else intro or Conversation.intro
112
- )
113
-
114
- self.conversation = Conversation(
115
- is_conversation, self.max_tokens_to_sample, filepath, update_file
116
- )
117
- self.conversation.history_offset = history_offset
118
-
119
- self.provider = self._get_provider_from_model(self.model)
120
- self.model_name = self.model
121
-
122
- def _get_endpoint(self) -> str:
123
- """Get the API endpoint for the current provider."""
124
- return MODEL_CONFIGS[self.provider]["endpoint"]
125
-
126
- def _get_provider_from_model(self, model: str) -> str:
127
- """Determine the provider based on the model name."""
128
- for provider, config in MODEL_CONFIGS.items():
129
- if model in config["models"]:
130
- return provider
131
-
132
- available_models = []
133
- for provider, config in MODEL_CONFIGS.items():
134
- for model_name in config["models"]:
135
- available_models.append(f"{provider}/{model_name}")
136
-
137
- error_msg = f"Invalid model: {model}\nAvailable models: {', '.join(available_models)}"
138
- raise ValueError(error_msg)
139
-
140
- @staticmethod
141
- def _exachat_extractor(chunk: Union[str, Dict[str, Any]]) -> Optional[str]:
142
- """Extracts content from ExaChat stream JSON objects."""
143
- if isinstance(chunk, dict):
144
- return chunk.get("choices", [{}])[0].get("delta", {}).get("content")
145
- return None
146
-
147
- def _make_request(self, payload: Dict[str, Any]) -> Response: # Change type hint to Response
148
- """Make the API request with proper error handling."""
149
- try:
150
- response = self.session.post(
151
- self._get_endpoint(),
152
- headers=self.headers,
153
- json=payload,
154
- timeout=self.timeout, # type: ignore
155
- stream=True, # Enable streaming for the request
156
- impersonate="chrome120" # Add impersonate
157
- )
158
- response.raise_for_status()
159
- return response
160
- except (CurlError, exceptions.FailedToGenerateResponseError, Exception) as e: # Catch CurlError and others
161
- raise exceptions.FailedToGenerateResponseError(f"API request failed: {e}") from e
162
-
163
- def _build_payload(self, conversation_prompt: str) -> Dict[str, Any]:
164
- """Build the appropriate payload based on the provider."""
165
- if self.provider == "exaanswer":
166
- return {
167
- "query": conversation_prompt,
168
- "messages": []
169
- }
170
- elif self.provider == "gemini":
171
- return {
172
- "query": conversation_prompt,
173
- "model": self.model,
174
- "messages": []
175
- }
176
- elif self.provider == "cerebras":
177
- return {
178
- "query": conversation_prompt,
179
- "model": self.model,
180
- "messages": []
181
- }
182
- else: # openrouter or groq
183
- return {
184
- "query": conversation_prompt + "\n", # Add newline for openrouter and groq models
185
- "model": self.model,
186
- "messages": []
187
- }
188
-
189
- def ask(
190
- self,
191
- prompt: str,
192
- stream: bool = False,
193
- raw: bool = False,
194
- optimizer: str = None,
195
- conversationally: bool = False,
196
- ) -> Union[Dict[str, Any], Generator[Any, None, None]]:
197
- """Sends a prompt to the API and returns the response."""
198
- conversation_prompt = self.conversation.gen_complete_prompt(prompt)
199
- if optimizer:
200
- if optimizer in self.__available_optimizers:
201
- conversation_prompt = getattr(Optimizers, optimizer)(
202
- conversation_prompt if conversationally else prompt
203
- )
204
- else:
205
- error_msg = f"Optimizer is not one of {self.__available_optimizers}"
206
- raise exceptions.FailedToGenerateResponseError(error_msg)
207
-
208
- payload = self._build_payload(conversation_prompt)
209
- response = self._make_request(payload)
210
- processed_stream = sanitize_stream(
211
- data=response.iter_content(chunk_size=None),
212
- intro_value=None,
213
- to_json=True,
214
- content_extractor=self._exachat_extractor,
215
- yield_raw_on_error=False,
216
- raw=raw
217
- )
218
- if stream:
219
- streaming_text = ""
220
- for content_chunk in processed_stream:
221
- if content_chunk and isinstance(content_chunk, str):
222
- content_chunk = content_chunk.replace('\\\\', '\\').replace('\\"', '"')
223
- if raw:
224
- if content_chunk and isinstance(content_chunk, str):
225
- streaming_text += content_chunk
226
- yield content_chunk
227
- else:
228
- if content_chunk and isinstance(content_chunk, str):
229
- streaming_text += content_chunk
230
- yield dict(text=content_chunk)
231
- self.last_response = {"text": streaming_text}
232
- self.conversation.update_chat_history(prompt, streaming_text)
233
- else:
234
- full_response = ""
235
- for content_chunk in processed_stream:
236
- if content_chunk and isinstance(content_chunk, str):
237
- content_chunk = content_chunk.replace('\\\\', '\\').replace('\\"', '"')
238
- if raw:
239
- if content_chunk and isinstance(content_chunk, str):
240
- full_response += content_chunk
241
- else:
242
- if content_chunk and isinstance(content_chunk, str):
243
- full_response += content_chunk
244
- self.last_response = {"text": full_response}
245
- self.conversation.update_chat_history(prompt, full_response)
246
- return self.last_response if not raw else full_response
247
-
248
- def chat(
249
- self,
250
- prompt: str,
251
- stream: bool = False,
252
- optimizer: str = None,
253
- conversationally: bool = False,
254
- raw: bool = False,
255
- ) -> Union[str, Generator[str, None, None]]:
256
- def for_stream():
257
- for response in self.ask(
258
- prompt, stream=True, raw=raw, optimizer=optimizer, conversationally=conversationally
259
- ):
260
- if raw:
261
- yield response
262
- else:
263
- yield self.get_message(response)
264
- def for_non_stream():
265
- result = self.ask(
266
- prompt, stream=False, raw=raw, optimizer=optimizer, conversationally=conversationally
267
- )
268
- if raw:
269
- return result if isinstance(result, str) else str(result)
270
- return self.get_message(result)
271
- return for_stream() if stream else for_non_stream()
272
-
273
- def get_message(self, response: Union[Dict[str, Any], str]) -> str:
274
- if isinstance(response, dict):
275
- text = response.get("text", "")
276
- else:
277
- text = str(response)
278
- return text.replace('\\\\', '\\').replace('\\"', '"')
279
-
280
- if __name__ == "__main__":
281
- # print("-" * 80)
282
- # print(f"{'Model':<50} {'Status':<10} {'Response'}")
283
- # print("-" * 80)
284
-
285
- # # Test all available models
286
- # working = 0
287
- # total = len(ExaChat.AVAILABLE_MODELS)
288
-
289
- # for model in ExaChat.AVAILABLE_MODELS:
290
- # try:
291
- # test_ai = ExaChat(model=model, timeout=60)
292
- # response = test_ai.chat("Say 'Hello' in one word")
293
- # response_text = response
294
-
295
- # if response_text and len(response_text.strip()) > 0:
296
- # status = "✓"
297
- # # Truncate response if too long
298
- # display_text = response_text.strip()[:50] + "..." if len(response_text.strip()) > 50 else response_text.strip()
299
- # else:
300
- # status = "✗"
301
- # display_text = "Empty or invalid response"
302
- # print(f"{model:<50} {status:<10} {display_text}")
303
- # except Exception as e:
304
- # print(f"{model:<50} {'✗':<10} {str(e)}")
305
- from rich import print
306
- ai = ExaChat(model="gemini-2.0-flash")
307
- response = ai.chat("tell me a joke", stream=True, raw=False)
308
- for chunk in response:
1
+ from curl_cffi import CurlError
2
+ from curl_cffi.requests import Session, Response # Import Response
3
+ import json
4
+ import uuid
5
+ from typing import Any, Dict, Union, Optional, List, Generator
6
+ from datetime import datetime
7
+ from webscout.AIutel import Optimizers, Conversation, AwesomePrompts, sanitize_stream # Import sanitize_stream
8
+ from webscout.AIbase import Provider
9
+ from webscout import exceptions
10
+ from webscout.litagent import LitAgent
11
+
12
+ # Model configurations
13
+ MODEL_CONFIGS = {
14
+ "gemini": {
15
+ "endpoint": "https://ayle.chat/api/gemini",
16
+ "models": [
17
+ "gemini-2.0-flash",
18
+ "gemini-2.5-flash",
19
+
20
+
21
+ ],
22
+ },
23
+ "cerebras": {
24
+ "endpoint": "https://ayle.chat/api/cerebras",
25
+ "models": [
26
+ "llama3.1-8b",
27
+ "llama-3.3-70b",
28
+ "llama-4-scout-17b-16e-instruct",
29
+ "qwen-3-32b"
30
+ ],
31
+ },
32
+ }
33
+
34
+ class ExaChat(Provider):
35
+ """
36
+ A class to interact with multiple AI APIs through the Exa Chat interface.
37
+ """
38
+ required_auth = False
39
+ AVAILABLE_MODELS = [
40
+ "gemini-2.0-flash",
41
+ "gemini-2.5-flash",
42
+
43
+ # Cerebras Models
44
+ "llama3.1-8b",
45
+ "llama-3.3-70b",
46
+ "llama-4-scout-17b-16e-instruct",
47
+ "qwen-3-32b",
48
+
49
+ ]
50
+
51
+ def __init__(
52
+ self,
53
+ is_conversation: bool = True,
54
+ max_tokens: int = 4000,
55
+ timeout: int = 30,
56
+ intro: str = None,
57
+ filepath: str = None,
58
+ update_file: bool = True,
59
+ proxies: dict = {},
60
+ history_offset: int = 10250,
61
+ act: str = None,
62
+ model: str = "exaanswer",
63
+ system_prompt: str = "You are a friendly, helpful AI assistant.",
64
+ temperature: float = 0.5,
65
+ presence_penalty: int = 0,
66
+ frequency_penalty: int = 0,
67
+ top_p: float = 1
68
+ ):
69
+ """Initializes the ExaChat client."""
70
+ if model not in self.AVAILABLE_MODELS:
71
+ raise ValueError(f"Invalid model: {model}. Choose from: {self.AVAILABLE_MODELS}")
72
+
73
+ self.session = Session() # Use curl_cffi Session
74
+ self.is_conversation = is_conversation
75
+ self.max_tokens_to_sample = max_tokens
76
+ self.timeout = timeout
77
+ self.last_response = {}
78
+ self.model = model
79
+ self.system_prompt = system_prompt
80
+ self.temperature = temperature
81
+ self.presence_penalty = presence_penalty
82
+ self.frequency_penalty = frequency_penalty
83
+ self.top_p = top_p
84
+
85
+ # Initialize LitAgent for user agent generation
86
+ self.agent = LitAgent()
87
+
88
+ self.headers = {
89
+ "accept": "*/*",
90
+ "accept-language": "en-US,en;q=0.9",
91
+ "content-type": "application/json",
92
+ "origin": "https://ayle.chat/",
93
+ "referer": "https://ayle.chat/",
94
+ "user-agent": self.agent.random(),
95
+ }
96
+
97
+ self.session.headers.update(self.headers)
98
+ self.session.proxies = proxies # Assign proxies directly
99
+ self.session.cookies.update({"session": uuid.uuid4().hex})
100
+
101
+ self.__available_optimizers = (
102
+ method for method in dir(Optimizers)
103
+ if callable(getattr(Optimizers, method)) and not method.startswith("__")
104
+ )
105
+
106
+ Conversation.intro = (
107
+ AwesomePrompts().get_act(
108
+ act, raise_not_found=True, default=None, case_insensitive=True
109
+ )
110
+ if act
111
+ else intro or Conversation.intro
112
+ )
113
+
114
+ self.conversation = Conversation(
115
+ is_conversation, self.max_tokens_to_sample, filepath, update_file
116
+ )
117
+ self.conversation.history_offset = history_offset
118
+
119
+ self.provider = self._get_provider_from_model(self.model)
120
+ self.model_name = self.model
121
+
122
+ def _get_endpoint(self) -> str:
123
+ """Get the API endpoint for the current provider."""
124
+ return MODEL_CONFIGS[self.provider]["endpoint"]
125
+
126
+ def _get_provider_from_model(self, model: str) -> str:
127
+ """Determine the provider based on the model name."""
128
+ for provider, config in MODEL_CONFIGS.items():
129
+ if model in config["models"]:
130
+ return provider
131
+
132
+ available_models = []
133
+ for provider, config in MODEL_CONFIGS.items():
134
+ for model_name in config["models"]:
135
+ available_models.append(f"{provider}/{model_name}")
136
+
137
+ error_msg = f"Invalid model: {model}\nAvailable models: {', '.join(available_models)}"
138
+ raise ValueError(error_msg)
139
+
140
+ @staticmethod
141
+ def _exachat_extractor(chunk: Union[str, Dict[str, Any]]) -> Optional[str]:
142
+ """Extracts content from ExaChat stream JSON objects."""
143
+ if isinstance(chunk, dict):
144
+ return chunk.get("choices", [{}])[0].get("delta", {}).get("content")
145
+ return None
146
+
147
+ def _make_request(self, payload: Dict[str, Any]) -> Response: # Change type hint to Response
148
+ """Make the API request with proper error handling."""
149
+ try:
150
+ response = self.session.post(
151
+ self._get_endpoint(),
152
+ headers=self.headers,
153
+ json=payload,
154
+ timeout=self.timeout, # type: ignore
155
+ stream=True, # Enable streaming for the request
156
+ impersonate="chrome120" # Add impersonate
157
+ )
158
+ response.raise_for_status()
159
+ return response
160
+ except (CurlError, exceptions.FailedToGenerateResponseError, Exception) as e: # Catch CurlError and others
161
+ raise exceptions.FailedToGenerateResponseError(f"API request failed: {e}") from e
162
+
163
+ def _build_payload(self, conversation_prompt: str) -> Dict[str, Any]:
164
+ """Build the appropriate payload based on the provider."""
165
+ if self.provider == "exaanswer":
166
+ return {
167
+ "query": conversation_prompt,
168
+ "messages": []
169
+ }
170
+ elif self.provider == "gemini":
171
+ return {
172
+ "query": conversation_prompt,
173
+ "model": self.model,
174
+ "messages": []
175
+ }
176
+ elif self.provider == "cerebras":
177
+ return {
178
+ "query": conversation_prompt,
179
+ "model": self.model,
180
+ "messages": []
181
+ }
182
+ else: # openrouter or groq
183
+ return {
184
+ "query": conversation_prompt + "\n", # Add newline for openrouter and groq models
185
+ "model": self.model,
186
+ "messages": []
187
+ }
188
+
189
+ def ask(
190
+ self,
191
+ prompt: str,
192
+ stream: bool = False,
193
+ raw: bool = False,
194
+ optimizer: str = None,
195
+ conversationally: bool = False,
196
+ ) -> Union[Dict[str, Any], Generator[Any, None, None]]:
197
+ """Sends a prompt to the API and returns the response."""
198
+ conversation_prompt = self.conversation.gen_complete_prompt(prompt)
199
+ if optimizer:
200
+ if optimizer in self.__available_optimizers:
201
+ conversation_prompt = getattr(Optimizers, optimizer)(
202
+ conversation_prompt if conversationally else prompt
203
+ )
204
+ else:
205
+ error_msg = f"Optimizer is not one of {self.__available_optimizers}"
206
+ raise exceptions.FailedToGenerateResponseError(error_msg)
207
+
208
+ payload = self._build_payload(conversation_prompt)
209
+ response = self._make_request(payload)
210
+ processed_stream = sanitize_stream(
211
+ data=response.iter_content(chunk_size=None),
212
+ intro_value=None,
213
+ to_json=True,
214
+ content_extractor=self._exachat_extractor,
215
+ yield_raw_on_error=False,
216
+ raw=raw
217
+ )
218
+ if stream:
219
+ streaming_text = ""
220
+ for content_chunk in processed_stream:
221
+ if content_chunk and isinstance(content_chunk, str):
222
+ content_chunk = content_chunk.replace('\\\\', '\\').replace('\\"', '"')
223
+ if raw:
224
+ if content_chunk and isinstance(content_chunk, str):
225
+ streaming_text += content_chunk
226
+ yield content_chunk
227
+ else:
228
+ if content_chunk and isinstance(content_chunk, str):
229
+ streaming_text += content_chunk
230
+ yield dict(text=content_chunk)
231
+ self.last_response = {"text": streaming_text}
232
+ self.conversation.update_chat_history(prompt, streaming_text)
233
+ else:
234
+ full_response = ""
235
+ for content_chunk in processed_stream:
236
+ if content_chunk and isinstance(content_chunk, str):
237
+ content_chunk = content_chunk.replace('\\\\', '\\').replace('\\"', '"')
238
+ if raw:
239
+ if content_chunk and isinstance(content_chunk, str):
240
+ full_response += content_chunk
241
+ else:
242
+ if content_chunk and isinstance(content_chunk, str):
243
+ full_response += content_chunk
244
+ self.last_response = {"text": full_response}
245
+ self.conversation.update_chat_history(prompt, full_response)
246
+ return self.last_response if not raw else full_response
247
+
248
+ def chat(
249
+ self,
250
+ prompt: str,
251
+ stream: bool = False,
252
+ optimizer: str = None,
253
+ conversationally: bool = False,
254
+ raw: bool = False,
255
+ ) -> Union[str, Generator[str, None, None]]:
256
+ def for_stream():
257
+ for response in self.ask(
258
+ prompt, stream=True, raw=raw, optimizer=optimizer, conversationally=conversationally
259
+ ):
260
+ if raw:
261
+ yield response
262
+ else:
263
+ yield self.get_message(response)
264
+ def for_non_stream():
265
+ result = self.ask(
266
+ prompt, stream=False, raw=raw, optimizer=optimizer, conversationally=conversationally
267
+ )
268
+ if raw:
269
+ return result if isinstance(result, str) else str(result)
270
+ return self.get_message(result)
271
+ return for_stream() if stream else for_non_stream()
272
+
273
+ def get_message(self, response: Union[Dict[str, Any], str]) -> str:
274
+ if isinstance(response, dict):
275
+ text = response.get("text", "")
276
+ else:
277
+ text = str(response)
278
+ return text.replace('\\\\', '\\').replace('\\"', '"')
279
+
280
+ if __name__ == "__main__":
281
+ # print("-" * 80)
282
+ # print(f"{'Model':<50} {'Status':<10} {'Response'}")
283
+ # print("-" * 80)
284
+
285
+ # # Test all available models
286
+ # working = 0
287
+ # total = len(ExaChat.AVAILABLE_MODELS)
288
+
289
+ # for model in ExaChat.AVAILABLE_MODELS:
290
+ # try:
291
+ # test_ai = ExaChat(model=model, timeout=60)
292
+ # response = test_ai.chat("Say 'Hello' in one word")
293
+ # response_text = response
294
+
295
+ # if response_text and len(response_text.strip()) > 0:
296
+ # status = "✓"
297
+ # # Truncate response if too long
298
+ # display_text = response_text.strip()[:50] + "..." if len(response_text.strip()) > 50 else response_text.strip()
299
+ # else:
300
+ # status = "✗"
301
+ # display_text = "Empty or invalid response"
302
+ # print(f"{model:<50} {status:<10} {display_text}")
303
+ # except Exception as e:
304
+ # print(f"{model:<50} {'✗':<10} {str(e)}")
305
+ from rich import print
306
+ ai = ExaChat(model="gemini-2.0-flash")
307
+ response = ai.chat("tell me a joke", stream=True, raw=False)
308
+ for chunk in response:
309
309
  print(chunk, end='', flush=True)