webscout 8.2.9__py3-none-any.whl → 2026.1.19__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.
Files changed (413) hide show
  1. webscout/AIauto.py +524 -251
  2. webscout/AIbase.py +247 -319
  3. webscout/AIutel.py +68 -703
  4. webscout/Bard.py +1072 -1026
  5. webscout/Extra/GitToolkit/__init__.py +10 -10
  6. webscout/Extra/GitToolkit/gitapi/__init__.py +20 -12
  7. webscout/Extra/GitToolkit/gitapi/gist.py +142 -0
  8. webscout/Extra/GitToolkit/gitapi/organization.py +91 -0
  9. webscout/Extra/GitToolkit/gitapi/repository.py +308 -195
  10. webscout/Extra/GitToolkit/gitapi/search.py +162 -0
  11. webscout/Extra/GitToolkit/gitapi/trending.py +236 -0
  12. webscout/Extra/GitToolkit/gitapi/user.py +128 -96
  13. webscout/Extra/GitToolkit/gitapi/utils.py +82 -62
  14. webscout/Extra/YTToolkit/README.md +443 -375
  15. webscout/Extra/YTToolkit/YTdownloader.py +953 -957
  16. webscout/Extra/YTToolkit/__init__.py +3 -3
  17. webscout/Extra/YTToolkit/transcriber.py +595 -476
  18. webscout/Extra/YTToolkit/ytapi/README.md +230 -44
  19. webscout/Extra/YTToolkit/ytapi/__init__.py +22 -6
  20. webscout/Extra/YTToolkit/ytapi/captions.py +190 -0
  21. webscout/Extra/YTToolkit/ytapi/channel.py +302 -307
  22. webscout/Extra/YTToolkit/ytapi/errors.py +13 -13
  23. webscout/Extra/YTToolkit/ytapi/extras.py +178 -118
  24. webscout/Extra/YTToolkit/ytapi/hashtag.py +120 -0
  25. webscout/Extra/YTToolkit/ytapi/https.py +89 -88
  26. webscout/Extra/YTToolkit/ytapi/patterns.py +61 -61
  27. webscout/Extra/YTToolkit/ytapi/playlist.py +59 -59
  28. webscout/Extra/YTToolkit/ytapi/pool.py +8 -8
  29. webscout/Extra/YTToolkit/ytapi/query.py +143 -40
  30. webscout/Extra/YTToolkit/ytapi/shorts.py +122 -0
  31. webscout/Extra/YTToolkit/ytapi/stream.py +68 -63
  32. webscout/Extra/YTToolkit/ytapi/suggestions.py +97 -0
  33. webscout/Extra/YTToolkit/ytapi/utils.py +66 -62
  34. webscout/Extra/YTToolkit/ytapi/video.py +403 -232
  35. webscout/Extra/__init__.py +2 -3
  36. webscout/Extra/gguf.py +1298 -684
  37. webscout/Extra/tempmail/README.md +487 -487
  38. webscout/Extra/tempmail/__init__.py +28 -28
  39. webscout/Extra/tempmail/async_utils.py +143 -141
  40. webscout/Extra/tempmail/base.py +172 -161
  41. webscout/Extra/tempmail/cli.py +191 -187
  42. webscout/Extra/tempmail/emailnator.py +88 -84
  43. webscout/Extra/tempmail/mail_tm.py +378 -361
  44. webscout/Extra/tempmail/temp_mail_io.py +304 -292
  45. webscout/Extra/weather.py +196 -194
  46. webscout/Extra/weather_ascii.py +17 -15
  47. webscout/Provider/AISEARCH/PERPLEXED_search.py +175 -0
  48. webscout/Provider/AISEARCH/Perplexity.py +292 -333
  49. webscout/Provider/AISEARCH/README.md +106 -279
  50. webscout/Provider/AISEARCH/__init__.py +16 -9
  51. webscout/Provider/AISEARCH/brave_search.py +298 -0
  52. webscout/Provider/AISEARCH/iask_search.py +357 -410
  53. webscout/Provider/AISEARCH/monica_search.py +200 -220
  54. webscout/Provider/AISEARCH/webpilotai_search.py +242 -255
  55. webscout/Provider/Algion.py +413 -0
  56. webscout/Provider/Andi.py +74 -69
  57. webscout/Provider/Apriel.py +313 -0
  58. webscout/Provider/Ayle.py +323 -0
  59. webscout/Provider/ChatSandbox.py +329 -342
  60. webscout/Provider/ClaudeOnline.py +365 -0
  61. webscout/Provider/Cohere.py +232 -208
  62. webscout/Provider/DeepAI.py +367 -0
  63. webscout/Provider/Deepinfra.py +467 -340
  64. webscout/Provider/EssentialAI.py +217 -0
  65. webscout/Provider/ExaAI.py +274 -261
  66. webscout/Provider/Gemini.py +175 -169
  67. webscout/Provider/GithubChat.py +385 -369
  68. webscout/Provider/Gradient.py +286 -0
  69. webscout/Provider/Groq.py +556 -801
  70. webscout/Provider/HadadXYZ.py +323 -0
  71. webscout/Provider/HeckAI.py +392 -375
  72. webscout/Provider/HuggingFace.py +387 -0
  73. webscout/Provider/IBM.py +340 -0
  74. webscout/Provider/Jadve.py +317 -291
  75. webscout/Provider/K2Think.py +306 -0
  76. webscout/Provider/Koboldai.py +221 -384
  77. webscout/Provider/Netwrck.py +273 -270
  78. webscout/Provider/Nvidia.py +310 -0
  79. webscout/Provider/OPENAI/DeepAI.py +489 -0
  80. webscout/Provider/OPENAI/K2Think.py +423 -0
  81. webscout/Provider/OPENAI/PI.py +463 -0
  82. webscout/Provider/OPENAI/README.md +890 -952
  83. webscout/Provider/OPENAI/TogetherAI.py +405 -0
  84. webscout/Provider/OPENAI/TwoAI.py +255 -357
  85. webscout/Provider/OPENAI/__init__.py +148 -40
  86. webscout/Provider/OPENAI/ai4chat.py +348 -293
  87. webscout/Provider/OPENAI/akashgpt.py +436 -0
  88. webscout/Provider/OPENAI/algion.py +303 -0
  89. webscout/Provider/OPENAI/{exachat.py → ayle.py} +365 -444
  90. webscout/Provider/OPENAI/base.py +253 -249
  91. webscout/Provider/OPENAI/cerebras.py +296 -0
  92. webscout/Provider/OPENAI/chatgpt.py +870 -556
  93. webscout/Provider/OPENAI/chatsandbox.py +233 -173
  94. webscout/Provider/OPENAI/deepinfra.py +403 -322
  95. webscout/Provider/OPENAI/e2b.py +2370 -1414
  96. webscout/Provider/OPENAI/elmo.py +278 -0
  97. webscout/Provider/OPENAI/exaai.py +452 -417
  98. webscout/Provider/OPENAI/freeassist.py +446 -0
  99. webscout/Provider/OPENAI/gradient.py +448 -0
  100. webscout/Provider/OPENAI/groq.py +380 -364
  101. webscout/Provider/OPENAI/hadadxyz.py +292 -0
  102. webscout/Provider/OPENAI/heckai.py +333 -308
  103. webscout/Provider/OPENAI/huggingface.py +321 -0
  104. webscout/Provider/OPENAI/ibm.py +425 -0
  105. webscout/Provider/OPENAI/llmchat.py +253 -0
  106. webscout/Provider/OPENAI/llmchatco.py +378 -335
  107. webscout/Provider/OPENAI/meta.py +541 -0
  108. webscout/Provider/OPENAI/netwrck.py +374 -357
  109. webscout/Provider/OPENAI/nvidia.py +317 -0
  110. webscout/Provider/OPENAI/oivscode.py +348 -287
  111. webscout/Provider/OPENAI/openrouter.py +328 -0
  112. webscout/Provider/OPENAI/pydantic_imports.py +1 -172
  113. webscout/Provider/OPENAI/sambanova.py +397 -0
  114. webscout/Provider/OPENAI/sonus.py +305 -304
  115. webscout/Provider/OPENAI/textpollinations.py +370 -339
  116. webscout/Provider/OPENAI/toolbaz.py +375 -413
  117. webscout/Provider/OPENAI/typefully.py +419 -355
  118. webscout/Provider/OPENAI/typliai.py +279 -0
  119. webscout/Provider/OPENAI/utils.py +314 -318
  120. webscout/Provider/OPENAI/wisecat.py +359 -387
  121. webscout/Provider/OPENAI/writecream.py +185 -163
  122. webscout/Provider/OPENAI/x0gpt.py +462 -365
  123. webscout/Provider/OPENAI/zenmux.py +380 -0
  124. webscout/Provider/OpenRouter.py +386 -0
  125. webscout/Provider/Openai.py +337 -496
  126. webscout/Provider/PI.py +443 -429
  127. webscout/Provider/QwenLM.py +346 -254
  128. webscout/Provider/STT/__init__.py +28 -0
  129. webscout/Provider/STT/base.py +303 -0
  130. webscout/Provider/STT/elevenlabs.py +264 -0
  131. webscout/Provider/Sambanova.py +317 -0
  132. webscout/Provider/TTI/README.md +69 -82
  133. webscout/Provider/TTI/__init__.py +37 -7
  134. webscout/Provider/TTI/base.py +147 -64
  135. webscout/Provider/TTI/claudeonline.py +393 -0
  136. webscout/Provider/TTI/magicstudio.py +292 -201
  137. webscout/Provider/TTI/miragic.py +180 -0
  138. webscout/Provider/TTI/pollinations.py +331 -221
  139. webscout/Provider/TTI/together.py +334 -0
  140. webscout/Provider/TTI/utils.py +14 -11
  141. webscout/Provider/TTS/README.md +186 -192
  142. webscout/Provider/TTS/__init__.py +43 -10
  143. webscout/Provider/TTS/base.py +523 -159
  144. webscout/Provider/TTS/deepgram.py +286 -156
  145. webscout/Provider/TTS/elevenlabs.py +189 -111
  146. webscout/Provider/TTS/freetts.py +218 -0
  147. webscout/Provider/TTS/murfai.py +288 -113
  148. webscout/Provider/TTS/openai_fm.py +364 -129
  149. webscout/Provider/TTS/parler.py +203 -111
  150. webscout/Provider/TTS/qwen.py +334 -0
  151. webscout/Provider/TTS/sherpa.py +286 -0
  152. webscout/Provider/TTS/speechma.py +693 -580
  153. webscout/Provider/TTS/streamElements.py +275 -333
  154. webscout/Provider/TTS/utils.py +280 -280
  155. webscout/Provider/TextPollinationsAI.py +331 -308
  156. webscout/Provider/TogetherAI.py +450 -0
  157. webscout/Provider/TwoAI.py +309 -475
  158. webscout/Provider/TypliAI.py +311 -305
  159. webscout/Provider/UNFINISHED/ChatHub.py +219 -209
  160. webscout/Provider/{OPENAI/glider.py → UNFINISHED/ChutesAI.py} +331 -326
  161. webscout/Provider/{GizAI.py → UNFINISHED/GizAI.py} +300 -295
  162. webscout/Provider/{Marcus.py → UNFINISHED/Marcus.py} +218 -198
  163. webscout/Provider/UNFINISHED/Qodo.py +481 -0
  164. webscout/Provider/{MCPCore.py → UNFINISHED/XenAI.py} +330 -315
  165. webscout/Provider/UNFINISHED/Youchat.py +347 -330
  166. webscout/Provider/UNFINISHED/aihumanizer.py +41 -0
  167. webscout/Provider/UNFINISHED/grammerchecker.py +37 -0
  168. webscout/Provider/UNFINISHED/liner.py +342 -0
  169. webscout/Provider/UNFINISHED/liner_api_request.py +246 -263
  170. webscout/Provider/{samurai.py → UNFINISHED/samurai.py} +231 -224
  171. webscout/Provider/WiseCat.py +256 -233
  172. webscout/Provider/WrDoChat.py +390 -370
  173. webscout/Provider/__init__.py +115 -174
  174. webscout/Provider/ai4chat.py +181 -174
  175. webscout/Provider/akashgpt.py +330 -335
  176. webscout/Provider/cerebras.py +397 -290
  177. webscout/Provider/cleeai.py +236 -213
  178. webscout/Provider/elmo.py +291 -283
  179. webscout/Provider/geminiapi.py +343 -208
  180. webscout/Provider/julius.py +245 -223
  181. webscout/Provider/learnfastai.py +333 -325
  182. webscout/Provider/llama3mitril.py +230 -215
  183. webscout/Provider/llmchat.py +308 -258
  184. webscout/Provider/llmchatco.py +321 -306
  185. webscout/Provider/meta.py +996 -801
  186. webscout/Provider/oivscode.py +332 -309
  187. webscout/Provider/searchchat.py +316 -292
  188. webscout/Provider/sonus.py +264 -258
  189. webscout/Provider/toolbaz.py +359 -353
  190. webscout/Provider/turboseek.py +332 -266
  191. webscout/Provider/typefully.py +262 -202
  192. webscout/Provider/x0gpt.py +332 -299
  193. webscout/__init__.py +31 -39
  194. webscout/__main__.py +5 -5
  195. webscout/cli.py +585 -524
  196. webscout/client.py +1497 -70
  197. webscout/conversation.py +140 -436
  198. webscout/exceptions.py +383 -362
  199. webscout/litagent/__init__.py +29 -29
  200. webscout/litagent/agent.py +492 -455
  201. webscout/litagent/constants.py +60 -60
  202. webscout/models.py +505 -181
  203. webscout/optimizers.py +74 -420
  204. webscout/prompt_manager.py +376 -288
  205. webscout/sanitize.py +1514 -0
  206. webscout/scout/README.md +452 -404
  207. webscout/scout/__init__.py +8 -8
  208. webscout/scout/core/__init__.py +7 -7
  209. webscout/scout/core/crawler.py +330 -210
  210. webscout/scout/core/scout.py +800 -607
  211. webscout/scout/core/search_result.py +51 -96
  212. webscout/scout/core/text_analyzer.py +64 -63
  213. webscout/scout/core/text_utils.py +412 -277
  214. webscout/scout/core/web_analyzer.py +54 -52
  215. webscout/scout/element.py +872 -478
  216. webscout/scout/parsers/__init__.py +70 -69
  217. webscout/scout/parsers/html5lib_parser.py +182 -172
  218. webscout/scout/parsers/html_parser.py +238 -236
  219. webscout/scout/parsers/lxml_parser.py +203 -178
  220. webscout/scout/utils.py +38 -37
  221. webscout/search/__init__.py +47 -0
  222. webscout/search/base.py +201 -0
  223. webscout/search/bing_main.py +45 -0
  224. webscout/search/brave_main.py +92 -0
  225. webscout/search/duckduckgo_main.py +57 -0
  226. webscout/search/engines/__init__.py +127 -0
  227. webscout/search/engines/bing/__init__.py +15 -0
  228. webscout/search/engines/bing/base.py +35 -0
  229. webscout/search/engines/bing/images.py +114 -0
  230. webscout/search/engines/bing/news.py +96 -0
  231. webscout/search/engines/bing/suggestions.py +36 -0
  232. webscout/search/engines/bing/text.py +109 -0
  233. webscout/search/engines/brave/__init__.py +19 -0
  234. webscout/search/engines/brave/base.py +47 -0
  235. webscout/search/engines/brave/images.py +213 -0
  236. webscout/search/engines/brave/news.py +353 -0
  237. webscout/search/engines/brave/suggestions.py +318 -0
  238. webscout/search/engines/brave/text.py +167 -0
  239. webscout/search/engines/brave/videos.py +364 -0
  240. webscout/search/engines/duckduckgo/__init__.py +25 -0
  241. webscout/search/engines/duckduckgo/answers.py +80 -0
  242. webscout/search/engines/duckduckgo/base.py +189 -0
  243. webscout/search/engines/duckduckgo/images.py +100 -0
  244. webscout/search/engines/duckduckgo/maps.py +183 -0
  245. webscout/search/engines/duckduckgo/news.py +70 -0
  246. webscout/search/engines/duckduckgo/suggestions.py +22 -0
  247. webscout/search/engines/duckduckgo/text.py +221 -0
  248. webscout/search/engines/duckduckgo/translate.py +48 -0
  249. webscout/search/engines/duckduckgo/videos.py +80 -0
  250. webscout/search/engines/duckduckgo/weather.py +84 -0
  251. webscout/search/engines/mojeek.py +61 -0
  252. webscout/search/engines/wikipedia.py +77 -0
  253. webscout/search/engines/yahoo/__init__.py +41 -0
  254. webscout/search/engines/yahoo/answers.py +19 -0
  255. webscout/search/engines/yahoo/base.py +34 -0
  256. webscout/search/engines/yahoo/images.py +323 -0
  257. webscout/search/engines/yahoo/maps.py +19 -0
  258. webscout/search/engines/yahoo/news.py +258 -0
  259. webscout/search/engines/yahoo/suggestions.py +140 -0
  260. webscout/search/engines/yahoo/text.py +273 -0
  261. webscout/search/engines/yahoo/translate.py +19 -0
  262. webscout/search/engines/yahoo/videos.py +302 -0
  263. webscout/search/engines/yahoo/weather.py +220 -0
  264. webscout/search/engines/yandex.py +67 -0
  265. webscout/search/engines/yep/__init__.py +13 -0
  266. webscout/search/engines/yep/base.py +34 -0
  267. webscout/search/engines/yep/images.py +101 -0
  268. webscout/search/engines/yep/suggestions.py +38 -0
  269. webscout/search/engines/yep/text.py +99 -0
  270. webscout/search/http_client.py +172 -0
  271. webscout/search/results.py +141 -0
  272. webscout/search/yahoo_main.py +57 -0
  273. webscout/search/yep_main.py +48 -0
  274. webscout/server/__init__.py +48 -0
  275. webscout/server/config.py +78 -0
  276. webscout/server/exceptions.py +69 -0
  277. webscout/server/providers.py +286 -0
  278. webscout/server/request_models.py +131 -0
  279. webscout/server/request_processing.py +404 -0
  280. webscout/server/routes.py +642 -0
  281. webscout/server/server.py +351 -0
  282. webscout/server/ui_templates.py +1171 -0
  283. webscout/swiftcli/__init__.py +79 -95
  284. webscout/swiftcli/core/__init__.py +7 -7
  285. webscout/swiftcli/core/cli.py +574 -297
  286. webscout/swiftcli/core/context.py +98 -104
  287. webscout/swiftcli/core/group.py +268 -241
  288. webscout/swiftcli/decorators/__init__.py +28 -28
  289. webscout/swiftcli/decorators/command.py +243 -221
  290. webscout/swiftcli/decorators/options.py +247 -220
  291. webscout/swiftcli/decorators/output.py +392 -252
  292. webscout/swiftcli/exceptions.py +21 -21
  293. webscout/swiftcli/plugins/__init__.py +9 -9
  294. webscout/swiftcli/plugins/base.py +134 -135
  295. webscout/swiftcli/plugins/manager.py +269 -269
  296. webscout/swiftcli/utils/__init__.py +58 -59
  297. webscout/swiftcli/utils/formatting.py +251 -252
  298. webscout/swiftcli/utils/parsing.py +368 -267
  299. webscout/update_checker.py +280 -136
  300. webscout/utils.py +28 -14
  301. webscout/version.py +2 -1
  302. webscout/version.py.bak +3 -0
  303. webscout/zeroart/__init__.py +218 -135
  304. webscout/zeroart/base.py +70 -66
  305. webscout/zeroart/effects.py +155 -101
  306. webscout/zeroart/fonts.py +1799 -1239
  307. webscout-2026.1.19.dist-info/METADATA +638 -0
  308. webscout-2026.1.19.dist-info/RECORD +312 -0
  309. {webscout-8.2.9.dist-info → webscout-2026.1.19.dist-info}/WHEEL +1 -1
  310. {webscout-8.2.9.dist-info → webscout-2026.1.19.dist-info}/entry_points.txt +1 -1
  311. webscout/DWEBS.py +0 -520
  312. webscout/Extra/Act.md +0 -309
  313. webscout/Extra/GitToolkit/gitapi/README.md +0 -110
  314. webscout/Extra/autocoder/__init__.py +0 -9
  315. webscout/Extra/autocoder/autocoder.py +0 -1105
  316. webscout/Extra/autocoder/autocoder_utiles.py +0 -332
  317. webscout/Extra/gguf.md +0 -430
  318. webscout/Extra/weather.md +0 -281
  319. webscout/Litlogger/README.md +0 -10
  320. webscout/Litlogger/__init__.py +0 -15
  321. webscout/Litlogger/formats.py +0 -4
  322. webscout/Litlogger/handlers.py +0 -103
  323. webscout/Litlogger/levels.py +0 -13
  324. webscout/Litlogger/logger.py +0 -92
  325. webscout/Provider/AI21.py +0 -177
  326. webscout/Provider/AISEARCH/DeepFind.py +0 -254
  327. webscout/Provider/AISEARCH/felo_search.py +0 -202
  328. webscout/Provider/AISEARCH/genspark_search.py +0 -324
  329. webscout/Provider/AISEARCH/hika_search.py +0 -186
  330. webscout/Provider/AISEARCH/scira_search.py +0 -298
  331. webscout/Provider/Aitopia.py +0 -316
  332. webscout/Provider/AllenAI.py +0 -440
  333. webscout/Provider/Blackboxai.py +0 -791
  334. webscout/Provider/ChatGPTClone.py +0 -237
  335. webscout/Provider/ChatGPTGratis.py +0 -194
  336. webscout/Provider/Cloudflare.py +0 -324
  337. webscout/Provider/ExaChat.py +0 -358
  338. webscout/Provider/Flowith.py +0 -217
  339. webscout/Provider/FreeGemini.py +0 -250
  340. webscout/Provider/Glider.py +0 -225
  341. webscout/Provider/HF_space/__init__.py +0 -0
  342. webscout/Provider/HF_space/qwen_qwen2.py +0 -206
  343. webscout/Provider/HuggingFaceChat.py +0 -469
  344. webscout/Provider/Hunyuan.py +0 -283
  345. webscout/Provider/LambdaChat.py +0 -411
  346. webscout/Provider/Llama3.py +0 -259
  347. webscout/Provider/Nemotron.py +0 -218
  348. webscout/Provider/OLLAMA.py +0 -396
  349. webscout/Provider/OPENAI/BLACKBOXAI.py +0 -766
  350. webscout/Provider/OPENAI/Cloudflare.py +0 -378
  351. webscout/Provider/OPENAI/FreeGemini.py +0 -283
  352. webscout/Provider/OPENAI/NEMOTRON.py +0 -232
  353. webscout/Provider/OPENAI/Qwen3.py +0 -283
  354. webscout/Provider/OPENAI/api.py +0 -969
  355. webscout/Provider/OPENAI/c4ai.py +0 -373
  356. webscout/Provider/OPENAI/chatgptclone.py +0 -494
  357. webscout/Provider/OPENAI/copilot.py +0 -242
  358. webscout/Provider/OPENAI/flowith.py +0 -162
  359. webscout/Provider/OPENAI/freeaichat.py +0 -359
  360. webscout/Provider/OPENAI/mcpcore.py +0 -389
  361. webscout/Provider/OPENAI/multichat.py +0 -376
  362. webscout/Provider/OPENAI/opkfc.py +0 -496
  363. webscout/Provider/OPENAI/scirachat.py +0 -477
  364. webscout/Provider/OPENAI/standardinput.py +0 -433
  365. webscout/Provider/OPENAI/typegpt.py +0 -364
  366. webscout/Provider/OPENAI/uncovrAI.py +0 -463
  367. webscout/Provider/OPENAI/venice.py +0 -431
  368. webscout/Provider/OPENAI/yep.py +0 -382
  369. webscout/Provider/OpenGPT.py +0 -209
  370. webscout/Provider/Perplexitylabs.py +0 -415
  371. webscout/Provider/Reka.py +0 -214
  372. webscout/Provider/StandardInput.py +0 -290
  373. webscout/Provider/TTI/aiarta.py +0 -365
  374. webscout/Provider/TTI/artbit.py +0 -0
  375. webscout/Provider/TTI/fastflux.py +0 -200
  376. webscout/Provider/TTI/piclumen.py +0 -203
  377. webscout/Provider/TTI/pixelmuse.py +0 -225
  378. webscout/Provider/TTS/gesserit.py +0 -128
  379. webscout/Provider/TTS/sthir.py +0 -94
  380. webscout/Provider/TeachAnything.py +0 -229
  381. webscout/Provider/UNFINISHED/puterjs.py +0 -635
  382. webscout/Provider/UNFINISHED/test_lmarena.py +0 -119
  383. webscout/Provider/Venice.py +0 -258
  384. webscout/Provider/VercelAI.py +0 -253
  385. webscout/Provider/Writecream.py +0 -246
  386. webscout/Provider/WritingMate.py +0 -269
  387. webscout/Provider/asksteve.py +0 -220
  388. webscout/Provider/chatglm.py +0 -215
  389. webscout/Provider/copilot.py +0 -425
  390. webscout/Provider/freeaichat.py +0 -285
  391. webscout/Provider/granite.py +0 -235
  392. webscout/Provider/hermes.py +0 -266
  393. webscout/Provider/koala.py +0 -170
  394. webscout/Provider/lmarena.py +0 -198
  395. webscout/Provider/multichat.py +0 -364
  396. webscout/Provider/scira_chat.py +0 -299
  397. webscout/Provider/scnet.py +0 -243
  398. webscout/Provider/talkai.py +0 -194
  399. webscout/Provider/typegpt.py +0 -289
  400. webscout/Provider/uncovr.py +0 -368
  401. webscout/Provider/yep.py +0 -389
  402. webscout/litagent/Readme.md +0 -276
  403. webscout/litprinter/__init__.py +0 -59
  404. webscout/swiftcli/Readme.md +0 -323
  405. webscout/tempid.py +0 -128
  406. webscout/webscout_search.py +0 -1184
  407. webscout/webscout_search_async.py +0 -654
  408. webscout/yep_search.py +0 -347
  409. webscout/zeroart/README.md +0 -89
  410. webscout-8.2.9.dist-info/METADATA +0 -1033
  411. webscout-8.2.9.dist-info/RECORD +0 -289
  412. {webscout-8.2.9.dist-info → webscout-2026.1.19.dist-info}/licenses/LICENSE.md +0 -0
  413. {webscout-8.2.9.dist-info → webscout-2026.1.19.dist-info}/top_level.txt +0 -0
