webscout 8.2.2__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 (483) hide show
  1. webscout/AIauto.py +524 -143
  2. webscout/AIbase.py +247 -123
  3. webscout/AIutel.py +68 -132
  4. webscout/Bard.py +1072 -535
  5. webscout/Extra/GitToolkit/__init__.py +2 -2
  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 -0
  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 -0
  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 -45
  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 +189 -18
  35. webscout/Extra/__init__.py +2 -3
  36. webscout/Extra/gguf.py +1298 -682
  37. webscout/Extra/tempmail/README.md +488 -0
  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 +237 -304
  49. webscout/Provider/AISEARCH/README.md +106 -0
  50. webscout/Provider/AISEARCH/__init__.py +16 -10
  51. webscout/Provider/AISEARCH/brave_search.py +298 -0
  52. webscout/Provider/AISEARCH/iask_search.py +130 -209
  53. webscout/Provider/AISEARCH/monica_search.py +200 -246
  54. webscout/Provider/AISEARCH/webpilotai_search.py +242 -281
  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 -0
  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 +343 -173
  64. webscout/Provider/EssentialAI.py +217 -0
  65. webscout/Provider/ExaAI.py +274 -261
  66. webscout/Provider/Gemini.py +60 -54
  67. webscout/Provider/GithubChat.py +385 -367
  68. webscout/Provider/Gradient.py +286 -0
  69. webscout/Provider/Groq.py +556 -670
  70. webscout/Provider/HadadXYZ.py +323 -0
  71. webscout/Provider/HeckAI.py +392 -233
  72. webscout/Provider/HuggingFace.py +387 -0
  73. webscout/Provider/IBM.py +340 -0
  74. webscout/Provider/Jadve.py +317 -266
  75. webscout/Provider/K2Think.py +306 -0
  76. webscout/Provider/Koboldai.py +221 -381
  77. webscout/Provider/Netwrck.py +273 -228
  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 -0
  83. webscout/Provider/OPENAI/TogetherAI.py +405 -0
  84. webscout/Provider/OPENAI/TwoAI.py +255 -0
  85. webscout/Provider/OPENAI/__init__.py +148 -25
  86. webscout/Provider/OPENAI/ai4chat.py +348 -0
  87. webscout/Provider/OPENAI/akashgpt.py +436 -0
  88. webscout/Provider/OPENAI/algion.py +303 -0
  89. webscout/Provider/OPENAI/ayle.py +365 -0
  90. webscout/Provider/OPENAI/base.py +253 -46
  91. webscout/Provider/OPENAI/cerebras.py +296 -0
  92. webscout/Provider/OPENAI/chatgpt.py +514 -193
  93. webscout/Provider/OPENAI/chatsandbox.py +233 -0
  94. webscout/Provider/OPENAI/deepinfra.py +403 -272
  95. webscout/Provider/OPENAI/e2b.py +2370 -1350
  96. webscout/Provider/OPENAI/elmo.py +278 -0
  97. webscout/Provider/OPENAI/exaai.py +186 -138
  98. webscout/Provider/OPENAI/freeassist.py +446 -0
  99. webscout/Provider/OPENAI/gradient.py +448 -0
  100. webscout/Provider/OPENAI/groq.py +380 -0
  101. webscout/Provider/OPENAI/hadadxyz.py +292 -0
  102. webscout/Provider/OPENAI/heckai.py +100 -104
  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 -327
  107. webscout/Provider/OPENAI/meta.py +541 -0
  108. webscout/Provider/OPENAI/netwrck.py +110 -84
  109. webscout/Provider/OPENAI/nvidia.py +317 -0
  110. webscout/Provider/OPENAI/oivscode.py +348 -0
  111. webscout/Provider/OPENAI/openrouter.py +328 -0
  112. webscout/Provider/OPENAI/pydantic_imports.py +1 -0
  113. webscout/Provider/OPENAI/sambanova.py +397 -0
  114. webscout/Provider/OPENAI/sonus.py +126 -115
  115. webscout/Provider/OPENAI/textpollinations.py +218 -133
  116. webscout/Provider/OPENAI/toolbaz.py +136 -166
  117. webscout/Provider/OPENAI/typefully.py +419 -0
  118. webscout/Provider/OPENAI/typliai.py +279 -0
  119. webscout/Provider/OPENAI/utils.py +314 -211
  120. webscout/Provider/OPENAI/wisecat.py +103 -125
  121. webscout/Provider/OPENAI/writecream.py +185 -156
  122. webscout/Provider/OPENAI/x0gpt.py +227 -136
  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 -344
  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 -0
  133. webscout/Provider/TTI/__init__.py +37 -12
  134. webscout/Provider/TTI/base.py +147 -0
  135. webscout/Provider/TTI/claudeonline.py +393 -0
  136. webscout/Provider/TTI/magicstudio.py +292 -0
  137. webscout/Provider/TTI/miragic.py +180 -0
  138. webscout/Provider/TTI/pollinations.py +331 -0
  139. webscout/Provider/TTI/together.py +334 -0
  140. webscout/Provider/TTI/utils.py +14 -0
  141. webscout/Provider/TTS/README.md +186 -0
  142. webscout/Provider/TTS/__init__.py +43 -7
  143. webscout/Provider/TTS/base.py +523 -0
  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 -0
  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 -180
  153. webscout/Provider/TTS/streamElements.py +275 -333
  154. webscout/Provider/TTS/utils.py +280 -280
  155. webscout/Provider/TextPollinationsAI.py +221 -121
  156. webscout/Provider/TogetherAI.py +450 -0
  157. webscout/Provider/TwoAI.py +309 -199
  158. webscout/Provider/TypliAI.py +311 -0
  159. webscout/Provider/UNFINISHED/ChatHub.py +219 -0
  160. webscout/Provider/{OPENAI/glider.py → UNFINISHED/ChutesAI.py} +160 -145
  161. webscout/Provider/UNFINISHED/GizAI.py +300 -0
  162. webscout/Provider/UNFINISHED/Marcus.py +218 -0
  163. webscout/Provider/UNFINISHED/Qodo.py +481 -0
  164. webscout/Provider/UNFINISHED/XenAI.py +330 -0
  165. webscout/Provider/{Youchat.py → UNFINISHED/Youchat.py} +64 -47
  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 -0
  170. webscout/Provider/UNFINISHED/samurai.py +231 -0
  171. webscout/Provider/WiseCat.py +256 -196
  172. webscout/Provider/WrDoChat.py +390 -0
  173. webscout/Provider/__init__.py +115 -198
  174. webscout/Provider/ai4chat.py +181 -202
  175. webscout/Provider/akashgpt.py +330 -342
  176. webscout/Provider/cerebras.py +397 -242
  177. webscout/Provider/cleeai.py +236 -213
  178. webscout/Provider/elmo.py +291 -234
  179. webscout/Provider/geminiapi.py +343 -208
  180. webscout/Provider/julius.py +245 -223
  181. webscout/Provider/learnfastai.py +333 -266
  182. webscout/Provider/llama3mitril.py +230 -180
  183. webscout/Provider/llmchat.py +308 -213
  184. webscout/Provider/llmchatco.py +321 -311
  185. webscout/Provider/meta.py +996 -794
  186. webscout/Provider/oivscode.py +332 -0
  187. webscout/Provider/searchchat.py +316 -293
  188. webscout/Provider/sonus.py +264 -208
  189. webscout/Provider/toolbaz.py +359 -320
  190. webscout/Provider/turboseek.py +332 -219
  191. webscout/Provider/typefully.py +262 -280
  192. webscout/Provider/x0gpt.py +332 -256
  193. webscout/__init__.py +31 -38
  194. webscout/__main__.py +5 -5
  195. webscout/cli.py +585 -293
  196. webscout/client.py +1497 -0
  197. webscout/conversation.py +140 -565
  198. webscout/exceptions.py +383 -339
  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 +32 -378
  204. webscout/prompt_manager.py +376 -274
  205. webscout/sanitize.py +1514 -0
  206. webscout/scout/README.md +452 -0
  207. webscout/scout/__init__.py +8 -8
  208. webscout/scout/core/__init__.py +7 -7
  209. webscout/scout/core/crawler.py +330 -140
  210. webscout/scout/core/scout.py +800 -568
  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 -460
  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 -809
  284. webscout/swiftcli/core/__init__.py +7 -0
  285. webscout/swiftcli/core/cli.py +574 -0
  286. webscout/swiftcli/core/context.py +98 -0
  287. webscout/swiftcli/core/group.py +268 -0
  288. webscout/swiftcli/decorators/__init__.py +28 -0
  289. webscout/swiftcli/decorators/command.py +243 -0
  290. webscout/swiftcli/decorators/options.py +247 -0
  291. webscout/swiftcli/decorators/output.py +392 -0
  292. webscout/swiftcli/exceptions.py +21 -0
  293. webscout/swiftcli/plugins/__init__.py +9 -0
  294. webscout/swiftcli/plugins/base.py +134 -0
  295. webscout/swiftcli/plugins/manager.py +269 -0
  296. webscout/swiftcli/utils/__init__.py +58 -0
  297. webscout/swiftcli/utils/formatting.py +251 -0
  298. webscout/swiftcli/utils/parsing.py +368 -0
  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 -55
  304. webscout/zeroart/base.py +70 -60
  305. webscout/zeroart/effects.py +155 -99
  306. webscout/zeroart/fonts.py +1799 -816
  307. webscout-2026.1.19.dist-info/METADATA +638 -0
  308. webscout-2026.1.19.dist-info/RECORD +312 -0
  309. {webscout-8.2.2.dist-info → webscout-2026.1.19.dist-info}/WHEEL +1 -1
  310. webscout-2026.1.19.dist-info/entry_points.txt +4 -0
  311. webscout-2026.1.19.dist-info/top_level.txt +1 -0
  312. inferno/__init__.py +0 -6
  313. inferno/__main__.py +0 -9
  314. inferno/cli.py +0 -6
  315. webscout/DWEBS.py +0 -477
  316. webscout/Extra/autocoder/__init__.py +0 -9
  317. webscout/Extra/autocoder/autocoder.py +0 -849
  318. webscout/Extra/autocoder/autocoder_utiles.py +0 -332
  319. webscout/LLM.py +0 -442
  320. webscout/Litlogger/__init__.py +0 -67
  321. webscout/Litlogger/core/__init__.py +0 -6
  322. webscout/Litlogger/core/level.py +0 -23
  323. webscout/Litlogger/core/logger.py +0 -165
  324. webscout/Litlogger/handlers/__init__.py +0 -12
  325. webscout/Litlogger/handlers/console.py +0 -33
  326. webscout/Litlogger/handlers/file.py +0 -143
  327. webscout/Litlogger/handlers/network.py +0 -173
  328. webscout/Litlogger/styles/__init__.py +0 -7
  329. webscout/Litlogger/styles/colors.py +0 -249
  330. webscout/Litlogger/styles/formats.py +0 -458
  331. webscout/Litlogger/styles/text.py +0 -87
  332. webscout/Litlogger/utils/__init__.py +0 -6
  333. webscout/Litlogger/utils/detectors.py +0 -153
  334. webscout/Litlogger/utils/formatters.py +0 -200
  335. webscout/Local/__init__.py +0 -12
  336. webscout/Local/__main__.py +0 -9
  337. webscout/Local/api.py +0 -576
  338. webscout/Local/cli.py +0 -516
  339. webscout/Local/config.py +0 -75
  340. webscout/Local/llm.py +0 -287
  341. webscout/Local/model_manager.py +0 -253
  342. webscout/Local/server.py +0 -721
  343. webscout/Local/utils.py +0 -93
  344. webscout/Provider/AI21.py +0 -177
  345. webscout/Provider/AISEARCH/DeepFind.py +0 -250
  346. webscout/Provider/AISEARCH/ISou.py +0 -256
  347. webscout/Provider/AISEARCH/felo_search.py +0 -228
  348. webscout/Provider/AISEARCH/genspark_search.py +0 -208
  349. webscout/Provider/AISEARCH/hika_search.py +0 -194
  350. webscout/Provider/AISEARCH/scira_search.py +0 -324
  351. webscout/Provider/Aitopia.py +0 -292
  352. webscout/Provider/AllenAI.py +0 -413
  353. webscout/Provider/Blackboxai.py +0 -229
  354. webscout/Provider/C4ai.py +0 -432
  355. webscout/Provider/ChatGPTClone.py +0 -226
  356. webscout/Provider/ChatGPTES.py +0 -237
  357. webscout/Provider/ChatGPTGratis.py +0 -194
  358. webscout/Provider/Chatify.py +0 -175
  359. webscout/Provider/Cloudflare.py +0 -273
  360. webscout/Provider/DeepSeek.py +0 -196
  361. webscout/Provider/ElectronHub.py +0 -709
  362. webscout/Provider/ExaChat.py +0 -342
  363. webscout/Provider/Free2GPT.py +0 -241
  364. webscout/Provider/GPTWeb.py +0 -193
  365. webscout/Provider/Glider.py +0 -211
  366. webscout/Provider/HF_space/__init__.py +0 -0
  367. webscout/Provider/HF_space/qwen_qwen2.py +0 -206
  368. webscout/Provider/HuggingFaceChat.py +0 -462
  369. webscout/Provider/Hunyuan.py +0 -272
  370. webscout/Provider/LambdaChat.py +0 -392
  371. webscout/Provider/Llama.py +0 -200
  372. webscout/Provider/Llama3.py +0 -204
  373. webscout/Provider/Marcus.py +0 -148
  374. webscout/Provider/OLLAMA.py +0 -396
  375. webscout/Provider/OPENAI/c4ai.py +0 -367
  376. webscout/Provider/OPENAI/chatgptclone.py +0 -460
  377. webscout/Provider/OPENAI/exachat.py +0 -433
  378. webscout/Provider/OPENAI/freeaichat.py +0 -352
  379. webscout/Provider/OPENAI/opkfc.py +0 -488
  380. webscout/Provider/OPENAI/scirachat.py +0 -463
  381. webscout/Provider/OPENAI/standardinput.py +0 -425
  382. webscout/Provider/OPENAI/typegpt.py +0 -346
  383. webscout/Provider/OPENAI/uncovrAI.py +0 -455
  384. webscout/Provider/OPENAI/venice.py +0 -413
  385. webscout/Provider/OPENAI/yep.py +0 -327
  386. webscout/Provider/OpenGPT.py +0 -199
  387. webscout/Provider/Perplexitylabs.py +0 -415
  388. webscout/Provider/Phind.py +0 -535
  389. webscout/Provider/PizzaGPT.py +0 -198
  390. webscout/Provider/Reka.py +0 -214
  391. webscout/Provider/StandardInput.py +0 -278
  392. webscout/Provider/TTI/AiForce/__init__.py +0 -22
  393. webscout/Provider/TTI/AiForce/async_aiforce.py +0 -224
  394. webscout/Provider/TTI/AiForce/sync_aiforce.py +0 -245
  395. webscout/Provider/TTI/FreeAIPlayground/__init__.py +0 -9
  396. webscout/Provider/TTI/FreeAIPlayground/async_freeaiplayground.py +0 -181
  397. webscout/Provider/TTI/FreeAIPlayground/sync_freeaiplayground.py +0 -180
  398. webscout/Provider/TTI/ImgSys/__init__.py +0 -23
  399. webscout/Provider/TTI/ImgSys/async_imgsys.py +0 -202
  400. webscout/Provider/TTI/ImgSys/sync_imgsys.py +0 -195
  401. webscout/Provider/TTI/MagicStudio/__init__.py +0 -2
  402. webscout/Provider/TTI/MagicStudio/async_magicstudio.py +0 -111
  403. webscout/Provider/TTI/MagicStudio/sync_magicstudio.py +0 -109
  404. webscout/Provider/TTI/Nexra/__init__.py +0 -22
  405. webscout/Provider/TTI/Nexra/async_nexra.py +0 -286
  406. webscout/Provider/TTI/Nexra/sync_nexra.py +0 -258
  407. webscout/Provider/TTI/PollinationsAI/__init__.py +0 -23
  408. webscout/Provider/TTI/PollinationsAI/async_pollinations.py +0 -311
  409. webscout/Provider/TTI/PollinationsAI/sync_pollinations.py +0 -265
  410. webscout/Provider/TTI/aiarta/__init__.py +0 -2
  411. webscout/Provider/TTI/aiarta/async_aiarta.py +0 -482
  412. webscout/Provider/TTI/aiarta/sync_aiarta.py +0 -440
  413. webscout/Provider/TTI/artbit/__init__.py +0 -22
  414. webscout/Provider/TTI/artbit/async_artbit.py +0 -155
  415. webscout/Provider/TTI/artbit/sync_artbit.py +0 -148
  416. webscout/Provider/TTI/fastflux/__init__.py +0 -22
  417. webscout/Provider/TTI/fastflux/async_fastflux.py +0 -261
  418. webscout/Provider/TTI/fastflux/sync_fastflux.py +0 -252
  419. webscout/Provider/TTI/huggingface/__init__.py +0 -22
  420. webscout/Provider/TTI/huggingface/async_huggingface.py +0 -199
  421. webscout/Provider/TTI/huggingface/sync_huggingface.py +0 -195
  422. webscout/Provider/TTI/piclumen/__init__.py +0 -23
  423. webscout/Provider/TTI/piclumen/async_piclumen.py +0 -268
  424. webscout/Provider/TTI/piclumen/sync_piclumen.py +0 -233
  425. webscout/Provider/TTI/pixelmuse/__init__.py +0 -4
  426. webscout/Provider/TTI/pixelmuse/async_pixelmuse.py +0 -249
  427. webscout/Provider/TTI/pixelmuse/sync_pixelmuse.py +0 -182
  428. webscout/Provider/TTI/talkai/__init__.py +0 -4
  429. webscout/Provider/TTI/talkai/async_talkai.py +0 -229
  430. webscout/Provider/TTI/talkai/sync_talkai.py +0 -207
  431. webscout/Provider/TTS/gesserit.py +0 -127
  432. webscout/Provider/TeachAnything.py +0 -187
  433. webscout/Provider/Venice.py +0 -219
  434. webscout/Provider/VercelAI.py +0 -234
  435. webscout/Provider/WebSim.py +0 -228
  436. webscout/Provider/Writecream.py +0 -211
  437. webscout/Provider/WritingMate.py +0 -197
  438. webscout/Provider/aimathgpt.py +0 -189
  439. webscout/Provider/askmyai.py +0 -158
  440. webscout/Provider/asksteve.py +0 -203
  441. webscout/Provider/bagoodex.py +0 -145
  442. webscout/Provider/chatglm.py +0 -205
  443. webscout/Provider/copilot.py +0 -428
  444. webscout/Provider/freeaichat.py +0 -271
  445. webscout/Provider/gaurish.py +0 -244
  446. webscout/Provider/geminiprorealtime.py +0 -160
  447. webscout/Provider/granite.py +0 -187
  448. webscout/Provider/hermes.py +0 -219
  449. webscout/Provider/koala.py +0 -268
  450. webscout/Provider/labyrinth.py +0 -340
  451. webscout/Provider/lepton.py +0 -194
  452. webscout/Provider/llamatutor.py +0 -192
  453. webscout/Provider/multichat.py +0 -325
  454. webscout/Provider/promptrefine.py +0 -193
  455. webscout/Provider/scira_chat.py +0 -277
  456. webscout/Provider/scnet.py +0 -187
  457. webscout/Provider/talkai.py +0 -194
  458. webscout/Provider/tutorai.py +0 -252
  459. webscout/Provider/typegpt.py +0 -232
  460. webscout/Provider/uncovr.py +0 -312
  461. webscout/Provider/yep.py +0 -376
  462. webscout/litprinter/__init__.py +0 -59
  463. webscout/scout/core.py +0 -881
  464. webscout/tempid.py +0 -128
  465. webscout/webscout_search.py +0 -1346
  466. webscout/webscout_search_async.py +0 -877
  467. webscout/yep_search.py +0 -297
  468. webscout-8.2.2.dist-info/METADATA +0 -734
  469. webscout-8.2.2.dist-info/RECORD +0 -309
  470. webscout-8.2.2.dist-info/entry_points.txt +0 -5
  471. webscout-8.2.2.dist-info/top_level.txt +0 -3
  472. webstoken/__init__.py +0 -30
  473. webstoken/classifier.py +0 -189
  474. webstoken/keywords.py +0 -216
  475. webstoken/language.py +0 -128
  476. webstoken/ner.py +0 -164
  477. webstoken/normalizer.py +0 -35
  478. webstoken/processor.py +0 -77
  479. webstoken/sentiment.py +0 -206
  480. webstoken/stemmer.py +0 -73
  481. webstoken/tagger.py +0 -60
  482. webstoken/tokenizer.py +0 -158
  483. {webscout-8.2.2.dist-info → webscout-2026.1.19.dist-info/licenses}/LICENSE.md +0 -0
