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,315 +1,330 @@
1
- import json
2
- import uuid
3
- from typing import Any, Dict, Generator, Union
4
-
5
- # Use curl_cffi for requests
6
- from curl_cffi.requests import Session
7
- from curl_cffi import CurlError
8
-
9
- from webscout.AIutel import Optimizers
10
- from webscout.AIutel import Conversation
11
- from webscout.AIutel import AwesomePrompts, sanitize_stream
12
- from webscout.AIbase import Provider
13
- from webscout import exceptions
14
- from webscout.litagent import LitAgent
15
-
16
- class MCPCore(Provider):
17
- """
18
- A class to interact with the chat.mcpcore.xyz API.
19
- Supports streaming responses.
20
- """
21
-
22
- # Add more models if known, starting with the one from the example
23
- AVAILABLE_MODELS = [
24
- "google/gemma-7b-it",
25
- "deepseek-ai/deepseek-coder-33b-instruct",
26
- "deepseek-ai/DeepSeek-R1",
27
- "deepseek-ai/DeepSeek-R1-Distill-Qwen-14B",
28
- "deepseek-ai/DeepSeek-v3-0324",
29
- "fixie-ai/ultravox-v0_4_1-llama-3_1-8b",
30
- "meta-llama/Llama-3.3-70B-Instruct",
31
- "meta-llama/Llama-4-Maverick-Instruct",
32
- "mistralai/Mistral-7B-Instruct-v0.2",
33
- "qwen-max-latest",
34
- "qwen-plus-latest",
35
- "qwen2.5-coder-32b-instruct",
36
- "qwen-turbo-latest",
37
- "qwen2.5-14b-instruct-1m",
38
- "GLM-4-32B",
39
- "Z1-32B",
40
- "Z1-Rumination",
41
- "arena-model",
42
- "qvq-72b-preview-0310",
43
- "qwq-32b",
44
- "qwen3-235b-a22b",
45
- "qwen3-30b-a3b",
46
- "qwen3-32b",
47
- "deepseek-flash",
48
- "@cf/meta/llama-4-scout-17b-16e-instruct",
49
- "任务专用",
50
- ]
51
-
52
- def __init__(
53
- self,
54
- cookies_path: str,
55
- is_conversation: bool = True,
56
- max_tokens: int = 2048,
57
- timeout: int = 60,
58
- intro: str = None,
59
- filepath: str = None,
60
- update_file: bool = True,
61
- proxies: dict = {},
62
- history_offset: int = 10250,
63
- act: str = None,
64
- model: str = "qwen3-32b",
65
- system_prompt: str = "You are a helpful assistant.",
66
- ):
67
- """Initializes the MCPCore API client."""
68
- if model not in self.AVAILABLE_MODELS:
69
- print(f"Warning: Model '{model}' not in known AVAILABLE_MODELS. Attempting to use anyway.")
70
-
71
- self.api_endpoint = "https://chat.mcpcore.xyz/api/chat/completions"
72
- self.model = model
73
- self.system_prompt = system_prompt
74
- self.cookies_path = cookies_path
75
- self.cookie_string, self.token = self._load_cookies()
76
-
77
- # Initialize curl_cffi Session
78
- self.session = Session()
79
-
80
- # Set up headers based on the provided request
81
- self.headers = {
82
- 'authority': 'chat.mcpcore.xyz',
83
- 'accept': '*/*',
84
- 'accept-language': 'en-US,en;q=0.9,en-IN;q=0.8',
85
- 'authorization': f'Bearer {self.token}' if self.token else '',
86
- 'content-type': 'application/json',
87
- 'dnt': '1',
88
- 'origin': 'https://chat.mcpcore.xyz',
89
- 'referer': 'https://chat.mcpcore.xyz/',
90
- 'priority': 'u=1, i',
91
- 'sec-ch-ua': '"Microsoft Edge";v="135", "Not-A.Brand";v="8", "Chromium";v="135"',
92
- 'sec-ch-ua-mobile': '?0',
93
- 'sec-ch-ua-platform': '"Windows"',
94
- 'sec-fetch-dest': 'empty',
95
- 'sec-fetch-mode': 'cors',
96
- 'sec-fetch-site': 'same-origin',
97
- 'sec-gpc': '1',
98
- 'user-agent': LitAgent().random(),
99
- }
100
-
101
- # Apply headers, proxies, and cookies to the session
102
- self.session.headers.update(self.headers)
103
- self.session.proxies = proxies
104
- self.cookies = {
105
- 'token': self.token,
106
- }
107
- for name, value in self.cookies.items():
108
- self.session.cookies.set(name, value, domain="chat.mcpcore.xyz")
109
-
110
- # Provider settings
111
- self.is_conversation = is_conversation
112
- self.max_tokens_to_sample = max_tokens
113
- self.timeout = timeout
114
- self.last_response = {}
115
-
116
- # Initialize optimizers
117
- self.__available_optimizers = (
118
- method
119
- for method in dir(Optimizers)
120
- if callable(getattr(Optimizers, method))
121
- and not method.startswith("__")
122
- )
123
- Conversation.intro = (
124
- AwesomePrompts().get_act(
125
- act, raise_not_found=True, default=None, case_insensitive=True
126
- )
127
- if act
128
- else intro or Conversation.intro
129
- )
130
- self.conversation = Conversation(
131
- is_conversation, self.max_tokens_to_sample, filepath, update_file
132
- )
133
- self.conversation.history_offset = history_offset
134
-
135
- def _load_cookies(self) -> tuple[str, str]:
136
- """Load cookies from a JSON file and build a cookie header string."""
137
- try:
138
- with open(self.cookies_path, "r") as f:
139
- cookies = json.load(f)
140
- cookie_string = "; ".join(
141
- f"{cookie['name']}={cookie['value']}" for cookie in cookies if 'name' in cookie and 'value' in cookie
142
- )
143
- token = next(
144
- (cookie.get("value") for cookie in cookies if cookie.get("name") == "token"),
145
- "",
146
- )
147
- return cookie_string, token
148
- except FileNotFoundError:
149
- raise exceptions.FailedToGenerateResponseError(
150
- f"Error: Cookies file not found at {self.cookies_path}!"
151
- )
152
- except json.JSONDecodeError:
153
- raise exceptions.FailedToGenerateResponseError(
154
- f"Error: Invalid JSON format in cookies file: {self.cookies_path}!"
155
- )
156
-
157
- def ask(
158
- self,
159
- prompt: str,
160
- stream: bool = False,
161
- raw: bool = False,
162
- optimizer: str = None,
163
- conversationally: bool = False,
164
- **kwargs
165
- ) -> Union[Dict[str, Any], Generator]:
166
- """Sends a prompt to the MCPCore API and returns the response."""
167
-
168
- conversation_prompt = self.conversation.gen_complete_prompt(prompt)
169
-
170
- if optimizer:
171
- if optimizer in self.__available_optimizers:
172
- conversation_prompt = getattr(Optimizers, optimizer)(
173
- conversation_prompt if conversationally else prompt
174
- )
175
- else:
176
- raise exceptions.InvalidOptimizerError(
177
- f"Optimizer is not one of {self.__available_optimizers}"
178
- )
179
-
180
- chat_id = kwargs.get("chat_id", str(uuid.uuid4()))
181
- message_id = str(uuid.uuid4())
182
-
183
- payload = {
184
- "stream": stream,
185
- "model": self.model,
186
- "messages": [
187
- {"role": "system", "content": self.system_prompt},
188
- {"role": "user", "content": conversation_prompt}
189
- ],
190
- "params": kwargs.get("params", {}),
191
- "tool_servers": kwargs.get("tool_servers", []),
192
- "features": kwargs.get("features", {"web_search": False}),
193
- "chat_id": chat_id,
194
- "id": message_id,
195
- "stream_options": kwargs.get("stream_options", {"include_usage": True})
196
- }
197
-
198
- def for_stream():
199
- streaming_text = ""
200
- try:
201
- response = self.session.post(
202
- self.api_endpoint,
203
- json=payload,
204
- stream=True,
205
- timeout=self.timeout,
206
- impersonate="chrome110"
207
- )
208
- response.raise_for_status()
209
-
210
- # Use sanitize_stream
211
- processed_stream = sanitize_stream(
212
- data=response.iter_content(chunk_size=None), # Pass byte iterator
213
- intro_value="data:",
214
- to_json=True, # Stream sends JSON
215
- skip_markers=["[DONE]"],
216
- content_extractor=lambda chunk: chunk.get('choices', [{}])[0].get('delta', {}).get('content') if isinstance(chunk, dict) else None,
217
- yield_raw_on_error=False # Skip non-JSON or lines where extractor fails
218
- )
219
-
220
- for content_chunk in processed_stream:
221
- # content_chunk is the string extracted by the content_extractor
222
- if content_chunk and isinstance(content_chunk, str):
223
- streaming_text += content_chunk
224
- yield dict(text=content_chunk) if not raw else content_chunk
225
-
226
- self.last_response = {"text": streaming_text}
227
- self.conversation.update_chat_history(prompt, self.get_message(self.last_response))
228
-
229
- except CurlError as e:
230
- raise exceptions.FailedToGenerateResponseError(f"Request failed (CurlError): {e}") from e
231
- except Exception as e:
232
- err_text = getattr(e, 'response', None) and getattr(e.response, 'text', '')
233
- raise exceptions.FailedToGenerateResponseError(f"An unexpected error occurred ({type(e).__name__}): {e} - {err_text}") from e
234
-
235
- def for_non_stream():
236
- full_text = ""
237
- try:
238
- stream_generator = self.ask(
239
- prompt, stream=True, raw=False, optimizer=optimizer, conversationally=conversationally, **kwargs
240
- )
241
- for chunk_data in stream_generator:
242
- if isinstance(chunk_data, dict):
243
- full_text += chunk_data["text"]
244
- elif isinstance(chunk_data, str):
245
- full_text += chunk_data
246
- except Exception as e:
247
- raise exceptions.FailedToGenerateResponseError(f"Failed to aggregate non-stream response: {str(e)}") from e
248
-
249
- return full_text if raw else self.last_response
250
-
251
- return for_stream() if stream else for_non_stream()
252
-
253
- def chat(
254
- self,
255
- prompt: str,
256
- stream: bool = False,
257
- optimizer: str = None,
258
- conversationally: bool = False,
259
- **kwargs
260
- ) -> Union[str, Generator[str, None, None]]:
261
- """Generates a response from the MCPCore API."""
262
-
263
- def for_stream_chat() -> Generator[str, None, None]:
264
- gen = self.ask(
265
- prompt, stream=True, raw=False,
266
- optimizer=optimizer, conversationally=conversationally, **kwargs
267
- )
268
- for response_dict in gen:
269
- yield self.get_message(response_dict)
270
-
271
- def for_non_stream_chat() -> str:
272
- response_data = self.ask(
273
- prompt, stream=False, raw=False,
274
- optimizer=optimizer, conversationally=conversationally, **kwargs
275
- )
276
- return self.get_message(response_data)
277
-
278
- return for_stream_chat() if stream else for_non_stream_chat()
279
-
280
- def get_message(self, response: Dict[str, Any]) -> str:
281
- """Extracts the message from the API response."""
282
- assert isinstance(response, dict), "Response should be of dict data-type only"
283
- return response.get("text", "")
284
-
285
- # Example usage (remember to create a cookies.json file)
286
- if __name__ == "__main__":
287
- from rich import print
288
-
289
- cookies_file_path = "cookies.json"
290
-
291
- print("-" * 80)
292
- print(f"{'Model':<50} {'Status':<10} {'Response'}")
293
- print("-" * 80)
294
-
295
- for model in MCPCore.AVAILABLE_MODELS:
296
- try:
297
- test_ai = MCPCore(cookies_path=cookies_file_path, model=model, timeout=60)
298
- response = test_ai.chat("Say 'Hello' in one word", stream=True)
299
- response_text = ""
300
- # Accumulate the response text without printing in the loop
301
- for chunk in response:
302
- response_text += chunk
303
-
304
- if response_text and len(response_text.strip()) > 0:
305
- status = "✓"
306
- # Truncate response if too long
307
- display_text = response_text.strip()[:50] + "..." if len(response_text.strip()) > 50 else response_text.strip()
308
- else:
309
- status = "✗"
310
- display_text = "Empty or invalid response"
311
- # Print the final status and response, overwriting the "Testing..." line
312
- print(f"\r{model:<50} {status:<10} {display_text}")
313
- except Exception as e:
314
- # Print error, overwriting the "Testing..." line
315
- print(f"\r{model:<50} {'✗':<10} {str(e)}")
1
+ import random
2
+ import string
3
+ import uuid
4
+ import warnings
5
+ from typing import Any, Dict, Generator, Optional, Union, cast
6
+
7
+ import urllib3
8
+ from curl_cffi.requests import Session
9
+
10
+ from webscout import exceptions
11
+ from webscout.AIbase import Provider, Response
12
+ from webscout.AIutel import AwesomePrompts, Conversation, Optimizers, sanitize_stream
13
+ from webscout.litagent import LitAgent
14
+
15
+ # Suppress only the single InsecureRequestWarning from urllib3 needed for verify=False
16
+ warnings.filterwarnings("ignore", category=urllib3.exceptions.InsecureRequestWarning)
17
+
18
+ class XenAI(Provider):
19
+
20
+ # Add more models if known, starting with the one from the example
21
+ AVAILABLE_MODELS = [
22
+ "gemini-2.5-pro-preview-05-06",
23
+ "gemini-2.5-flash-preview-05-20",
24
+ "o4-mini-high",
25
+ "grok-3-mini-fast-beta",
26
+ "grok-3-fast-beta",
27
+ "gpt-4.1",
28
+ "o3-high",
29
+ "gpt-4o-search-preview",
30
+ "gpt-4o",
31
+ "claude-sonnet-4-20250514",
32
+ "claude-sonnet-4-20250514-thinking",
33
+ "deepseek-ai/DeepSeek-V3-0324",
34
+ "deepseek-ai/DeepSeek-R1-0528",
35
+ "groq/deepseek-r1-distill-llama-70b",
36
+ "deepseek-ai/DeepSeek-Prover-V2-671B",
37
+ "meta-llama/llama-4-maverick-17b-128e-instruct",
38
+ "meta-llama/llama-4-scout-17b-16e-instruct",
39
+ "cognitivecomputations/Dolphin3.0-Mistral-24B",
40
+ "sonar-pro",
41
+ "gpt-4o-mini",
42
+ "gemini-2.0-flash-lite-preview-02-05",
43
+ "claude-3-7-sonnet-20250219",
44
+ "claude-3-7-sonnet-20250219-thinking",
45
+ "claude-opus-4-20250514",
46
+ "claude-opus-4-20250514-thinking",
47
+ "chutesai/Llama-4-Maverick-17B-128E-Instruct-FP8",
48
+ "chutesai/Llama-4-Scout-17B-16E-Instruct",
49
+ ]
50
+
51
+ def __init__(
52
+ self,
53
+ is_conversation: bool = True,
54
+ max_tokens: int = 2048,
55
+ timeout: int = 60,
56
+ intro: Optional[str] = None,
57
+ filepath: Optional[str] = None,
58
+ update_file: bool = True,
59
+ proxies: dict = {},
60
+ history_offset: int = 10250,
61
+ act: Optional[str] = None,
62
+ model: str = "gemini-2.5-pro-preview-05-06",
63
+ system_prompt: str = "You are a helpful assistant.",
64
+ ):
65
+ """Initializes the xenai API client."""
66
+ if model not in self.AVAILABLE_MODELS:
67
+ print(f"Warning: Model '{model}' is not listed in AVAILABLE_MODELS. Proceeding with the provided model.")
68
+
69
+ self.api_endpoint = "https://chat.xenai.tech/api/chat/completions"
70
+
71
+ self.model = model
72
+ self.system_prompt = system_prompt
73
+
74
+ # Initialize curl_cffi Session
75
+ self.session = Session()
76
+
77
+ # Set up headers based on the provided request
78
+ self.headers = {
79
+ **LitAgent().generate_fingerprint(),
80
+ 'origin': 'https://chat.xenai.tech',
81
+ 'referer': 'https://chat.xenai.tech/',
82
+ }
83
+
84
+ # Apply headers, proxies, and cookies to the session
85
+ self.session.headers.update(self.headers)
86
+ self.session.proxies.update(proxies)
87
+ # Always disable SSL verification for this session
88
+ self.session.verify = False
89
+
90
+ # Provider settings
91
+ self.is_conversation = is_conversation
92
+ self.max_tokens_to_sample = max_tokens
93
+ self.timeout = timeout
94
+ self.last_response = {}
95
+
96
+ # Initialize optimizers
97
+ self.__available_optimizers = (
98
+ method
99
+ for method in dir(Optimizers)
100
+ if callable(getattr(Optimizers, method))
101
+ and not method.startswith("__")
102
+ )
103
+ self.conversation = Conversation(
104
+ is_conversation, self.max_tokens_to_sample, filepath, update_file
105
+ )
106
+ act_prompt = (
107
+ AwesomePrompts().get_act(cast(Union[str, int], act), default=None, case_insensitive=True
108
+ )
109
+ if act
110
+ else intro
111
+ )
112
+ if act_prompt:
113
+ self.conversation.intro = act_prompt
114
+ self.conversation.history_offset = history_offset
115
+
116
+ # Token handling: always auto-fetch token, no cookies logic
117
+ self.token = self._auto_fetch_token()
118
+
119
+ # Set the Authorization header for the session
120
+ self.session.headers.update({
121
+ 'authorization': f'Bearer {self.token}',
122
+ })
123
+
124
+ def _auto_fetch_token(self):
125
+ """Automatically fetch a token from the signup endpoint using requests."""
126
+ session = Session()
127
+ session.verify = False # Always disable SSL verification for this session
128
+ def random_string(length=8):
129
+ return ''.join(random.choices(string.ascii_lowercase, k=length))
130
+ name = random_string(8)
131
+ email = f"{name}@gmail.com"
132
+ password = email
133
+ profile_image_url = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGQAAABkCAYAAABw4pVUAAAAAXNSR0IArs4c6QAAAkRJREFUeF7tmDFOw0AUBdcSiIaKM3CKHIQ7UHEISq5AiUTFHYC0XADoTRsJEZFEjhFIaYAim92fjGFS736/zOTZzjavl0d98oMh0CgE4+IriEJYPhQC86EQhdAIwPL4DFEIjAAsjg1RCIwALI4NUQiMACyODVEIjAAsjg1RCIwALI4NUQiMACyODVEIjAAsjg1RCIwALI4NUQiMACyODVEIjAAsjg1RCIwALI4NUQiMACyODVEIjAAsjg1RCIwALI4NUQiMACyODVEIjAAsjg1RCIwALI4NUQiMACyODVEIjAAsjg2BCfkAIqwAA94KZ/EAAAAASUVORK5CYII="
134
+ payload = {
135
+ "name": name,
136
+ "email": email,
137
+ "password": password,
138
+ "profile_image_url": profile_image_url
139
+ }
140
+ headers = {
141
+ **LitAgent().generate_fingerprint(),
142
+ 'origin': 'https://chat.xenai.tech',
143
+ 'referer': 'https://chat.xenai.tech/auth',
144
+ }
145
+ try:
146
+ resp = session.post(
147
+ "https://chat.xenai.tech/api/v1/auths/signup",
148
+ headers=headers,
149
+ json=payload,
150
+ timeout=30,
151
+ verify=False # Disable SSL verification for testing
152
+ )
153
+ if resp.ok:
154
+ data = resp.json()
155
+ token = data.get("token")
156
+ if token:
157
+ return token
158
+ set_cookie = resp.headers.get("set-cookie", "")
159
+ if "token=" in set_cookie:
160
+ return set_cookie.split("token=")[1].split(";")[0]
161
+ raise exceptions.FailedToGenerateResponseError(f"Failed to auto-fetch token: {resp.status_code} {resp.text}")
162
+ except Exception as e:
163
+ raise exceptions.FailedToGenerateResponseError(f"Token auto-fetch failed: {e}")
164
+
165
+ def ask(
166
+ self,
167
+ prompt: str,
168
+ stream: bool = False,
169
+ raw: bool = False,
170
+ optimizer: Optional[str] = None,
171
+ conversationally: bool = False,
172
+ **kwargs
173
+ ) -> Union[Dict[str, Any], Generator]:
174
+ """Sends a prompt to the xenai API and returns the response."""
175
+
176
+ conversation_prompt = self.conversation.gen_complete_prompt(prompt)
177
+
178
+ if optimizer:
179
+ if optimizer in self.__available_optimizers:
180
+ conversation_prompt = getattr(Optimizers, optimizer)(
181
+ conversation_prompt if conversationally else prompt
182
+ )
183
+ else:
184
+ raise exceptions.InvalidOptimizerError(
185
+ f"Optimizer is not one of {self.__available_optimizers}"
186
+ )
187
+
188
+ chat_id = kwargs.get("chat_id", str(uuid.uuid4()))
189
+ message_id = str(uuid.uuid4())
190
+
191
+ payload = {
192
+ "stream": stream,
193
+ "model": self.model,
194
+ "messages": [
195
+ {"role": "system", "content": self.system_prompt},
196
+ {"role": "user", "content": conversation_prompt}
197
+ ],
198
+ "params": kwargs.get("params", {}),
199
+ "tool_servers": kwargs.get("tool_servers", []),
200
+ "features": kwargs.get("features", {"web_search": False}),
201
+ "chat_id": chat_id,
202
+ "id": message_id,
203
+ "stream_options": kwargs.get("stream_options", {"include_usage": True})
204
+ }
205
+
206
+ def for_stream():
207
+ streaming_text = ""
208
+ try:
209
+ response = self.session.post(
210
+ self.api_endpoint,
211
+ json=payload,
212
+ stream=True,
213
+ timeout=self.timeout,
214
+ verify=False # Always disable SSL verification for this request
215
+ )
216
+ response.raise_for_status()
217
+
218
+ # Use sanitize_stream
219
+ processed_stream = sanitize_stream(
220
+ data=response.iter_content(chunk_size=None), # Pass byte iterator
221
+ intro_value="data:",
222
+ to_json=True, # Stream sends JSON
223
+ skip_markers=["[DONE]"],
224
+ content_extractor=lambda chunk: chunk.get('choices', [{}])[0].get('delta', {}).get('content') if isinstance(chunk, dict) else None,
225
+ yield_raw_on_error=False # Skip non-JSON or lines where extractor fails
226
+ )
227
+
228
+ for content_chunk in processed_stream:
229
+ # content_chunk is the string extracted by the content_extractor
230
+ if content_chunk and isinstance(content_chunk, str):
231
+ streaming_text += content_chunk
232
+ yield dict(text=content_chunk) if not raw else content_chunk
233
+
234
+ self.last_response = {"text": streaming_text}
235
+ self.conversation.update_chat_history(prompt, self.get_message(self.last_response))
236
+
237
+ except Exception as e:
238
+ raise exceptions.FailedToGenerateResponseError(f"Request failed (requests): {e}") from e
239
+ except Exception as e:
240
+ err_text = ""
241
+ if hasattr(e, 'response'):
242
+ response_obj = getattr(e, 'response')
243
+ if hasattr(response_obj, 'text'):
244
+ err_text = getattr(response_obj, 'text')
245
+ raise exceptions.FailedToGenerateResponseError(f"An unexpected error occurred ({type(e).__name__}): {e} - {err_text}") from e
246
+
247
+ def for_non_stream():
248
+ full_text = ""
249
+ try:
250
+ stream_generator = self.ask(
251
+ prompt, stream=True, raw=False, optimizer=optimizer, conversationally=conversationally, **kwargs
252
+ )
253
+ for chunk_data in stream_generator:
254
+ if isinstance(chunk_data, dict):
255
+ full_text += chunk_data["text"]
256
+ elif isinstance(chunk_data, str):
257
+ full_text += chunk_data
258
+ except Exception as e:
259
+ raise exceptions.FailedToGenerateResponseError(f"Failed to aggregate non-stream response (requests): {str(e)}") from e
260
+ except Exception as e:
261
+ raise exceptions.FailedToGenerateResponseError(f"Failed to aggregate non-stream response: {str(e)}") from e
262
+
263
+ return full_text if raw else self.last_response
264
+
265
+ return for_stream() if stream else for_non_stream()
266
+
267
+ def chat(
268
+ self,
269
+ prompt: str,
270
+ stream: bool = False,
271
+ optimizer: Optional[str] = None,
272
+ conversationally: bool = False,
273
+ **kwargs
274
+ ) -> Union[str, Generator[str, None, None]]:
275
+ """Generates a response from the xenai API."""
276
+
277
+ def for_stream_chat() -> Generator[str, None, None]:
278
+ gen = self.ask(
279
+ prompt, stream=True, raw=False,
280
+ optimizer=optimizer, conversationally=conversationally, **kwargs
281
+ )
282
+ for response_item in gen:
283
+ yield self.get_message(response_item)
284
+
285
+ def for_non_stream_chat() -> str:
286
+ response_data = self.ask(
287
+ prompt, stream=False, raw=False,
288
+ optimizer=optimizer, conversationally=conversationally, **kwargs
289
+ )
290
+ return self.get_message(response_data)
291
+
292
+ return for_stream_chat() if stream else for_non_stream_chat()
293
+
294
+ def get_message(self, response: Response) -> str:
295
+ """Extracts the message from the API response."""
296
+ if isinstance(response, str):
297
+ return response
298
+ if isinstance(response, dict):
299
+ return dict(response).get("text", "")
300
+ return str(response)
301
+
302
+ # Example usage (no cookies file needed)
303
+ if __name__ == "__main__":
304
+ from rich import print
305
+
306
+ print("-" * 80)
307
+ print(f"{'Model':<50} {'Status':<10} {'Response'}")
308
+ print("-" * 80)
309
+
310
+ for model in XenAI.AVAILABLE_MODELS:
311
+ try:
312
+ test_ai = XenAI(model=model, timeout=60)
313
+ response = test_ai.chat("Say 'Hello' in one word", stream=True)
314
+ response_text = ""
315
+ # Accumulate the response text without printing in the loop
316
+ for chunk in response:
317
+ response_text += chunk
318
+
319
+ if response_text and len(response_text.strip()) > 0:
320
+ status = "✓"
321
+ # Truncate response if too long
322
+ display_text = response_text.strip()[:50] + "..." if len(response_text.strip()) > 50 else response_text.strip()
323
+ else:
324
+ status = "✗"
325
+ display_text = "Empty or invalid response"
326
+ # Print the final status and response, overwriting the "Testing..." line
327
+ print(f"\r{model:<50} {status:<10} {display_text}")
328
+ except Exception as e:
329
+ # Print error, overwriting the "Testing..." line
330
+ print(f"\r{model:<50} {'✗':<10} {str(e)}")