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,330 +1,347 @@
1
- from uuid import uuid4
2
- import json
3
- import datetime
4
- from webscout.AIutel import Optimizers
5
- from webscout.AIutel import Conversation
6
- from webscout.AIutel import AwesomePrompts
7
- from webscout.AIbase import Provider
8
- from webscout import exceptions
9
- import cloudscraper
10
-
11
-
12
- class YouChat(Provider):
13
- """
14
- This class provides methods for interacting with the You.com chat API in a consistent provider structure.
15
- """
16
-
17
- # Updated available models based on latest aiModels list
18
- # All models with isProOnly: false are included
19
- AVAILABLE_MODELS = [
20
- # ProOnly models (not available without subscription)
21
- # "gpt_4_5_preview", # isProOnly: true
22
- # "openai_o3_mini_high", # isProOnly: true
23
- # "openai_o3_mini_medium", # isProOnly: true
24
- # "openai_o1", # isProOnly: true
25
- # "openai_o1_preview", # isProOnly: true
26
- # "openai_o1_mini", # isProOnly: true
27
- # "gpt_4", # isProOnly: true
28
- # "claude_3_7_sonnet_thinking", # isProOnly: true
29
- # "claude_3_7_sonnet", # isProOnly: true
30
- # "claude_3_5_sonnet", # isProOnly: true
31
- # "claude_3_opus", # isProOnly: true
32
- # "qwq_32b", # isProOnly: true
33
- # "deepseek_r1", # isProOnly: true
34
- # "deepseek_v3", # isProOnly: true
35
- # "gemini_2_5_pro_experimental", # isProOnly: true
36
-
37
- # Free models (isProOnly: false)
38
- "gpt_4o_mini",
39
- "gpt_4o",
40
- "gpt_4_turbo",
41
- "claude_3_sonnet",
42
- "claude_3_5_haiku",
43
- "qwen2p5_72b",
44
- "qwen2p5_coder_32b",
45
- "gemini_2_flash",
46
- "gemini_1_5_flash",
47
- "gemini_1_5_pro",
48
- "grok_2",
49
- "llama4_maverick",
50
- "llama4_scout",
51
- "llama3_1_405b",
52
- "mistral_large_2",
53
- "command_r_plus",
54
-
55
- # Free models not enabled for user chat modes
56
- "llama3_3_70b", # isAllowedForUserChatModes: false
57
- "llama3_2_90b", # isAllowedForUserChatModes: false
58
- "databricks_dbrx_instruct", # isAllowedForUserChatModes: false
59
- "solar_1_mini", # isAllowedForUserChatModes: false
60
- "dolphin_2_5", # isAllowedForUserChatModes: false, isUncensoredModel: true
61
- ]
62
-
63
- def __init__(
64
- self,
65
- is_conversation: bool = True,
66
- max_tokens: int = 600,
67
- timeout: int = 30,
68
- intro: str = None,
69
- filepath: str = None,
70
- update_file: bool = True,
71
- proxies: dict = {},
72
- history_offset: int = 10250,
73
- act: str = None,
74
- model: str = "gemini_2_flash",
75
- ):
76
- """Instantiates YouChat
77
-
78
- Args:
79
- is_conversation (bool, optional): Flag for chatting conversationally. Defaults to True.
80
- max_tokens (int, optional): Maximum number of tokens to be generated upon completion. Defaults to 600.
81
- timeout (int, optional): Http request timeout. Defaults to 30.
82
- intro (str, optional): Conversation introductory prompt. Defaults to None.
83
- filepath (str, optional): Path to file containing conversation history. Defaults to None.
84
- update_file (bool, optional): Add new prompts and responses to the file. Defaults to True.
85
- proxies (dict, optional): Http request proxies. Defaults to {}.
86
- history_offset (int, optional): Limit conversation history to this number of last texts. Defaults to 10250.
87
- act (str|int, optional): Awesome prompt key or index. (Used as intro). Defaults to None.
88
- model (str, optional): Model to use. Defaults to "gemini_2_flash".
89
- """
90
- if model not in self.AVAILABLE_MODELS:
91
- raise ValueError(f"Invalid model: {model}. Choose from: {self.AVAILABLE_MODELS}")
92
-
93
- self.session = cloudscraper.create_scraper() # Create a Cloudscraper session
94
- self.is_conversation = is_conversation
95
- self.max_tokens_to_sample = max_tokens
96
- self.chat_endpoint = "https://you.com/api/streamingSearch"
97
- self.stream_chunk_size = 64
98
- self.timeout = timeout
99
- self.last_response = {}
100
- self.model = model
101
- self.headers = {
102
- "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36 Edg/135.0.0.0",
103
- "Accept": "text/event-stream",
104
- "Accept-Language": "en-US,en;q=0.9,en-IN;q=0.8",
105
- "Referer": "https://you.com/search?q=hi&fromSearchBar=true&tbm=youchat",
106
- "Connection": "keep-alive",
107
- "DNT": "1",
108
- "Content-Type": "text/plain;charset=UTF-8",
109
- }
110
- self.cookies = {
111
- "uuid_guest": uuid4().hex,
112
- "uuid_guest_backup": uuid4().hex,
113
- "youchat_personalization": "true",
114
- "youchat_smart_learn": "true",
115
- "youpro_subscription": "false",
116
- "you_subscription": "freemium",
117
- "safesearch_guest": "Moderate",
118
- "__cf_bm": uuid4().hex,
119
- }
120
-
121
- self.__available_optimizers = (
122
- method
123
- for method in dir(Optimizers)
124
- if callable(getattr(Optimizers, method)) and not method.startswith("__")
125
- )
126
- Conversation.intro = (
127
- AwesomePrompts().get_act(
128
- act, raise_not_found=True, default=None, case_insensitive=True
129
- )
130
- if act
131
- else intro or Conversation.intro
132
- )
133
- self.conversation = Conversation(
134
- is_conversation, self.max_tokens_to_sample, filepath, update_file
135
- )
136
- self.conversation.history_offset = history_offset
137
- self.session.proxies = proxies
138
-
139
- def ask(
140
- self,
141
- prompt: str,
142
- stream: bool = False,
143
- raw: bool = False,
144
- optimizer: str = None,
145
- conversationally: bool = False,
146
- ) -> dict:
147
- """Chat with AI
148
-
149
- Args:
150
- prompt (str): Prompt to be send.
151
- stream (bool, optional): Flag for streaming response. Defaults to False.
152
- raw (bool, optional): Stream back raw response as received. Defaults to False.
153
- optimizer (str, optional): Prompt optimizer name - `[code, shell_command]`. Defaults to None.
154
- conversationally (bool, optional): Chat conversationally when using optimizer. Defaults to False.
155
- Returns:
156
- dict : {}
157
- ```json
158
- {
159
- "text" : "How may I assist you today?"
160
- }
161
- ```
162
- """
163
- conversation_prompt = self.conversation.gen_complete_prompt(prompt)
164
- if optimizer:
165
- if optimizer in self.__available_optimizers:
166
- conversation_prompt = getattr(Optimizers, optimizer)(
167
- conversation_prompt if conversationally else prompt
168
- )
169
- else:
170
- raise Exception(
171
- f"Optimizer is not one of {self.__available_optimizers}"
172
- )
173
-
174
- trace_id = str(uuid4())
175
- conversation_turn_id = str(uuid4())
176
-
177
- # Current timestamp in ISO format for traceId
178
- current_time = datetime.datetime.now().isoformat()
179
-
180
- # Updated query parameters to match the new API format
181
- params = {
182
- "page": 1,
183
- "count": 10,
184
- "safeSearch": "Moderate",
185
- "mkt": "en-IN",
186
- "enable_worklow_generation_ux": "true",
187
- "domain": "youchat",
188
- "use_personalization_extraction": "true",
189
- "queryTraceId": trace_id,
190
- "chatId": trace_id,
191
- "conversationTurnId": conversation_turn_id,
192
- "pastChatLength": len(self.conversation.history) if hasattr(self.conversation, "history") else 0,
193
- "selectedChatMode": "custom",
194
- "selectedAiModel": self.model,
195
- # "enable_agent_clarification_questions": "true",
196
- "traceId": f"{trace_id}|{conversation_turn_id}|{current_time}",
197
- "use_nested_youchat_updates": "true"
198
- }
199
-
200
- # New payload format is JSON
201
- payload = {
202
- "query": conversation_prompt,
203
- "chat": "[]"
204
- }
205
-
206
- def for_stream():
207
- response = self.session.post(
208
- self.chat_endpoint,
209
- headers=self.headers,
210
- cookies=self.cookies,
211
- params=params,
212
- data=json.dumps(payload),
213
- stream=True,
214
- timeout=self.timeout
215
- )
216
- if not response.ok:
217
- raise exceptions.FailedToGenerateResponseError(
218
- f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
219
- )
220
-
221
- streaming_text = ""
222
- # New SSE event-based parsing
223
- event_type = None
224
- for value in response.iter_lines(
225
- decode_unicode=True,
226
- chunk_size=self.stream_chunk_size,
227
- delimiter="\n",
228
- ):
229
- if not value:
230
- continue
231
- if value.startswith("event: "):
232
- event_type = value[7:].strip()
233
- continue
234
- if value.startswith("data: "):
235
- data_str = value[6:]
236
- if event_type == "youChatToken":
237
- try:
238
- data = json.loads(data_str)
239
- token = data.get("youChatToken", "")
240
- if token:
241
- streaming_text += token
242
- yield token if raw else dict(text=token)
243
- except Exception:
244
- pass
245
- # Reset event_type after processing
246
- event_type = None
247
-
248
- self.last_response.update(dict(text=streaming_text))
249
- self.conversation.update_chat_history(
250
- prompt, self.get_message(self.last_response)
251
- )
252
-
253
- def for_non_stream():
254
- for _ in for_stream():
255
- pass
256
- return self.last_response
257
-
258
- return for_stream() if stream else for_non_stream()
259
-
260
- def chat(
261
- self,
262
- prompt: str,
263
- stream: bool = False,
264
- optimizer: str = None,
265
- conversationally: bool = False,
266
- ) -> str:
267
- """Generate response `str`
268
- Args:
269
- prompt (str): Prompt to be send.
270
- stream (bool, optional): Flag for streaming response. Defaults to False.
271
- optimizer (str, optional): Prompt optimizer name - `[code, shell_command]`. Defaults to None.
272
- conversationally (bool, optional): Chat conversationally when using optimizer. Defaults to False.
273
- Returns:
274
- str: Response generated
275
- """
276
-
277
- def for_stream():
278
- for response in self.ask(
279
- prompt, True, optimizer=optimizer, conversationally=conversationally
280
- ):
281
- yield self.get_message(response)
282
-
283
- def for_non_stream():
284
- return self.get_message(
285
- self.ask(
286
- prompt,
287
- False,
288
- optimizer=optimizer,
289
- conversationally=conversationally,
290
- )
291
- )
292
-
293
- return for_stream() if stream else for_non_stream()
294
-
295
- def get_message(self, response: dict) -> str:
296
- """Retrieves message only from response
297
-
298
- str: Message extracted
299
- """
300
- assert isinstance(response, dict), "Response should be of dict data-type only"
301
- return response["text"]
302
-
303
- if __name__ == '__main__':
304
- print("-" * 80)
305
- print(f"{'Model':<50} {'Status':<10} {'Response'}")
306
- print("-" * 80)
307
-
308
- # Test all available models
309
- working = 0
310
- total = len(YouChat.AVAILABLE_MODELS)
311
-
312
- for model in YouChat.AVAILABLE_MODELS:
313
- try:
314
- test_ai = YouChat(model=model, timeout=60)
315
- response = test_ai.chat("Say 'Hello' in one word", stream=True)
316
- response_text = ""
317
- for chunk in response:
318
- response_text += chunk
319
- print(f"\r{model:<50} {'Testing...':<10}", end="", flush=True)
320
-
321
- if response_text and len(response_text.strip()) > 0:
322
- status = "✓"
323
- # Truncate response if too long
324
- display_text = response_text.strip()[:50] + "..." if len(response_text.strip()) > 50 else response_text.strip()
325
- else:
326
- status = "✗"
327
- display_text = "Empty or invalid response"
328
- print(f"\r{model:<50} {status:<10} {display_text}")
329
- except Exception as e:
330
- print(f"\r{model:<50} {'✗':<10} {str(e)}")
1
+ import datetime
2
+ import json
3
+ from typing import Any, Generator, Optional, Union, cast
4
+ from uuid import uuid4
5
+
6
+ import cloudscraper
7
+
8
+ from webscout import exceptions
9
+ from webscout.AIbase import Provider, Response
10
+ from webscout.AIutel import AwesomePrompts, Conversation, Optimizers
11
+
12
+
13
+ class YouChat(Provider):
14
+ """
15
+ This class provides methods for interacting with the You.com chat API in a consistent provider structure.
16
+ """
17
+
18
+ # Updated available models based on latest aiModels list
19
+ # All models with isProOnly: false are included
20
+ AVAILABLE_MODELS = [
21
+ # ProOnly models (not available without subscription)
22
+ # "gpt_4_5_preview", # isProOnly: true
23
+ # "openai_o3_mini_high", # isProOnly: true
24
+ # "openai_o3_mini_medium", # isProOnly: true
25
+ # "openai_o1", # isProOnly: true
26
+ # "openai_o1_preview", # isProOnly: true
27
+ # "openai_o1_mini", # isProOnly: true
28
+ # "gpt_4", # isProOnly: true
29
+ # "claude_3_7_sonnet_thinking", # isProOnly: true
30
+ # "claude_3_7_sonnet", # isProOnly: true
31
+ # "claude_3_5_sonnet", # isProOnly: true
32
+ # "claude_3_opus", # isProOnly: true
33
+ # "qwq_32b", # isProOnly: true
34
+ # "deepseek_r1", # isProOnly: true
35
+ # "deepseek_v3", # isProOnly: true
36
+ # "gemini_2_5_pro_experimental", # isProOnly: true
37
+
38
+ # Free models (isProOnly: false)
39
+ "gpt_4o_mini",
40
+ "gpt_4o",
41
+ "gpt_4_turbo",
42
+ "claude_3_sonnet",
43
+ "claude_3_5_haiku",
44
+ "qwen2p5_72b",
45
+ "qwen2p5_coder_32b",
46
+ "gemini_2_flash",
47
+ "gemini_1_5_flash",
48
+ "gemini_1_5_pro",
49
+ "grok_2",
50
+ "llama4_maverick",
51
+ "llama4_scout",
52
+ "llama3_1_405b",
53
+ "mistral_large_2",
54
+ "command_r_plus",
55
+
56
+ # Free models not enabled for user chat modes
57
+ "llama3_3_70b", # isAllowedForUserChatModes: false
58
+ "llama3_2_90b", # isAllowedForUserChatModes: false
59
+ "databricks_dbrx_instruct", # isAllowedForUserChatModes: false
60
+ "solar_1_mini", # isAllowedForUserChatModes: false
61
+ "dolphin_2_5", # isAllowedForUserChatModes: false, isUncensoredModel: true
62
+ ]
63
+
64
+ def __init__(
65
+ self,
66
+ is_conversation: bool = True,
67
+ max_tokens: int = 600,
68
+ timeout: int = 30,
69
+ intro: Optional[str] = None,
70
+ filepath: Optional[str] = None,
71
+ update_file: bool = True,
72
+ proxies: dict = {},
73
+ history_offset: int = 10250,
74
+ act: Optional[str] = None,
75
+ model: str = "gemini_2_flash",
76
+ ):
77
+ """Instantiates YouChat
78
+
79
+ Args:
80
+ is_conversation (bool, optional): Flag for chatting conversationally. Defaults to True.
81
+ max_tokens (int, optional): Maximum number of tokens to be generated upon completion. Defaults to 600.
82
+ timeout (int, optional): Http request timeout. Defaults to 30.
83
+ intro (str, optional): Conversation introductory prompt. Defaults to None.
84
+ filepath (str, optional): Path to file containing conversation history. Defaults to None.
85
+ update_file (bool, optional): Add new prompts and responses to the file. Defaults to True.
86
+ proxies (dict, optional): Http request proxies. Defaults to {}.
87
+ history_offset (int, optional): Limit conversation history to this number of last texts. Defaults to 10250.
88
+ act (str|int, optional): Awesome prompt key or index. (Used as intro). Defaults to None.
89
+ model (str, optional): Model to use. Defaults to "gemini_2_flash".
90
+ """
91
+ if model not in self.AVAILABLE_MODELS:
92
+ raise ValueError(f"Invalid model: {model}. Choose from: {self.AVAILABLE_MODELS}")
93
+
94
+ self.session = cloudscraper.create_scraper() # Create a Cloudscraper session
95
+ self.is_conversation = is_conversation
96
+ self.max_tokens_to_sample = max_tokens
97
+ self.chat_endpoint = "https://you.com/api/streamingSearch"
98
+ self.stream_chunk_size = 64
99
+ self.timeout = timeout
100
+ self.last_response = {}
101
+ self.model = model
102
+ self.headers = {
103
+ "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36 Edg/135.0.0.0",
104
+ "Accept": "text/event-stream",
105
+ "Accept-Language": "en-US,en;q=0.9,en-IN;q=0.8",
106
+ "Referer": "https://you.com/search?q=hi&fromSearchBar=true&tbm=youchat",
107
+ "Connection": "keep-alive",
108
+ "DNT": "1",
109
+ "Content-Type": "text/plain;charset=UTF-8",
110
+ }
111
+ self.cookies = {
112
+ "uuid_guest": uuid4().hex,
113
+ "uuid_guest_backup": uuid4().hex,
114
+ "youchat_personalization": "true",
115
+ "youchat_smart_learn": "true",
116
+ "youpro_subscription": "false",
117
+ "you_subscription": "freemium",
118
+ "safesearch_guest": "Moderate",
119
+ "__cf_bm": uuid4().hex,
120
+ }
121
+
122
+ self.__available_optimizers = (
123
+ method
124
+ for method in dir(Optimizers)
125
+ if callable(getattr(Optimizers, method)) and not method.startswith("__")
126
+ )
127
+ self.conversation = Conversation(
128
+ is_conversation, self.max_tokens_to_sample, filepath, update_file
129
+ )
130
+ act_prompt = (
131
+ AwesomePrompts().get_act(cast(Union[str, int], act), default=None, case_insensitive=True
132
+ )
133
+ if act
134
+ else intro
135
+ )
136
+ if act_prompt:
137
+ self.conversation.intro = act_prompt
138
+ self.conversation.history_offset = history_offset
139
+ if proxies:
140
+ self.session.proxies.update(proxies)
141
+
142
+ def ask(
143
+ self,
144
+ prompt: str,
145
+ stream: bool = False,
146
+ raw: bool = False,
147
+ optimizer: Optional[str] = None,
148
+ conversationally: bool = False,
149
+ **kwargs: Any,
150
+ ) -> dict:
151
+ """Chat with AI
152
+
153
+ Args:
154
+ prompt (str): Prompt to be send.
155
+ stream (bool, optional): Flag for streaming response. Defaults to False.
156
+ raw (bool, optional): Stream back raw response as received. Defaults to False.
157
+ optimizer (str, optional): Prompt optimizer name - `[code, shell_command]`. Defaults to None.
158
+ conversationally (bool, optional): Chat conversationally when using optimizer. Defaults to None.
159
+ **kwargs: Additional keyword arguments.
160
+ Returns:
161
+ dict : {}
162
+ ```json
163
+ {
164
+ "text" : "How may I assist you today?"
165
+ }
166
+ ```
167
+ """
168
+ conversation_prompt = self.conversation.gen_complete_prompt(prompt)
169
+ if optimizer:
170
+ if optimizer in self.__available_optimizers:
171
+ conversation_prompt = getattr(Optimizers, optimizer)(
172
+ conversation_prompt if conversationally else prompt
173
+ )
174
+ else:
175
+ raise Exception(
176
+ f"Optimizer is not one of {self.__available_optimizers}"
177
+ )
178
+
179
+ trace_id = str(uuid4())
180
+ conversation_turn_id = str(uuid4())
181
+
182
+ # Current timestamp in ISO format for traceId
183
+ current_time = datetime.datetime.now().isoformat()
184
+
185
+ # Updated query parameters to match the new API format
186
+ params = {
187
+ "page": 1,
188
+ "count": 10,
189
+ "safeSearch": "Moderate",
190
+ "mkt": "en-IN",
191
+ "enable_worklow_generation_ux": "true",
192
+ "domain": "youchat",
193
+ "use_personalization_extraction": "true",
194
+ "queryTraceId": trace_id,
195
+ "chatId": trace_id,
196
+ "conversationTurnId": conversation_turn_id,
197
+ "pastChatLength": len(self.conversation.history) if hasattr(self.conversation, "history") else 0,
198
+ "selectedChatMode": "custom",
199
+ "selectedAiModel": self.model,
200
+ # "enable_agent_clarification_questions": "true",
201
+ "traceId": f"{trace_id}|{conversation_turn_id}|{current_time}",
202
+ "use_nested_youchat_updates": "true"
203
+ }
204
+
205
+ # New payload format is JSON
206
+ payload = {
207
+ "query": conversation_prompt,
208
+ "chat": "[]"
209
+ }
210
+
211
+ def for_stream():
212
+ response = self.session.post(
213
+ self.chat_endpoint,
214
+ headers=self.headers,
215
+ cookies=self.cookies,
216
+ params=params,
217
+ data=json.dumps(payload),
218
+ stream=True,
219
+ timeout=self.timeout
220
+ )
221
+ if not response.ok:
222
+ raise exceptions.FailedToGenerateResponseError(
223
+ f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
224
+ )
225
+
226
+ streaming_text = ""
227
+ # New SSE event-based parsing
228
+ event_type = None
229
+ for value in response.iter_lines(
230
+ decode_unicode=True,
231
+ chunk_size=self.stream_chunk_size,
232
+ delimiter="\n",
233
+ ):
234
+ if not value:
235
+ continue
236
+ if value.startswith("event: "):
237
+ event_type = value[7:].strip()
238
+ continue
239
+ if value.startswith("data: "):
240
+ data_str = value[6:]
241
+ if event_type == "youChatToken":
242
+ try:
243
+ data = json.loads(data_str)
244
+ token = data.get("youChatToken", "")
245
+ if token:
246
+ streaming_text += token
247
+ yield token if raw else dict(text=token)
248
+ except Exception:
249
+ pass
250
+ # Reset event_type after processing
251
+ event_type = None
252
+
253
+ self.last_response.update(dict(text=streaming_text))
254
+ self.conversation.update_chat_history(
255
+ prompt, self.get_message(self.last_response)
256
+ )
257
+
258
+ def for_non_stream():
259
+ for _ in for_stream():
260
+ pass
261
+ return self.last_response if not raw else json.dumps(self.last_response)
262
+
263
+ return for_stream() if stream else for_non_stream()
264
+
265
+ def chat(
266
+ self,
267
+ prompt: str,
268
+ stream: bool = False,
269
+ optimizer: Optional[str] = None,
270
+ conversationally: bool = False,
271
+ raw: bool = False,
272
+ **kwargs: Any,
273
+ ) -> Union[str, Generator[str, None, None]]:
274
+ """Generate response `str`
275
+ Args:
276
+ prompt (str): Prompt to be send.
277
+ stream (bool, optional): Flag for streaming response. Defaults to False.
278
+ optimizer (str, optional): Prompt optimizer name - `[code, shell_command]`. Defaults to None.
279
+ conversationally (bool, optional): Chat conversationally when using optimizer. Defaults to False.
280
+ raw (bool, optional): Return raw response chunks. Defaults to False.
281
+ **kwargs: Additional keyword arguments.
282
+ Returns:
283
+ str: Response generated
284
+ """
285
+
286
+ def for_stream():
287
+ for response in self.ask(
288
+ prompt, True, raw=raw, optimizer=optimizer, conversationally=conversationally
289
+ ):
290
+ if raw:
291
+ yield response
292
+ else:
293
+ yield self.get_message(response)
294
+
295
+ def for_non_stream():
296
+ result = self.ask(
297
+ prompt,
298
+ False,
299
+ raw=raw,
300
+ optimizer=optimizer,
301
+ conversationally=conversationally,
302
+ )
303
+ if raw:
304
+ return result
305
+ return self.get_message(result)
306
+
307
+ return for_stream() if stream else for_non_stream()
308
+
309
+ def get_message(self, response: Response) -> str:
310
+ """Retrieves message only from response
311
+
312
+ str: Message extracted
313
+ """
314
+ if isinstance(response, str):
315
+ return response
316
+ if isinstance(response, dict):
317
+ return dict(response)["text"]
318
+ return str(response)
319
+
320
+ if __name__ == '__main__':
321
+ print("-" * 80)
322
+ print(f"{'Model':<50} {'Status':<10} {'Response'}")
323
+ print("-" * 80)
324
+
325
+ # Test all available models
326
+ working = 0
327
+ total = len(YouChat.AVAILABLE_MODELS)
328
+
329
+ for model in YouChat.AVAILABLE_MODELS:
330
+ try:
331
+ test_ai = YouChat(model=model, timeout=60)
332
+ response = test_ai.chat("Say 'Hello' in one word", stream=True)
333
+ response_text = ""
334
+ for chunk in response:
335
+ response_text += chunk
336
+ print(f"\r{model:<50} {'Testing...':<10}", end="", flush=True)
337
+
338
+ if response_text and len(response_text.strip()) > 0:
339
+ status = "✓"
340
+ # Truncate response if too long
341
+ display_text = response_text.strip()[:50] + "..." if len(response_text.strip()) > 50 else response_text.strip()
342
+ else:
343
+ status = "✗"
344
+ display_text = "Empty or invalid response"
345
+ print(f"\r{model:<50} {status:<10} {display_text}")
346
+ except Exception as e:
347
+ print(f"\r{model:<50} {'✗':<10} {str(e)}")