@@ -1,266 +1,317 @@
1
- import requests
2
- import json
3
- import re
4
- from typing import Union, Any, Dict, Optional, Generator
5
-
6
- from webscout.AIutel import Optimizers, Conversation, AwesomePrompts
7
- from webscout.AIbase import Provider
8
- from webscout import exceptions
9
- from webscout.litagent import LitAgent
10
-
11
- class JadveOpenAI(Provider):
12
- """
13
- A class to interact with the OpenAI API through jadve.com using the streaming endpoint.
14
- """
15
-
16
- AVAILABLE_MODELS = ["gpt-4o-mini"]
17
-
18
- def __init__(
19
- self,
20
- is_conversation: bool = True,
21
- max_tokens: int = 600,
22
- timeout: int = 30,
23
- intro: str = None,
24
- filepath: str = None,
25
- update_file: bool = True,
26
- proxies: dict = {},
27
- history_offset: int = 10250,
28
- act: str = None,
29
- model: str = "gpt-4o-mini",
30
- system_prompt: str = "You are a helpful AI assistant."
31
- ):
32
- """
33
- Initializes the JadveOpenAI client.
34
-
35
- Args:
36
- is_conversation (bool, optional): Enable conversational mode. Defaults to True.
37
- max_tokens (int, optional): Maximum tokens for generation. Defaults to 600.
38
- timeout (int, optional): HTTP request timeout in seconds. Defaults to 30.
39
- intro (str, optional): Introductory prompt text. Defaults to None.
40
- filepath (str, optional): Path to conversation history file. Defaults to None.
41
- update_file (bool, optional): Whether to update the conversation history file. Defaults to True.
42
- proxies (dict, optional): Proxies for HTTP requests. Defaults to {}.
43
- history_offset (int, optional): Limit for conversation history. Defaults to 10250.
44
- act (str|int, optional): Act key for AwesomePrompts. Defaults to None.
45
- model (str, optional): AI model to be used. Defaults to "gpt-4o-mini".
46
- system_prompt (str, optional): System prompt text. Defaults to "You are a helpful AI assistant."
47
- """
48
- if model not in self.AVAILABLE_MODELS:
49
- raise ValueError(f"Invalid model: {model}. Choose from: {self.AVAILABLE_MODELS}")
50
-
51
- self.session = requests.Session()
52
- self.is_conversation = is_conversation
53
- self.max_tokens_to_sample = max_tokens
54
- self.api_endpoint = "https://openai.jadve.com/stream"
55
- self.stream_chunk_size = 64
56
- self.timeout = timeout
57
- self.last_response = {}
58
- self.model = model
59
- self.system_prompt = system_prompt
60
-
61
- # Headers for API requests
62
- self.headers = {
63
- "accept": "*/*",
64
- "accept-encoding": "gzip, deflate, br, zstd",
65
- "accept-language": "en-US,en;q=0.9,en-IN;q=0.8",
66
- "content-type": "application/json",
67
- "dnt": "1",
68
- "origin": "https://jadve.com",
69
- "priority": "u=1, i",
70
- "referer": "https://jadve.com/",
71
- "sec-ch-ua": '"Not(A:Brand";v="99", "Microsoft Edge";v="133", "Chromium";v="133"',
72
- "sec-ch-ua-mobile": "?0",
73
- "sec-ch-ua-platform": '"Windows"',
74
- "sec-fetch-dest": "empty",
75
- "sec-fetch-mode": "cors",
76
- "sec-fetch-site": "same-site",
77
- "user-agent": LitAgent().random(),
78
- "x-authorization": "Bearer"
79
- }
80
- self.session.headers.update(self.headers)
81
- self.session.proxies = proxies
82
-
83
- self.__available_optimizers = (
84
- method for method in dir(Optimizers)
85
- if callable(getattr(Optimizers, method)) and not method.startswith("__")
86
- )
87
-
88
- Conversation.intro = (
89
- AwesomePrompts().get_act(
90
- act, raise_not_found=True, default=None, case_insensitive=True
91
- )
92
- if act
93
- else intro or Conversation.intro
94
- )
95
-
96
- self.conversation = Conversation(
97
- is_conversation, self.max_tokens_to_sample, filepath, update_file
98
- )
99
- self.conversation.history_offset = history_offset
100
-
101
- def ask(
102
- self,
103
- prompt: str,
104
- stream: bool = False,
105
- raw: bool = False,
106
- optimizer: str = None,
107
- conversationally: bool = False,
108
- ) -> Union[dict, Generator[dict, None, None]]:
109
- """
110
- Chat with AI.
111
-
112
- Args:
113
- prompt (str): Prompt to be sent.
114
- stream (bool, optional): Flag for streaming response. Defaults to False.
115
- raw (bool, optional): Return raw content chunks. Defaults to False.
116
- optimizer (str, optional): Prompt optimizer name. Defaults to None.
117
- conversationally (bool, optional): Flag for conversational optimization. Defaults to False.
118
- Returns:
119
- dict or generator: A dictionary with the generated text or a generator yielding text chunks.
120
- """
121
- conversation_prompt = self.conversation.gen_complete_prompt(prompt)
122
- if optimizer:
123
- if optimizer in self.__available_optimizers:
124
- conversation_prompt = getattr(Optimizers, optimizer)(
125
- conversation_prompt if conversationally else prompt
126
- )
127
- else:
128
- raise Exception(
129
- f"Optimizer is not one of {list(self.__available_optimizers)}"
130
- )
131
-
132
- payload = {
133
- "messages": [
134
- {"role": "user", "content": [{"type": "text", "text": conversation_prompt}]}
135
- ],
136
- "model": self.model,
137
- "botId": "",
138
- "chatId": "",
139
- "stream": stream,
140
- "temperature": 0.7,
141
- "returnTokensUsage": True,
142
- "useTools": False
143
- }
144
-
145
- def for_stream():
146
- response = self.session.post(
147
- self.api_endpoint, headers=self.headers, json=payload, stream=True, timeout=self.timeout
148
- )
149
-
150
- if not response.ok:
151
- raise exceptions.FailedToGenerateResponseError(
152
- f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
153
- )
154
-
155
- # Pattern to match the streaming chunks format: 0:"text"
156
- pattern = r'0:"(.*?)"'
157
- full_response_text = ""
158
-
159
- # Process the response as it comes in
160
- buffer = ""
161
-
162
- for line in response.iter_lines(decode_unicode=True):
163
- if not line:
164
- continue
165
-
166
- buffer += line
167
-
168
- # Try to match chunks in the current buffer
169
- matches = re.findall(pattern, buffer)
170
- if matches:
171
- for chunk in matches:
172
- full_response_text += chunk
173
- # Return the current chunk
174
- yield chunk if raw else dict(text=chunk)
175
-
176
- # Remove matched parts from the buffer
177
- matched_parts = [f'0:"{match}"' for match in matches]
178
- for part in matched_parts:
179
- buffer = buffer.replace(part, '', 1)
180
-
181
- # Check if we've reached the end of the response
182
- if 'e:' in line or 'd:' in line:
183
- # No need to process usage data without logging
184
- break
185
-
186
- self.last_response.update(dict(text=full_response_text))
187
- self.conversation.update_chat_history(prompt, self.get_message(self.last_response))
188
-
189
- def for_non_stream():
190
- # For non-streaming requests, we collect all chunks and return the complete response
191
- collected_text = ""
192
- for chunk in for_stream():
193
- if raw:
194
- collected_text += chunk
195
- else:
196
- collected_text += chunk.get("text", "")
197
-
198
- self.last_response = {"text": collected_text}
199
- return self.last_response
200
-
201
- return for_stream() if stream else for_non_stream()
202
-
203
- def chat(
204
- self,
205
- prompt: str,
206
- stream: bool = False,
207
- optimizer: str = None,
208
- conversationally: bool = False,
209
- ) -> Union[str, Generator[str, None, None]]:
210
- """
211
- Generate a chat response (string).
212
-
213
- Args:
214
- prompt (str): Prompt to be sent.
215
- stream (bool, optional): Flag for streaming response. Defaults to False.
216
- optimizer (str, optional): Prompt optimizer name. Defaults to None.
217
- conversationally (bool, optional): Flag for conversational optimization. Defaults to False.
218
- Returns:
219
- str or generator: Generated response string or generator yielding response chunks.
220
- """
221
- def for_stream():
222
- for response in self.ask(
223
- prompt, stream=True, optimizer=optimizer, conversationally=conversationally
224
- ):
225
- yield self.get_message(response)
226
-
227
- def for_non_stream():
228
- return self.get_message(
229
- self.ask(prompt, stream=False, optimizer=optimizer, conversationally=conversationally)
230
- )
231
-
232
- return for_stream() if stream else for_non_stream()
233
-
234
- def get_message(self, response: dict) -> str:
235
- """
236
- Retrieves message from the response.
237
-
238
- Args:
239
- response (dict): Response from the ask() method.
240
- Returns:
241
- str: Extracted text.
242
- """
243
- assert isinstance(response, dict), "Response should be of dict data-type only"
244
- return response["text"]
245
-
246
- if __name__ == "__main__":
247
- print("-" * 80)
248
- print(f"{'Model':<50} {'Status':<10} {'Response'}")
249
- print("-" * 80)
250
-
251
- for model in JadveOpenAI.AVAILABLE_MODELS:
252
- try:
253
- test_ai = JadveOpenAI(model=model, timeout=60)
254
- response = test_ai.chat("Say 'Hello' in one word")
255
- response_text = response
256
-
257
- if response_text and len(response_text.strip()) > 0:
258
- status = "✓"
259
- # Truncate response if too long
260
- display_text = response_text.strip()[:50] + "..." if len(response_text.strip()) > 50 else response_text.strip()
261
- else:
262
- status = "✗"
263
- display_text = "Empty or invalid response"
264
- print(f"{model:<50} {status:<10} {display_text}")
265
- except Exception as e:
266
- print(f"{model:<50} {'✗':<10} {str(e)}")
1
+ import re
2
+ import secrets
3
+ from typing import Any, Dict, Generator, Optional, Union, cast
4
+
5
+ from curl_cffi import CurlError
6
+ from curl_cffi.requests import Session
7
+
8
+ from webscout import exceptions
9
+ from webscout.AIbase import Provider, Response
10
+ from webscout.AIutel import ( # Import sanitize_stream
11
+ AwesomePrompts,
12
+ Conversation,
13
+ Optimizers,
14
+ sanitize_stream,
15
+ )
16
+
17
+
18
+ class JadveOpenAI(Provider):
19
+ """
20
+ A class to interact with the OpenAI API through jadve.com using the streaming endpoint.
21
+ """
22
+
23
+ required_auth = False
24
+ AVAILABLE_MODELS = ["gpt-5-mini", "claude-3-5-haiku-20241022"]
25
+
26
+ def __init__(
27
+ self,
28
+ is_conversation: bool = True,
29
+ max_tokens: int = 600,
30
+ timeout: int = 30,
31
+ intro: Optional[str] = None,
32
+ filepath: Optional[str] = None,
33
+ update_file: bool = True,
34
+ proxies: dict = {},
35
+ history_offset: int = 10250,
36
+ act: Optional[str] = None,
37
+ model: str = "gpt-5-mini",
38
+ system_prompt: str = "You are a helpful AI assistant.", # Note: system_prompt is not used by this API
39
+ ):
40
+ """
41
+ Initializes the JadveOpenAI client.
42
+
43
+ Args:
44
+ is_conversation (bool, optional): Enable conversational mode. Defaults to True.
45
+ max_tokens (int, optional): Maximum tokens for generation. Defaults to 600.
46
+ timeout (int, optional): HTTP request timeout in seconds. Defaults to 30.
47
+ intro (str, optional): Introductory prompt text. Defaults to None.
48
+ filepath (str, optional): Path to conversation history file. Defaults to None.
49
+ update_file (bool, optional): Whether to update the conversation history file. Defaults to True.
50
+ proxies (dict, optional): Proxies for HTTP requests. Defaults to {}.
51
+ history_offset (int, optional): Limit for conversation history. Defaults to 10250.
52
+ act (str|int, optional): Act key for AwesomePrompts. Defaults to None.
53
+ model (str, optional): AI model to be used. Defaults to "gpt-4o-mini".
54
+ system_prompt (str, optional): System prompt text. Defaults to "You are a helpful AI assistant."
55
+ """
56
+ if model not in self.AVAILABLE_MODELS:
57
+ raise ValueError(f"Invalid model: {model}. Choose from: {self.AVAILABLE_MODELS}")
58
+
59
+ # Initialize curl_cffi Session
60
+ self.session = Session()
61
+ self.is_conversation = is_conversation
62
+ self.max_tokens_to_sample = max_tokens
63
+ self.api_endpoint = "https://ai-api.jadve.com/api/chat"
64
+ self.stream_chunk_size = 64
65
+ self.timeout = timeout
66
+ self.last_response = {}
67
+ self.model = model
68
+ self.system_prompt = system_prompt
69
+
70
+ # Headers for API requests
71
+ self.headers = {
72
+ "accept": "*/*",
73
+ "accept-language": "en-US,en;q=0.9,en-IN;q=0.8",
74
+ "content-type": "application/json",
75
+ "dnt": "1",
76
+ "origin": "https://jadve.com",
77
+ "priority": "u=1, i",
78
+ "referer": "https://jadve.com/",
79
+ "sec-fetch-dest": "empty",
80
+ "sec-fetch-mode": "cors",
81
+ "sec-fetch-site": "same-site",
82
+ "sec-ch-ua": '"Chromium";v="140", "Not=A?Brand";v="24", "Microsoft Edge";v="140"',
83
+ "sec-ch-ua-mobile": "?0",
84
+ "sec-ch-ua-platform": '"Windows"',
85
+ "sec-gpc": "1",
86
+ "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/140.0.0.0 Safari/537.36 Edg/140.0.0.0",
87
+ }
88
+
89
+ # Update curl_cffi session headers and proxies
90
+ self.session = Session()
91
+ self.session.headers.update(self.headers)
92
+ if proxies:
93
+ self.session.proxies.update(proxies)
94
+
95
+ self.__available_optimizers = (
96
+ method
97
+ for method in dir(Optimizers)
98
+ if callable(getattr(Optimizers, method)) and not method.startswith("__")
99
+ )
100
+
101
+ self.conversation = Conversation(
102
+ is_conversation, self.max_tokens_to_sample, filepath, update_file
103
+ )
104
+ self.conversation.history_offset = history_offset
105
+
106
+ if act:
107
+ self.conversation.intro = (
108
+ AwesomePrompts().get_act(
109
+ cast(Union[str, int], act),
110
+ default=self.conversation.intro,
111
+ case_insensitive=True,
112
+ )
113
+ or self.conversation.intro
114
+ )
115
+ elif intro:
116
+ self.conversation.intro = intro
117
+
118
+ @staticmethod
119
+ def _jadve_extractor(chunk: Union[str, Dict[str, Any]]) -> Optional[str]:
120
+ """Extracts content from the Jadve stream format '0:"..."'."""
121
+ if isinstance(chunk, str):
122
+ match = re.search(
123
+ r'0:"(.*?)"(?=,|$)', chunk
124
+ ) # Look for 0:"...", possibly followed by comma or end of string
125
+ if match:
126
+ # Decode potential unicode escapes like \u00e9 and handle escaped quotes/backslashes
127
+ content = match.group(1).encode().decode("unicode_escape")
128
+ return content.replace("\\\\", "\\").replace('\\"', '"')
129
+ return None
130
+
131
+ def ask(
132
+ self,
133
+ prompt: str,
134
+ stream: bool = False,
135
+ raw: bool = False,
136
+ optimizer: Optional[str] = None,
137
+ conversationally: bool = False,
138
+ **kwargs: Any,
139
+ ) -> Response:
140
+ """
141
+ Chat with AI.
142
+
143
+ Args:
144
+ prompt (str): Prompt to be sent.
145
+ stream (bool, optional): Flag for streaming response. Defaults to False.
146
+ raw (bool, optional): Return raw content chunks. Defaults to False.
147
+ optimizer (str, optional): Prompt optimizer name. Defaults to None.
148
+ conversationally (bool, optional): Flag for conversational optimization. Defaults to False.
149
+ Returns:
150
+ dict or generator: A dictionary with the generated text or a generator yielding text chunks.
151
+ """
152
+ conversation_prompt = self.conversation.gen_complete_prompt(prompt)
153
+ if optimizer:
154
+ if optimizer in self.__available_optimizers:
155
+ conversation_prompt = getattr(Optimizers, optimizer)(
156
+ conversation_prompt if conversationally else prompt
157
+ )
158
+ else:
159
+ raise Exception(f"Optimizer is not one of {list(self.__available_optimizers)}")
160
+
161
+ payload = {
162
+ "id": secrets.token_hex(8),
163
+ "messages": [
164
+ {"role": "user", "content": [{"type": "text", "text": conversation_prompt}]}
165
+ ],
166
+ "model": self.model,
167
+ "botId": "",
168
+ "chatId": "",
169
+ "stream": True,
170
+ "returnTokensUsage": True,
171
+ "useTools": False,
172
+ }
173
+
174
+ def for_stream():
175
+ full_response_text = "" # Initialize outside try block
176
+ try:
177
+ # Use curl_cffi session post with impersonate
178
+ response = self.session.post(
179
+ self.api_endpoint,
180
+ # headers are set on the session
181
+ json=payload,
182
+ stream=True,
183
+ timeout=self.timeout,
184
+ # proxies are set on the session
185
+ impersonate="chrome120", # Use a common impersonation profile
186
+ )
187
+ response.raise_for_status() # Check for HTTP errors
188
+
189
+ # Use sanitize_stream
190
+ processed_stream = sanitize_stream(
191
+ data=response.iter_content(chunk_size=None), # Pass byte iterator
192
+ intro_value=None, # No simple prefix
193
+ to_json=False, # Content is text after extraction
194
+ content_extractor=self._jadve_extractor, # Use the specific extractor
195
+ yield_raw_on_error=True,
196
+ raw=raw,
197
+ )
198
+
199
+ for content_chunk in processed_stream:
200
+ if raw:
201
+ if content_chunk and isinstance(content_chunk, str):
202
+ full_response_text += content_chunk
203
+ yield content_chunk
204
+ else:
205
+ if content_chunk and isinstance(content_chunk, str):
206
+ full_response_text += content_chunk
207
+ resp = {"text": content_chunk}
208
+ yield resp
209
+
210
+ # Update history after stream finishes
211
+ self.last_response = {"text": full_response_text}
212
+ self.conversation.update_chat_history(prompt, full_response_text)
213
+
214
+ except CurlError as e: # Catch CurlError
215
+ raise exceptions.FailedToGenerateResponseError(
216
+ f"Request failed (CurlError): {e}"
217
+ ) from e
218
+ except Exception as e: # Catch other potential exceptions (like HTTPError)
219
+ err_text = ""
220
+ if hasattr(e, "response"):
221
+ response_obj = getattr(e, "response")
222
+ if hasattr(response_obj, "text"):
223
+ err_text = getattr(response_obj, "text")
224
+ raise exceptions.FailedToGenerateResponseError(
225
+ f"Failed to generate response ({type(e).__name__}): {e} - {err_text}"
226
+ ) from e
227
+
228
+ def for_non_stream():
229
+ collected_text = ""
230
+ try:
231
+ for chunk_data in for_stream():
232
+ if raw:
233
+ if isinstance(chunk_data, str):
234
+ collected_text += chunk_data
235
+ else:
236
+ if isinstance(chunk_data, dict) and "text" in chunk_data:
237
+ collected_text += chunk_data["text"]
238
+ except Exception as e:
239
+ if not collected_text:
240
+ raise exceptions.FailedToGenerateResponseError(
241
+ f"Failed to get non-stream response: {str(e)}"
242
+ ) from e
243
+ # last_response and history are updated within for_stream
244
+ return collected_text if raw else self.last_response
245
+
246
+ return for_stream() if stream else for_non_stream()
247
+
248
+ def chat(
249
+ self,
250
+ prompt: str,
251
+ stream: bool = False,
252
+ optimizer: Optional[str] = None,
253
+ conversationally: bool = False,
254
+ **kwargs: Any,
255
+ ) -> Union[str, Generator[str, None, None]]:
256
+ """
257
+ Generate a chat response (string).
258
+
259
+ Args:
260
+ prompt (str): Prompt to be sent.
261
+ stream (bool, optional): Flag for streaming response. Defaults to False.
262
+ optimizer (str, optional): Prompt optimizer name. Defaults to None.
263
+ conversationally (bool, optional): Flag for conversational optimization. Defaults to False.
264
+ **kwargs: Additional parameters including raw.
265
+ Returns:
266
+ str or generator: Generated response string or generator yielding response chunks.
267
+ """
268
+ raw = kwargs.get("raw", False)
269
+
270
+ def for_stream_chat():
271
+ gen = self.ask(
272
+ prompt, stream=True, raw=raw, optimizer=optimizer, conversationally=conversationally
273
+ )
274
+ for response in gen:
275
+ if raw:
276
+ yield response
277
+ else:
278
+ yield self.get_message(response)
279
+
280
+ def for_non_stream_chat():
281
+ response_data = self.ask(
282
+ prompt,
283
+ stream=False,
284
+ raw=raw,
285
+ optimizer=optimizer,
286
+ conversationally=conversationally,
287
+ )
288
+ if raw:
289
+ return response_data if isinstance(response_data, str) else str(response_data)
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
+ """
296
+ Retrieves message from the response.
297
+
298
+ Args:
299
+ response (Response): Response from the ask() method.
300
+ Returns:
301
+ str: Extracted text.
302
+ """
303
+ if not isinstance(response, dict):
304
+ return str(response)
305
+ # Extractor handles formatting
306
+ return cast(Dict[str, Any], response).get("text", "")
307
+
308
+
309
+ if __name__ == "__main__":
310
+ for model in JadveOpenAI.AVAILABLE_MODELS:
311
+ ai = JadveOpenAI(model=model)
312
+ response = ai.chat("hi")
313
+ print(f"Model: {model}")
314
+ print(response)
315
+ print("-" * 50)
316
+ # for chunk in response:
317
+ # print(chunk, end="", flush=True)