@@ -1,382 +0,0 @@
1
- import time
2
- import uuid
3
- import cloudscraper # Import cloudscraper
4
- import json
5
- from typing import List, Dict, Optional, Union, Generator, Any
6
-
7
- # Import base classes and utility structures
8
- from .base import OpenAICompatibleProvider, BaseChat, BaseCompletions
9
- from .utils import (
10
- ChatCompletionChunk, ChatCompletion, Choice, ChoiceDelta,
11
- ChatCompletionMessage, CompletionUsage, get_system_prompt, count_tokens # Import count_tokens
12
- )
13
-
14
- # Attempt to import LitAgent, fallback if not available
15
- try:
16
- from webscout.litagent import LitAgent
17
- except ImportError:
18
- # Define a dummy LitAgent if webscout is not installed or accessible
19
- class LitAgent:
20
- def generate_fingerprint(self, browser: str = "chrome") -> Dict[str, Any]:
21
- print("Warning: LitAgent not found. Using default minimal headers.")
22
- return {
23
- "accept": "*/*",
24
- "accept_language": "en-US,en;q=0.9",
25
- "platform": "Windows",
26
- "sec_ch_ua": '"Not/A)Brand";v="99", "Google Chrome";v="127", "Chromium";v="127"',
27
- "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",
28
- "browser_type": browser,
29
- }
30
-
31
- # --- YEPCHAT Client ---
32
-
33
- # ANSI escape codes for formatting
34
- BOLD = "\033[1m"
35
- RED = "\033[91m"
36
- RESET = "\033[0m"
37
-
38
- class Completions(BaseCompletions):
39
- def __init__(self, client: 'YEPCHAT'):
40
- self._client = client
41
-
42
- def create(
43
- self,
44
- *,
45
- model: str,
46
- messages: List[Dict[str, str]],
47
- max_tokens: Optional[int] = 1280,
48
- stream: bool = False,
49
- temperature: Optional[float] = 0.6,
50
- top_p: Optional[float] = 0.7,
51
- system_prompt: Optional[str] = None, # Added for consistency, but will be ignored
52
- **kwargs: Any
53
- ) -> Union[ChatCompletion, Generator[ChatCompletionChunk, None, None]]:
54
- """
55
- Creates a model response for the given chat conversation using YEPCHAT API.
56
- Mimics openai.chat.completions.create
57
- Note: YEPCHAT does not support system messages. They will be ignored.
58
- """
59
- # Only accept and use the raw model name (no prefix logic)
60
- model_raw = model
61
- # Validate model
62
- if model_raw not in self._client.AVAILABLE_MODELS:
63
- raise ValueError(
64
- f"Invalid model: {model}. Choose from: {self._client.AVAILABLE_MODELS}"
65
- )
66
-
67
- # Filter out system messages and warn the user if any are present
68
- filtered_messages = []
69
- has_system_message = False
70
- if get_system_prompt(messages) or system_prompt: # Check both message list and explicit param
71
- has_system_message = True
72
-
73
- for msg in messages:
74
- if msg["role"] == "system":
75
- continue # Skip system messages
76
- filtered_messages.append(msg)
77
-
78
- if has_system_message:
79
- # Print warning in bold red
80
- print(f"{BOLD}{RED}Warning: YEPCHAT does not support system messages, they will be ignored.{RESET}")
81
-
82
- # If no messages left after filtering, raise an error
83
- if not filtered_messages:
84
- raise ValueError("At least one user or assistant message is required for YEPCHAT.")
85
-
86
- payload = {
87
- "stream": stream,
88
- "max_tokens": max_tokens,
89
- "top_p": top_p,
90
- "temperature": temperature,
91
- "messages": filtered_messages, # Use filtered messages
92
- "model": model_raw, # Send only the raw model name to the API
93
- }
94
-
95
- # Add any extra kwargs to the payload
96
- payload.update(kwargs)
97
-
98
- request_id = f"chatcmpl-{uuid.uuid4()}"
99
- created_time = int(time.time())
100
-
101
- if stream:
102
- return self._create_stream(request_id, created_time, model, payload)
103
- else:
104
- return self._create_non_stream(request_id, created_time, model, payload)
105
-
106
- def _create_stream(
107
- self, request_id: str, created_time: int, model: str, payload: Dict[str, Any]
108
- ) -> Generator[ChatCompletionChunk, None, None]:
109
- try:
110
- response = self._client.session.post(
111
- self._client.api_endpoint,
112
- headers=self._client.headers,
113
- cookies=self._client.cookies,
114
- json=payload,
115
- stream=True,
116
- timeout=self._client.timeout
117
- )
118
-
119
- if not response.ok:
120
- raise IOError(
121
- f"YEPCHAT API Error: {response.status_code} {response.reason} - {response.text}"
122
- )
123
-
124
- # Track tokens for streaming
125
- prompt_tokens = count_tokens([m.get('content', '') for m in payload.get('messages', [])])
126
- completion_tokens = 0
127
- total_tokens = prompt_tokens
128
-
129
- for line in response.iter_lines(decode_unicode=True):
130
- if line:
131
- line = line.strip()
132
- if line.startswith("data: "):
133
- json_str = line[6:]
134
- if json_str == "[DONE]":
135
- break
136
- try:
137
- data = json.loads(json_str)
138
- choice_data = data.get('choices', [{}])[0]
139
- delta_data = choice_data.get('delta', {})
140
- finish_reason = choice_data.get('finish_reason')
141
- content = delta_data.get('content')
142
- role = delta_data.get('role', None)
143
-
144
- # Count tokens for this chunk
145
- chunk_tokens = count_tokens(content) if content else 0
146
- completion_tokens += chunk_tokens
147
- total_tokens = prompt_tokens + completion_tokens
148
-
149
- if content is not None or role is not None:
150
- delta = ChoiceDelta(content=content, role=role)
151
- choice = Choice(index=0, delta=delta, finish_reason=finish_reason)
152
- chunk = ChatCompletionChunk(
153
- id=request_id,
154
- choices=[choice],
155
- created=created_time,
156
- model=model,
157
- )
158
- # Set usage directly on the chunk object
159
- chunk.usage = {
160
- "prompt_tokens": prompt_tokens,
161
- "completion_tokens": completion_tokens,
162
- "total_tokens": total_tokens,
163
- "estimated_cost": None
164
- }
165
- # Yield the chunk with usage information
166
- yield chunk
167
-
168
- except json.JSONDecodeError:
169
- print(f"Warning: Could not decode JSON line: {json_str}")
170
- continue
171
-
172
- # Yield final chunk with finish reason if not already sent
173
- delta = ChoiceDelta()
174
- choice = Choice(index=0, delta=delta, finish_reason="stop")
175
- chunk = ChatCompletionChunk(
176
- id=request_id,
177
- choices=[choice],
178
- created=created_time,
179
- model=model,
180
- )
181
- # Set usage directly on the chunk object
182
- chunk.usage = {
183
- "prompt_tokens": prompt_tokens,
184
- "completion_tokens": completion_tokens,
185
- "total_tokens": total_tokens,
186
- "estimated_cost": None
187
- }
188
- yield chunk
189
-
190
- except cloudscraper.exceptions.CloudflareChallengeError as e:
191
- pass
192
-
193
- def _create_non_stream(
194
- self, request_id: str, created_time: int, model: str, payload: Dict[str, Any]
195
- ) -> ChatCompletion:
196
- full_response_content = ""
197
- finish_reason = "stop"
198
- try:
199
- # Make a non-streaming request to the API
200
- payload_copy = payload.copy()
201
- payload_copy["stream"] = False
202
- response = self._client.session.post(
203
- self._client.api_endpoint,
204
- headers=self._client.headers,
205
- cookies=self._client.cookies,
206
- json=payload_copy,
207
- timeout=self._client.timeout
208
- )
209
- if not response.ok:
210
- raise IOError(
211
- f"YEPCHAT API Error: {response.status_code} {response.reason} - {response.text}"
212
- )
213
- data = response.json()
214
- if 'choices' in data and len(data['choices']) > 0:
215
- # YEPCHAT non-streaming returns message content in choices[0]['message']['content']
216
- full_response_content = data['choices'][0].get('message', {}).get('content', '')
217
- finish_reason = data['choices'][0].get('finish_reason', 'stop')
218
- else:
219
- full_response_content = ''
220
- finish_reason = 'stop'
221
- except Exception as e:
222
- print(f"Error obtaining non-stream response from YEPCHAT: {e}")
223
- finish_reason = "error"
224
-
225
- message = ChatCompletionMessage(
226
- role="assistant",
227
- content=full_response_content
228
- )
229
- choice = Choice(
230
- index=0,
231
- message=message,
232
- finish_reason=finish_reason
233
- )
234
- # Use count_tokens to compute usage
235
- prompt_tokens = count_tokens([m.get('content', '') for m in payload.get('messages', [])])
236
- completion_tokens = count_tokens(full_response_content)
237
- usage = CompletionUsage(
238
- prompt_tokens=prompt_tokens,
239
- completion_tokens=completion_tokens,
240
- total_tokens=prompt_tokens + completion_tokens
241
- )
242
- completion = ChatCompletion(
243
- id=request_id,
244
- choices=[choice],
245
- created=created_time,
246
- model=model,
247
- usage=usage,
248
- )
249
- return completion
250
-
251
- class Chat(BaseChat):
252
- def __init__(self, client: 'YEPCHAT'):
253
- self.completions = Completions(client)
254
-
255
- class YEPCHAT(OpenAICompatibleProvider):
256
- """
257
- OpenAI-compatible client for YEPCHAT API.
258
-
259
- Usage:
260
- client = YEPCHAT()
261
- response = client.chat.completions.create(
262
- model="DeepSeek-R1-Distill-Qwen-32B",
263
- messages=[{"role": "user", "content": "Hello!"}]
264
- )
265
- print(response.choices[0].message.content)
266
- """
267
- _base_models = ["DeepSeek-R1-Distill-Qwen-32B", "Mixtral-8x7B-Instruct-v0.1"]
268
-
269
- # Create AVAILABLE_MODELS as a list of base model names (no prefix)
270
- AVAILABLE_MODELS = _base_models
271
-
272
- def __init__(
273
- self,
274
- timeout: int = 30,
275
- browser: str = "chrome"
276
- ):
277
- """
278
- Initialize the YEPCHAT client.
279
-
280
- Args:
281
- timeout: Request timeout in seconds.
282
- browser: Browser name for LitAgent to generate User-Agent.
283
- """
284
- self.timeout = timeout
285
- self.api_endpoint = "https://api.yep.com/v1/chat/completions"
286
- self.session = cloudscraper.create_scraper() # Use cloudscraper
287
-
288
- # Initialize LitAgent for user agent generation and fingerprinting
289
- try:
290
- agent = LitAgent()
291
- fingerprint = agent.generate_fingerprint(browser=browser)
292
- except Exception as e:
293
- print(f"Warning: Failed to generate fingerprint with LitAgent: {e}. Using fallback.")
294
- # Fallback fingerprint data
295
- fingerprint = {
296
- "accept": "*/*",
297
- "accept_language": "en-US,en;q=0.9",
298
- "sec_ch_ua": '"Not/A)Brand";v="99", "Google Chrome";v="127", "Chromium";v="127"',
299
- "platform": "Windows",
300
- "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"
301
- }
302
-
303
- # Initialize headers using the fingerprint
304
- self.headers = {
305
- "Accept": fingerprint["accept"],
306
- "Accept-Encoding": "gzip, deflate, br, zstd",
307
- "Accept-Language": fingerprint["accept_language"],
308
- "Content-Type": "application/json; charset=utf-8",
309
- "DNT": "1",
310
- "Origin": "https://yep.com",
311
- "Referer": "https://yep.com/",
312
- "Sec-CH-UA": fingerprint["sec_ch_ua"] or '"Not)A;Brand";v="99", "Microsoft Edge";v="127", "Chromium";v="127"',
313
- "Sec-CH-UA-Mobile": "?0",
314
- "Sec-CH-UA-Platform": f'"{fingerprint["platform"]}"',
315
- "User-Agent": fingerprint["user_agent"],
316
- }
317
- self.session.headers.update(self.headers)
318
-
319
- # Generate cookies (consider if these need refreshing or specific values)
320
- self.cookies = {"__Host-session": uuid.uuid4().hex, '__cf_bm': uuid.uuid4().hex}
321
-
322
- # Initialize the chat interface
323
- self.chat = Chat(self)
324
-
325
- @property
326
- def models(self):
327
- class _ModelList:
328
- def list(inner_self):
329
- return YEPCHAT.AVAILABLE_MODELS
330
- return _ModelList()
331
-
332
- def convert_model_name(self, model: str) -> str:
333
- """
334
- Ensures the model name is valid for YEPCHAT.
335
- Returns the validated model name or raises an error if invalid.
336
- """
337
- if model in self.AVAILABLE_MODELS:
338
- return model
339
- else:
340
- # Raise error instead of defaulting, as model is mandatory in create()
341
- raise ValueError(f"Model '{model}' not supported by YEPCHAT. Available: {self.AVAILABLE_MODELS}")
342
-
343
- # Example usage (optional, for testing)
344
- if __name__ == '__main__':
345
- print("Testing YEPCHAT OpenAI-Compatible Client...")
346
-
347
- # Test Non-Streaming
348
- try:
349
- print("\n--- Non-Streaming Test (DeepSeek) ---")
350
- client = YEPCHAT()
351
- response = client.chat.completions.create(
352
- model="DeepSeek-R1-Distill-Qwen-32B",
353
- messages=[
354
- {"role": "user", "content": "Say 'Hello World'"}
355
- ],
356
- stream=False
357
- )
358
- print("Response:", response.choices[0].message.content)
359
- print("Usage:", response.usage) # Will show 0 tokens
360
- except Exception as e:
361
- print(f"Non-Streaming Test Failed: {e}")
362
-
363
- # Test Streaming
364
- try:
365
- print("\n--- Streaming Test (Mixtral) ---")
366
- client_stream = YEPCHAT()
367
- stream = client_stream.chat.completions.create(
368
- model="Mixtral-8x7B-Instruct-v0.1",
369
- messages=[
370
- {"role": "user", "content": "Write a short sentence about AI."}
371
- ],
372
- stream=True
373
- )
374
- print("Streaming Response:")
375
- for chunk in stream:
376
- content = chunk.choices[0].delta.content
377
- if content:
378
- print(content, end="", flush=True)
379
- print() # Add a newline at the end
380
-
381
- except Exception as e:
382
- print(f"Streaming Test Failed: {e}")
@@ -1,209 +0,0 @@
1
- from curl_cffi.requests import Session
2
- from curl_cffi import CurlError
3
- import json
4
- from typing import Dict, Generator, Union
5
-
6
- from webscout.AIutel import Optimizers
7
- from webscout.AIutel import Conversation
8
- from webscout.AIutel import AwesomePrompts, sanitize_stream
9
- from webscout.AIbase import Provider
10
- from webscout import exceptions
11
- from webscout.litagent import LitAgent
12
-
13
-
14
- class OpenGPT(Provider):
15
- """
16
- A class to interact with the Open-GPT API.
17
- """
18
-
19
- def __init__(
20
- self,
21
- is_conversation: bool = True,
22
- max_tokens: int = 600, # Note: max_tokens is not used by this API
23
- timeout: int = 30,
24
- intro: str = None,
25
- filepath: str = None,
26
- update_file: bool = True,
27
- proxies: dict = {},
28
- history_offset: int = 10250,
29
- act: str = None,
30
- app_id: str = "clf3yg8730000ih08ndbdi2v4",
31
- ):
32
- """Initializes the OpenGPT API client.
33
-
34
- Args:
35
- is_conversation (bool, optional): Whether to maintain conversation history. Defaults to True.
36
- max_tokens (int, optional): Maximum number of tokens to generate. Defaults to 600.
37
- timeout (int, optional): Http request timeout. Defaults to 30.
38
- intro (str, optional): Conversation introductory prompt. Defaults to None.
39
- filepath (str, optional): Path to file containing conversation history. Defaults to None.
40
- update_file (bool, optional): Add new prompts and responses to the file. Defaults to True.
41
- proxies (dict, optional): Http request proxies. Defaults to {}.
42
- history_offset (int, optional): Limit conversation history to this number of last texts. Defaults to 10250.
43
- act (str, optional): Awesome prompt key or index. (Used as intro). Defaults to None.
44
- app_id (str, optional): The OpenGPT application ID. Defaults to "clf3yg8730000ih08ndbdi2v4".
45
- """
46
- # Initialize curl_cffi Session
47
- self.session = Session()
48
- self.agent = LitAgent() # Keep for potential future use or other headers
49
-
50
- self.is_conversation = is_conversation
51
- self.max_tokens_to_sample = max_tokens
52
- self.timeout = timeout
53
- self.last_response = {}
54
- self.app_id = app_id
55
-
56
- # Set up headers (remove User-Agent if using impersonate)
57
- self.headers = {
58
- "Content-Type": "application/json",
59
- # "User-Agent": self.agent.random(), # Removed, handled by impersonate
60
- "Referer": f"https://open-gpt.app/id/app/{self.app_id}",
61
- # Add sec-ch-ua headers if needed for impersonation consistency
62
- }
63
-
64
- # Update curl_cffi session headers and proxies
65
- self.session.headers.update(self.headers)
66
- self.session.proxies = proxies # Assign proxies directly
67
-
68
- # Initialize optimizers
69
- self.__available_optimizers = (
70
- method
71
- for method in dir(Optimizers)
72
- if callable(getattr(Optimizers, method)) and not method.startswith("__")
73
- )
74
-
75
- # Setup conversation
76
- Conversation.intro = (
77
- AwesomePrompts().get_act(
78
- act, raise_not_found=True, default=None, case_insensitive=True
79
- ) if act else intro or Conversation.intro
80
- )
81
-
82
- self.conversation = Conversation(
83
- is_conversation, self.max_tokens_to_sample, filepath, update_file
84
- )
85
- self.conversation.history_offset = history_offset
86
-
87
- def ask(
88
- self,
89
- prompt: str,
90
- stream: bool = False, # Note: API does not support streaming
91
- raw: bool = False,
92
- optimizer: str = None,
93
- conversationally: bool = False,
94
- ) -> Union[Dict, Generator]:
95
- """
96
- Send a prompt to the OpenGPT API and get a response.
97
-
98
- Args:
99
- prompt: The user input/prompt for the API.
100
- stream: Whether to stream the response.
101
- raw: Whether to return the raw API response.
102
- optimizer: Optimizer to use on the prompt.
103
- conversationally: Whether to apply the optimizer on the full conversation prompt.
104
-
105
- Returns:
106
- A dictionary or generator with the response.
107
- """
108
- conversation_prompt = self.conversation.gen_complete_prompt(prompt)
109
-
110
- if optimizer:
111
- if optimizer in self.__available_optimizers:
112
- conversation_prompt = getattr(Optimizers, optimizer)(
113
- conversation_prompt if conversationally else prompt
114
- )
115
- else:
116
- raise Exception(f"Optimizer is not one of {self.__available_optimizers}")
117
-
118
- # Prepare the request body payload
119
- payload = {
120
- "userInput": conversation_prompt,
121
- "id": self.app_id,
122
- "userKey": "" # Assuming userKey is meant to be empty as in the original code
123
- }
124
-
125
- # API does not stream, implement non-stream logic directly
126
- def for_non_stream():
127
- try:
128
- # Use curl_cffi session post with impersonate
129
- response = self.session.post(
130
- "https://open-gpt.app/api/generate",
131
- # headers are set on the session
132
- data=json.dumps(payload), # Keep data as JSON string
133
- timeout=self.timeout,
134
- # proxies are set on the session
135
- impersonate="chrome110" # Use a common impersonation profile
136
- )
137
-
138
- response.raise_for_status() # Check for HTTP errors
139
-
140
- # Use response.text which is already decoded
141
- response_text = response.text
142
- self.last_response = {"text": response_text}
143
- self.conversation.update_chat_history(prompt, response_text)
144
-
145
- # Return dict or raw string based on raw flag
146
- return {"raw": response_text} if raw else {"text": response_text}
147
-
148
- except CurlError as e: # Catch CurlError
149
- raise exceptions.FailedToGenerateResponseError(f"Request failed (CurlError): {e}") from e
150
- except Exception as e: # Catch other potential exceptions (like HTTPError, JSONDecodeError)
151
- err_text = getattr(e, 'response', None) and getattr(e.response, 'text', '')
152
- raise exceptions.FailedToGenerateResponseError(f"An unexpected error occurred ({type(e).__name__}): {e} - {err_text}") from e
153
-
154
- # This provider doesn't support streaming, so just return non-stream
155
- return for_non_stream()
156
-
157
- def chat(
158
- self,
159
- prompt: str,
160
- stream: bool = False, # Keep stream param for interface consistency
161
- optimizer: str = None,
162
- conversationally: bool = False,
163
- ) -> Union[str, Generator[str, None, None]]:
164
- """
165
- Send a prompt to the OpenGPT API and get a text response.
166
-
167
- Args:
168
- prompt: The user input/prompt for the API.
169
- stream: Whether to stream the response (not supported).
170
- optimizer: Optimizer to use on the prompt.
171
- conversationally: Whether to apply the optimizer on the full conversation prompt.
172
-
173
- Returns:
174
- A string with the response text.
175
- """
176
- # Since ask() now handles both stream=True/False by returning the full response dict:
177
- response_data = self.ask(
178
- prompt,
179
- stream=False, # Call ask in non-stream mode internally
180
- raw=False, # Ensure ask returns dict with 'text' key
181
- optimizer=optimizer,
182
- conversationally=conversationally
183
- )
184
- # If stream=True was requested, simulate streaming by yielding the full message at once
185
- if stream:
186
- def stream_wrapper():
187
- yield self.get_message(response_data) # yield only the text string
188
- return stream_wrapper()
189
- else:
190
- # If stream=False, return the full message directly
191
- return self.get_message(response_data)
192
-
193
- def get_message(self, response: dict) -> str:
194
- """
195
- Extract the message from the response dictionary.
196
-
197
- Args:
198
- response: Response dictionary from the ask method.
199
-
200
- Returns:
201
- The text response as a string.
202
- """
203
- assert isinstance(response, dict), "Response should be of dict data-type only"
204
- return response["text"]
205
-
206
-
207
- if __name__ == "__main__":
208
- ai = OpenGPT()
209
- print(ai.chat("Hello, how are you?"))