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,766 +0,0 @@
1
- import requests
2
- import random
3
- import string
4
- import base64
5
- from datetime import datetime, timedelta
6
- from typing import Generator, List, Dict, Optional, Any, Union
7
- import json # Not used directly in this snippet, but often useful
8
- import uuid
9
- import time
10
-
11
- # Import base classes and utility structures
12
- from webscout.Provider.OPENAI.base import OpenAICompatibleProvider, BaseChat, BaseCompletions
13
- from webscout.Provider.OPENAI.utils import (
14
- ChatCompletion, Choice,
15
- ChatCompletionMessage, CompletionUsage, count_tokens,
16
- ChatCompletionChunk, ChoiceDelta # Added for streaming return type
17
- )
18
- from webscout.litagent import LitAgent, agent
19
- agent = LitAgent()
20
-
21
- def to_data_uri(image_data):
22
- """Convert image data to a data URI format"""
23
- if isinstance(image_data, str):
24
- # Assume it's already a data URI
25
- return image_data
26
-
27
- # Encode binary data to base64
28
- encoded = base64.b64encode(image_data).decode('utf-8')
29
-
30
- # Determine MIME type (simplified)
31
- mime_type = "image/jpeg" # Default
32
- if image_data.startswith(b'\x89PNG'):
33
- mime_type = "image/png"
34
- elif image_data.startswith(b'\xff\xd8'):
35
- mime_type = "image/jpeg"
36
- elif image_data.startswith(b'GIF'):
37
- mime_type = "image/gif"
38
-
39
- return f"data:{mime_type};base64,{encoded}"
40
-
41
-
42
- class Completions(BaseCompletions):
43
- def __init__(self, client: 'BLACKBOXAI'):
44
- self._client = client
45
-
46
- def create(
47
- self,
48
- *,
49
- model: str,
50
- messages: List[Dict[str, Any]],
51
- max_tokens: Optional[int] = None,
52
- stream: bool = False,
53
- temperature: Optional[float] = None,
54
- top_p: Optional[float] = None,
55
- **kwargs: Any
56
- ) -> Union[ChatCompletion, Generator[ChatCompletionChunk, None, None]]:
57
- """
58
- Create a chat completion with BlackboxAI API.
59
-
60
- Args:
61
- model: The model to use (from AVAILABLE_MODELS)
62
- messages: List of message dictionaries with 'role' and 'content'
63
- max_tokens: Maximum number of tokens to generate
64
- stream: If True, yields streaming chunks
65
- temperature: Sampling temperature (0-1)
66
- top_p: Nucleus sampling parameter (0-1)
67
- **kwargs: Additional parameters to pass to the API
68
-
69
- Returns:
70
- Returns a ChatCompletion object or a generator for streaming
71
- """
72
- # Generate request ID and timestamp
73
- request_id = str(uuid.uuid4())
74
- created_time = int(time.time())
75
-
76
- # Extract system message if present
77
- system_message = "You are a helpful AI assistant."
78
- for msg in messages:
79
- if msg.get("role") == "system":
80
- system_message = msg.get("content")
81
- break
82
-
83
- # Look for any image content
84
- media = []
85
- for msg in messages:
86
- if msg.get("role") == "user":
87
- # Check for image attachments in content
88
- content = msg.get("content", [])
89
- if isinstance(content, list):
90
- for item in content:
91
- if isinstance(item, dict) and item.get("type") == "image_url":
92
- image_url = item.get("image_url", {})
93
- if isinstance(image_url, dict) and "url" in image_url:
94
- url = image_url["url"]
95
- if url.startswith("data:"):
96
- # It's already a data URI
97
- image_name = f"image_{len(media)}.png"
98
- media.append((url, image_name))
99
- else:
100
- # Need to fetch and convert to data URI
101
- try:
102
- image_response = requests.get(url)
103
- if image_response.ok:
104
- image_name = f"image_{len(media)}.png"
105
- media.append((image_response.content, image_name))
106
- except Exception as e:
107
- pass
108
-
109
- # Check if streaming is requested and raise an error
110
- if stream:
111
- return self._create_streaming(
112
- request_id=request_id,
113
- created_time=created_time,
114
- model=model,
115
- messages=messages,
116
- system_message=system_message,
117
- max_tokens=max_tokens,
118
- temperature=temperature,
119
- top_p=top_p,
120
- media=media
121
- )
122
-
123
- # Use non-streaming implementation
124
- return self._create_non_streaming(
125
- request_id=request_id,
126
- created_time=created_time,
127
- model=model,
128
- messages=messages,
129
- system_message=system_message,
130
- max_tokens=max_tokens,
131
- temperature=temperature,
132
- top_p=top_p,
133
- media=media
134
- )
135
-
136
-
137
- def _create_non_streaming(
138
- self,
139
- *,
140
- request_id: str,
141
- created_time: int,
142
- model: str,
143
- messages: List[Dict[str, Any]],
144
- system_message: str,
145
- max_tokens: Optional[int] = None,
146
- temperature: Optional[float] = None,
147
- top_p: Optional[float] = None,
148
- media: List = None
149
- ) -> ChatCompletion:
150
- """Implementation for non-streaming chat completions."""
151
- try:
152
- # Prepare user messages for BlackboxAI API format
153
- blackbox_messages = []
154
- for i, msg in enumerate(messages):
155
- if msg["role"] == "system":
156
- continue # System message handled separately
157
-
158
- msg_id = self._client.generate_id() if i > 0 else request_id
159
- blackbox_messages.append({
160
- "id": msg_id,
161
- "content": msg["content"],
162
- "role": msg["role"]
163
- })
164
-
165
- # Add image data if provided
166
- if media and blackbox_messages:
167
- blackbox_messages[-1]['data'] = {
168
- "imagesData": [
169
- {
170
- "filePath": f"/",
171
- "contents": to_data_uri(image[0])
172
- } for image in media
173
- ],
174
- "fileText": "",
175
- "title": ""
176
- }
177
-
178
- # Generate request payload with session
179
- request_email = f"{self._client.generate_random_string(8)}@blackbox.ai"
180
- session_data = self._client.generate_session(request_email)
181
-
182
- # Create the API request payload
183
- payload = self._client.create_request_payload(
184
- messages=blackbox_messages,
185
- chat_id=request_id,
186
- system_message=system_message,
187
- max_tokens=max_tokens,
188
- temperature=temperature,
189
- top_p=top_p,
190
- session_data=session_data,
191
- model=model
192
- )
193
-
194
- # Make the API request with cookies
195
- response = self._client.session.post(
196
- self._client.api_endpoint,
197
- json=payload,
198
- headers=self._client.headers,
199
- cookies=self._client.cookies,
200
- timeout=self._client.timeout
201
- )
202
-
203
- # Process the response
204
- full_content = ""
205
- if response.status_code == 200:
206
- # Extract content from response text
207
- response_text = response.text
208
-
209
- # Handle possible SSE format in response
210
- if "data: " in response_text:
211
- # Extract content from SSE format
212
- content_lines = []
213
- for line in response_text.split('\n'):
214
- if line.startswith("data: "):
215
- line = line[6:].strip()
216
- if line and not any(error_msg in line.lower() for error_msg in [
217
- "service has been suspended",
218
- "api request failed",
219
- "you have reached your request limit"
220
- ]):
221
- content_lines.append(line)
222
- full_content = "".join(content_lines)
223
- else:
224
- # Regular response
225
- full_content = response_text
226
- else:
227
- # Handle error response
228
- raise IOError(f"BlackboxAI request failed with status code {response.status_code}")
229
-
230
- # Create the completion message
231
- message = ChatCompletionMessage(
232
- role="assistant",
233
- content=full_content
234
- )
235
-
236
- # Create the choice with the message
237
- choice = Choice(
238
- index=0,
239
- message=message,
240
- finish_reason="stop"
241
- )
242
-
243
- # Estimate token usage using count_tokens
244
- prompt_tokens = count_tokens([str(msg.get("content", "")) for msg in messages])
245
- completion_tokens = count_tokens(full_content)
246
-
247
- # Create the final completion object
248
- completion = ChatCompletion(
249
- id=request_id,
250
- choices=[choice],
251
- created=created_time,
252
- model=model,
253
- usage=CompletionUsage(
254
- prompt_tokens=prompt_tokens,
255
- completion_tokens=completion_tokens,
256
- total_tokens=prompt_tokens + completion_tokens
257
- )
258
- )
259
-
260
- return completion
261
-
262
- except Exception as e:
263
- raise IOError(f"BlackboxAI request failed: {str(e)}") from e
264
-
265
- def _create_streaming(
266
- self,
267
- *,
268
- request_id: str,
269
- created_time: int,
270
- model: str,
271
- messages: List[Dict[str, Any]],
272
- system_message: str,
273
- max_tokens: Optional[int] = None,
274
- temperature: Optional[float] = None,
275
- top_p: Optional[float] = None,
276
- media: List = None
277
- ):
278
- """Implementation for streaming chat completions (OpenAI-compatible chunks)."""
279
- # Prepare user messages for BlackboxAI API format
280
- blackbox_messages = []
281
- for i, msg in enumerate(messages):
282
- if msg["role"] == "system":
283
- continue # System message handled separately
284
- msg_id = self._client.generate_id() if i > 0 else request_id
285
- blackbox_messages.append({
286
- "id": msg_id,
287
- "content": msg["content"],
288
- "role": msg["role"]
289
- })
290
- # Add image data if provided
291
- if media and blackbox_messages:
292
- blackbox_messages[-1]['data'] = {
293
- "imagesData": [
294
- {
295
- "filePath": f"/",
296
- "contents": to_data_uri(image[0])
297
- } for image in media
298
- ],
299
- "fileText": "",
300
- "title": ""
301
- }
302
- # Generate request payload with session
303
- request_email = f"{self._client.generate_random_string(8)}@blackbox.ai"
304
- session_data = self._client.generate_session(request_email)
305
- payload = self._client.create_request_payload(
306
- messages=blackbox_messages,
307
- chat_id=request_id,
308
- system_message=system_message,
309
- max_tokens=max_tokens,
310
- temperature=temperature,
311
- top_p=top_p,
312
- session_data=session_data,
313
- model=model
314
- )
315
- # Make the API request with cookies, stream=True
316
- response = self._client.session.post(
317
- self._client.api_endpoint,
318
- json=payload,
319
- headers=self._client.headers,
320
- cookies=self._client.cookies,
321
- stream=True,
322
- timeout=self._client.timeout
323
- )
324
- # Blackbox streams as raw text, no line breaks, so chunk manually
325
- buffer = ""
326
- chunk_size = 32 # Tune as needed for smoothness
327
- from webscout.Provider.OPENAI.utils import ChatCompletionChunk, Choice, ChoiceDelta
328
- for chunk in response.iter_content(chunk_size=chunk_size):
329
- if not chunk:
330
- continue
331
- text = chunk.decode(errors="ignore")
332
- buffer += text
333
- # Yield in small pieces, but only non-empty
334
- while len(buffer) >= chunk_size:
335
- out = buffer[:chunk_size]
336
- buffer = buffer[chunk_size:]
337
- if out.strip():
338
- # Wrap the chunk in OpenAI-compatible structure
339
- delta = ChoiceDelta(content=out, role="assistant")
340
- choice = Choice(index=0, delta=delta, finish_reason=None)
341
- chunk_obj = ChatCompletionChunk(
342
- id=request_id,
343
- choices=[choice],
344
- created=created_time,
345
- model=model,
346
- system_fingerprint=None
347
- )
348
- yield chunk_obj
349
- # Yield any remaining buffer
350
- if buffer.strip():
351
- delta = ChoiceDelta(content=buffer, role="assistant")
352
- choice = Choice(index=0, delta=delta, finish_reason=None)
353
- chunk_obj = ChatCompletionChunk(
354
- id=request_id,
355
- choices=[choice],
356
- created=created_time,
357
- model=model,
358
- system_fingerprint=None
359
- )
360
- yield chunk_obj
361
-
362
-
363
- class Chat(BaseChat):
364
- def __init__(self, client: 'BLACKBOXAI'):
365
- self.completions = Completions(client)
366
-
367
-
368
- class BLACKBOXAI(OpenAICompatibleProvider):
369
- """
370
- OpenAI-compatible client for BlackboxAI API.
371
-
372
- Usage:
373
- client = BLACKBOXAI()
374
- response = client.chat.completions.create(
375
- model="GPT-4.1",
376
- messages=[{"role": "user", "content": "Hello!"}]
377
- )
378
- print(response.choices[0].message.content)
379
- """
380
- # Default model
381
- default_model = "GPT-4.1"
382
- default_vision_model = default_model
383
- api_endpoint = "https://www.blackbox.ai/api/chat"
384
- timeout = 30
385
-
386
-
387
- # Default model (remains the same as per original class)
388
- default_model = "GPT-4.1"
389
- default_vision_model = default_model
390
-
391
- # New OpenRouter models list
392
- openrouter_models = [
393
- "Deepcoder 14B Preview",
394
- "DeepHermes 3 Llama 3 8B Preview",
395
- "DeepSeek R1 Zero",
396
- "Dolphin3.0 Mistral 24B",
397
- "Dolphin3.0 R1 Mistral 24B",
398
- "Flash 3",
399
- "Gemini 2.0 Flash Experimental",
400
- "Gemma 2 9B",
401
- "Gemma 3 12B",
402
- "Gemma 3 1B",
403
- "Gemma 3 27B",
404
- "Gemma 3 4B",
405
- "Kimi VL A3B Thinking",
406
- "Llama 3.1 8B Instruct",
407
- "Llama 3.1 Nemotron Ultra 253B v1",
408
- "Llama 3.2 11B Vision Instruct",
409
- "Llama 3.2 1B Instruct",
410
- "Llama 3.2 3B Instruct",
411
- "Llama 3.3 70B Instruct",
412
- "Llama 3.3 Nemotron Super 49B v1",
413
- "Llama 4 Maverick",
414
- "Llama 4 Scout",
415
- "Mistral 7B Instruct",
416
- "Mistral Nemo",
417
- "Mistral Small 3",
418
- "Mistral Small 3.1 24B",
419
- "Molmo 7B D",
420
- "Moonlight 16B A3B Instruct",
421
- "Qwen2.5 72B Instruct",
422
- "Qwen2.5 7B Instruct",
423
- "Qwen2.5 Coder 32B Instruct",
424
- "Qwen2.5 VL 32B Instruct",
425
- "Qwen2.5 VL 3B Instruct",
426
- "Qwen2.5 VL 72B Instruct",
427
- "Qwen2.5-VL 7B Instruct",
428
- "Qwerky 72B",
429
- "QwQ 32B",
430
- "QwQ 32B Preview",
431
- "QwQ 32B RpR v1",
432
- "R1",
433
- "R1 Distill Llama 70B",
434
- "R1 Distill Qwen 14B",
435
- "R1 Distill Qwen 32B",
436
- ]
437
-
438
- # New base models list
439
- models = [
440
- default_model,
441
- "o3-mini",
442
- "gpt-4.1-nano",
443
- "Claude Opus 4", # Added Claude Opus 4
444
- "Claude Sonnet 4", # Added Claude Sonnet 4
445
- "Claude-sonnet-3.7",
446
- "Claude-sonnet-3.5",
447
- "Grok 3", # Added Grok 3
448
- "Gemini 2.5 Pro", # Added Gemini 2.5 Pro
449
- "UI-TARS 72B", # Added UI-TARS 72B
450
- "DeepSeek-R1",
451
- "Mistral-Small-24B-Instruct-2501",
452
- *openrouter_models,
453
- # Trending agent modes (names)
454
- 'Python Agent', 'HTML Agent', 'Builder Agent', 'Java Agent', 'JavaScript Agent',
455
- 'React Agent', 'Android Agent', 'Flutter Agent', 'Next.js Agent', 'AngularJS Agent',
456
- 'Swift Agent', 'MongoDB Agent', 'PyTorch Agent', 'Xcode Agent', 'Azure Agent',
457
- 'Bitbucket Agent', 'DigitalOcean Agent', 'Docker Agent', 'Electron Agent',
458
- 'Erlang Agent', 'FastAPI Agent', 'Firebase Agent', 'Flask Agent', 'Git Agent',
459
- 'Gitlab Agent', 'Go Agent', 'Godot Agent', 'Google Cloud Agent', 'Heroku Agent'
460
- ]
461
-
462
- # Models that support vision capabilities
463
- vision_models = [default_vision_model, 'o3-mini', "Llama 3.2 11B Vision Instruct", "Gemini 2.5 Pro", "Claude Sonnet 4", "Claude Opus 4", "UI-TARS 72B"] # Added Llama vision, Gemini 2.5 Pro, Claude Sonnet 4, Claude Opus 4, and UI-TARS 72B
464
-
465
- # Models that can be directly selected by users
466
- userSelectedModel = ['o3-mini', 'Claude Opus 4', 'Claude Sonnet 4', 'Claude-sonnet-3.7', 'Claude-sonnet-3.5', 'Grok 3', 'Gemini 2.5 Pro', 'UI-TARS 72B', 'DeepSeek-R1', 'Mistral-Small-24B-Instruct-2501'] + openrouter_models
467
-
468
- # Agent mode configurations
469
- agentMode = {
470
- # OpenRouter Free
471
- 'Deepcoder 14B Preview': {'mode': True, 'id': "agentica-org/deepcoder-14b-preview:free", 'name': "Deepcoder 14B Preview"},
472
- 'DeepHermes 3 Llama 3 8B Preview': {'mode': True, 'id': "nousresearch/deephermes-3-llama-3-8b-preview:free", 'name': "DeepHermes 3 Llama 3 8B Preview"},
473
- 'DeepSeek R1 Zero': {'mode': True, 'id': "deepseek/deepseek-r1-zero:free", 'name': "DeepSeek R1 Zero"},
474
- 'Dolphin3.0 Mistral 24B': {'mode': True, 'id': "cognitivecomputations/dolphin3.0-mistral-24b:free", 'name': "Dolphin3.0 Mistral 24B"},
475
- 'Dolphin3.0 R1 Mistral 24B': {'mode': True, 'id': "cognitivecomputations/dolphin3.0-r1-mistral-24b:free", 'name': "Dolphin3.0 R1 Mistral 24B"},
476
- 'Flash 3': {'mode': True, 'id': "rekaai/reka-flash-3:free", 'name': "Flash 3"},
477
- 'Gemini 2.0 Flash Experimental': {'mode': True, 'id': "google/gemini-2.0-flash-exp:free", 'name': "Gemini 2.0 Flash Experimental"},
478
- 'Gemma 2 9B': {'mode': True, 'id': "google/gemma-2-9b-it:free", 'name': "Gemma 2 9B"},
479
- 'Gemma 3 12B': {'mode': True, 'id': "google/gemma-3-12b-it:free", 'name': "Gemma 3 12B"},
480
- 'Gemma 3 1B': {'mode': True, 'id': "google/gemma-3-1b-it:free", 'name': "Gemma 3 1B"},
481
- 'Gemma 3 27B': {'mode': True, 'id': "google/gemma-3-27b-it:free", 'name': "Gemma 3 27B"},
482
- 'Gemma 3 4B': {'mode': True, 'id': "google/gemma-3-4b-it:free", 'name': "Gemma 3 4B"},
483
- 'Kimi VL A3B Thinking': {'mode': True, 'id': "moonshotai/kimi-vl-a3b-thinking:free", 'name': "Kimi VL A3B Thinking"},
484
- 'Llama 3.1 8B Instruct': {'mode': True, 'id': "meta-llama/llama-3.1-8b-instruct:free", 'name': "Llama 3.1 8B Instruct"},
485
- 'Llama 3.1 Nemotron Ultra 253B v1': {'mode': True, 'id': "nvidia/llama-3.1-nemotron-ultra-253b-v1:free", 'name': "Llama 3.1 Nemotron Ultra 253B v1"},
486
- 'Llama 3.2 11B Vision Instruct': {'mode': True, 'id': "meta-llama/llama-3.2-11b-vision-instruct:free", 'name': "Llama 3.2 11B Vision Instruct"},
487
- 'Llama 3.2 1B Instruct': {'mode': True, 'id': "meta-llama/llama-3.2-1b-instruct:free", 'name': "Llama 3.2 1B Instruct"},
488
- 'Llama 3.2 3B Instruct': {'mode': True, 'id': "meta-llama/llama-3.2-3b-instruct:free", 'name': "Llama 3.2 3B Instruct"},
489
- 'Llama 3.3 70B Instruct': {'mode': True, 'id': "meta-llama/llama-3.3-70b-instruct:free", 'name': "Llama 3.3 70B Instruct"},
490
- 'Llama 3.3 Nemotron Super 49B v1': {'mode': True, 'id': "nvidia/llama-3.3-nemotron-super-49b-v1:free", 'name': "Llama 3.3 Nemotron Super 49B v1"},
491
- 'Llama 4 Maverick': {'mode': True, 'id': "meta-llama/llama-4-maverick:free", 'name': "Llama 4 Maverick"},
492
- 'Llama 4 Scout': {'mode': True, 'id': "meta-llama/llama-4-scout:free", 'name': "Llama 4 Scout"},
493
- 'Mistral 7B Instruct': {'mode': True, 'id': "mistralai/mistral-7b-instruct:free", 'name': "Mistral 7B Instruct"},
494
- 'Mistral Nemo': {'mode': True, 'id': "mistralai/mistral-nemo:free", 'name': "Mistral Nemo"},
495
- 'Mistral Small 3': {'mode': True, 'id': "mistralai/mistral-small-24b-instruct-2501:free", 'name': "Mistral Small 3"}, # Matches Mistral-Small-24B-Instruct-2501
496
- 'Mistral Small 3.1 24B': {'mode': True, 'id': "mistralai/mistral-small-3.1-24b-instruct:free", 'name': "Mistral Small 3.1 24B"},
497
- 'Molmo 7B D': {'mode': True, 'id': "allenai/molmo-7b-d:free", 'name': "Molmo 7B D"},
498
- 'Moonlight 16B A3B Instruct': {'mode': True, 'id': "moonshotai/moonlight-16b-a3b-instruct:free", 'name': "Moonlight 16B A3B Instruct"},
499
- 'Qwen2.5 72B Instruct': {'mode': True, 'id': "qwen/qwen-2.5-72b-instruct:free", 'name': "Qwen2.5 72B Instruct"},
500
- 'Qwen2.5 7B Instruct': {'mode': True, 'id': "qwen/qwen-2.5-7b-instruct:free", 'name': "Qwen2.5 7B Instruct"},
501
- 'Qwen2.5 Coder 32B Instruct': {'mode': True, 'id': "qwen/qwen-2.5-coder-32b-instruct:free", 'name': "Qwen2.5 Coder 32B Instruct"},
502
- 'Qwen2.5 VL 32B Instruct': {'mode': True, 'id': "qwen/qwen2.5-vl-32b-instruct:free", 'name': "Qwen2.5 VL 32B Instruct"},
503
- 'Qwen2.5 VL 3B Instruct': {'mode': True, 'id': "qwen/qwen2.5-vl-3b-instruct:free", 'name': "Qwen2.5 VL 3B Instruct"},
504
- 'Qwen2.5 VL 72B Instruct': {'mode': True, 'id': "qwen/qwen2.5-vl-72b-instruct:free", 'name': "Qwen2.5 VL 72B Instruct"},
505
- 'Qwen2.5-VL 7B Instruct': {'mode': True, 'id': "qwen/qwen-2.5-vl-7b-instruct:free", 'name': "Qwen2.5-VL 7B Instruct"},
506
- 'Qwerky 72B': {'mode': True, 'id': "featherless/qwerky-72b:free", 'name': "Qwerky 72B"},
507
- 'QwQ 32B': {'mode': True, 'id': "qwen/qwq-32b:free", 'name': "QwQ 32B"},
508
- 'QwQ 32B Preview': {'mode': True, 'id': "qwen/qwq-32b-preview:free", 'name': "QwQ 32B Preview"},
509
- 'QwQ 32B RpR v1': {'mode': True, 'id': "arliai/qwq-32b-arliai-rpr-v1:free", 'name': "QwQ 32B RpR v1"},
510
- 'R1': {'mode': True, 'id': "deepseek/deepseek-r1:free", 'name': "R1"}, # Matches DeepSeek-R1
511
- 'R1 Distill Llama 70B': {'mode': True, 'id': "deepseek/deepseek-r1-distill-llama-70b:free", 'name': "R1 Distill Llama 70B"},
512
- 'R1 Distill Qwen 14B': {'mode': True, 'id': "deepseek/deepseek-r1-distill-qwen-14b:free", 'name': "R1 Distill Qwen 14B"},
513
- 'R1 Distill Qwen 32B': {'mode': True, 'id': "deepseek/deepseek-r1-distill-qwen-32b:free", 'name': "R1 Distill Qwen 32B"},
514
- # Default models from the new list
515
- 'Claude Opus 4': {'mode': True, 'id': "anthropic/claude-opus-4", 'name': "Claude Opus 4"},
516
- 'Claude Sonnet 4': {'mode': True, 'id': "anthropic/claude-sonnet-4", 'name': "Claude Sonnet 4"},
517
- 'Claude-sonnet-3.7': {'mode': True, 'id': "Claude-sonnet-3.7", 'name': "Claude-sonnet-3.7"},
518
- 'Claude-sonnet-3.5': {'mode': True, 'id': "Claude-sonnet-3.5", 'name': "Claude-sonnet-3.5"},
519
- 'Grok 3': {'mode': True, 'id': "x-ai/grok-3-beta", 'name': "Grok 3"},
520
- 'Gemini 2.5 Pro': {'mode': True, 'id': "google/gemini-2.5-pro-preview-03-25", 'name': "Gemini 2.5 Pro"},
521
- 'UI-TARS 72B': {'mode': True, 'id': "bytedance-research/ui-tars-72b:free", 'name': "UI-TARS 72B"},
522
- 'DeepSeek-R1': {'mode': True, 'id': "deepseek-reasoner", 'name': "DeepSeek-R1"}, # This is 'R1' in openrouter, but 'DeepSeek-R1' in base models
523
- 'Mistral-Small-24B-Instruct-2501': {'mode': True, 'id': "mistralai/Mistral-Small-24B-Instruct-2501", 'name': "Mistral-Small-24B-Instruct-2501"},
524
- # Add default_model if it's not covered and has an agent mode
525
- default_model: {'mode': True, 'id': "openai/gpt-4.1", 'name': default_model}, # Assuming GPT-4.1 is agent-compatible
526
- 'o3-mini': {'mode': True, 'id': "o3-mini", 'name': "o3-mini"}, # Assuming o3-mini is agent-compatible
527
- 'gpt-4.1-nano': {'mode': True, 'id': "gpt-4.1-nano", 'name': "gpt-4.1-nano"}, # Assuming gpt-4.1-nano is agent-compatible
528
- }
529
-
530
- # Trending agent modes
531
- trendingAgentMode = {
532
- 'Python Agent': {'mode': True, 'id': "python"},
533
- 'HTML Agent': {'mode': True, 'id': "html"},
534
- 'Builder Agent': {'mode': True, 'id': "builder"},
535
- 'Java Agent': {'mode': True, 'id': "java"},
536
- 'JavaScript Agent': {'mode': True, 'id': "javascript"},
537
- 'React Agent': {'mode': True, 'id': "react"},
538
- 'Android Agent': {'mode': True, 'id': "android"},
539
- 'Flutter Agent': {'mode': True, 'id': "flutter"},
540
- 'Next.js Agent': {'mode': True, 'id': "next.js"},
541
- 'AngularJS Agent': {'mode': True, 'id': "angularjs"},
542
- 'Swift Agent': {'mode': True, 'id': "swift"},
543
- 'MongoDB Agent': {'mode': True, 'id': "mongodb"},
544
- 'PyTorch Agent': {'mode': True, 'id': "pytorch"},
545
- 'Xcode Agent': {'mode': True, 'id': "xcode"},
546
- 'Azure Agent': {'mode': True, 'id': "azure"},
547
- 'Bitbucket Agent': {'mode': True, 'id': "bitbucket"},
548
- 'DigitalOcean Agent': {'mode': True, 'id': "digitalocean"},
549
- 'Docker Agent': {'mode': True, 'id': "docker"},
550
- 'Electron Agent': {'mode': True, 'id': "electron"},
551
- 'Erlang Agent': {'mode': True, 'id': "erlang"},
552
- 'FastAPI Agent': {'mode': True, 'id': "fastapi"},
553
- 'Firebase Agent': {'mode': True, 'id': "firebase"},
554
- 'Flask Agent': {'mode': True, 'id': "flask"},
555
- 'Git Agent': {'mode': True, 'id': "git"},
556
- 'Gitlab Agent': {'mode': True, 'id': "gitlab"},
557
- 'Go Agent': {'mode': True, 'id': "go"},
558
- 'Godot Agent': {'mode': True, 'id': "godot"},
559
- 'Google Cloud Agent': {'mode': True, 'id': "googlecloud"},
560
- 'Heroku Agent': {'mode': True, 'id': "heroku"},
561
- }
562
-
563
- # Create AVAILABLE_MODELS as a list with just the model aliases (no "BLACKBOXAI/" prefix)
564
- AVAILABLE_MODELS = list(models)
565
-
566
-
567
- def __init__(
568
- self,
569
- proxies: dict = {}
570
- ):
571
- """
572
- Initialize the BlackboxAI provider with OpenAI compatibility.
573
-
574
- Args:
575
- proxies: Optional proxy configuration
576
- """
577
- # Initialize session
578
- self.session = requests.Session()
579
-
580
- # Set headers based on GitHub reference
581
- self.headers = {
582
- 'Accept': 'text/event-stream',
583
- 'Accept-Encoding': 'gzip, deflate, br, zstd',
584
- 'Accept-Language': 'en-US,en;q=0.9,en-IN;q=0.8',
585
- 'Content-Type': 'application/json',
586
- 'DNT': '1',
587
- 'Origin': 'https://www.blackbox.ai',
588
- 'Referer': 'https://www.blackbox.ai/',
589
- 'Sec-CH-UA': '"Not)A;Brand";v="99", "Microsoft Edge";v="127", "Chromium";v="127"',
590
- 'Sec-CH-UA-Mobile': '?0',
591
- 'Sec-CH-UA-Platform': '"Windows"',
592
- 'Sec-Fetch-Dest': 'empty',
593
- 'Sec-Fetch-Mode': 'cors',
594
- 'Sec-Fetch-Site': 'same-origin',
595
- 'User-Agent': agent.random(),
596
- }
597
-
598
- # Set cookies for the session
599
- self.cookies = {
600
- 'cfzs_amplitude': self.generate_id(32),
601
- 'cfz_amplitude': self.generate_id(32),
602
- '__cf_bm': self.generate_id(32),
603
- }
604
-
605
- # Set proxies if provided
606
- self.session.proxies = proxies
607
-
608
- # Initialize chat interface with completions
609
- self.chat = Chat(self)
610
-
611
- @property
612
- def models(self):
613
- class _ModelList:
614
- def list(inner_self):
615
- return type(self).AVAILABLE_MODELS
616
- return _ModelList()
617
-
618
-
619
- @classmethod
620
- def get_model(cls, model: str) -> str:
621
- """Return the model name, removing BLACKBOXAI/ prefix if present, or default_model."""
622
- if model.startswith("BLACKBOXAI/"):
623
- model = model[len("BLACKBOXAI/"):]
624
- if model in cls.AVAILABLE_MODELS:
625
- return model
626
- return cls.default_model
627
-
628
- @classmethod
629
- def generate_random_string(cls, length: int = 8) -> str:
630
- """Generate a random string of specified length."""
631
- chars = string.ascii_lowercase + string.digits
632
- return ''.join(random.choice(chars) for _ in range(length))
633
-
634
- @classmethod
635
- def generate_id(cls, length: int = 7) -> str:
636
- """Generate a random ID of specified length."""
637
- chars = string.ascii_letters + string.digits
638
- return ''.join(random.choice(chars) for _ in range(length))
639
-
640
- @classmethod
641
- def generate_session(cls, email: str, id_length: int = 21, days_ahead: int = 30) -> dict:
642
- """
643
- Generate a dynamic session with proper ID and expiry format using a specific email.
644
-
645
- Args:
646
- email: The email to use for this session
647
- id_length: Length of the numeric ID (default: 21)
648
- days_ahead: Number of days ahead for expiry (default: 30)
649
-
650
- Returns:
651
- dict: A session dictionary with user information and expiry
652
- """
653
- # Generate a random name
654
- first_names = ["Alex", "Jordan", "Taylor", "Morgan", "Casey", "Riley", "Avery", "Quinn", "Skyler", "Dakota"]
655
- last_names = ["Smith", "Johnson", "Williams", "Brown", "Jones", "Miller", "Davis", "Garcia", "Rodriguez", "Wilson"]
656
- name = f"{random.choice(first_names)} {random.choice(last_names)}"
657
-
658
- # Generate numeric ID - using Google-like ID format
659
- numeric_id = ''.join(random.choice('0123456789') for _ in range(id_length))
660
-
661
- # Generate future expiry date
662
- future_date = datetime.now() + timedelta(days=days_ahead)
663
- expiry = future_date.strftime('%Y-%m-%dT%H:%M:%S.%f')[:-3] + 'Z'
664
-
665
- # Generate random image ID for the new URL format
666
- chars = string.ascii_letters + string.digits + "-"
667
- random_img_id = ''.join(random.choice(chars) for _ in range(48))
668
- image_url = f"https://lh3.googleusercontent.com/a/ACg8oc{random_img_id}=s96-c"
669
-
670
- return {
671
- "user": {
672
- "name": name,
673
- "email": email,
674
- "image": image_url,
675
- "id": numeric_id
676
- },
677
- "expires": expiry,
678
- "isNewUser": False
679
- }
680
-
681
- def create_request_payload(
682
- self,
683
- messages: List[Dict[str, Any]],
684
- chat_id: str,
685
- system_message: str,
686
- max_tokens: int,
687
- temperature: Optional[float] = None,
688
- top_p: Optional[float] = None,
689
- session_data: Dict[str, Any] = None,
690
- model: str = None
691
- ) -> Dict[str, Any]:
692
- """Create the full request payload for the BlackboxAI API."""
693
- # Get the correct model ID and agent mode
694
- model_name = self.get_model(model or self.default_model)
695
- agent_mode = self.agentMode.get(model_name, {})
696
-
697
- # Generate a random customer ID for the subscription
698
- customer_id = "cus_" + ''.join(random.choice(string.ascii_letters + string.digits) for _ in range(14))
699
-
700
- # Create the full request payload
701
- return {
702
- "messages": messages,
703
- "agentMode": agent_mode,
704
- "id": chat_id,
705
- "previewToken": None,
706
- "userId": None,
707
- "codeModelMode": True,
708
- "trendingAgentMode": {},
709
- "isMicMode": False,
710
- "userSystemPrompt": system_message,
711
- "maxTokens": max_tokens,
712
- "playgroundTopP": top_p,
713
- "playgroundTemperature": temperature,
714
- "isChromeExt": False,
715
- "githubToken": "",
716
- "clickedAnswer2": False,
717
- "clickedAnswer3": False,
718
- "clickedForceWebSearch": False,
719
- "visitFromDelta": False,
720
- "isMemoryEnabled": False,
721
- "mobileClient": False,
722
- "userSelectedModel": model_name if model_name in self.userSelectedModel else None,
723
- "validated": "00f37b34-a166-4efb-bce5-1312d87f2f94",
724
- "imageGenerationMode": False,
725
- "webSearchModePrompt": False,
726
- "deepSearchMode": False,
727
- "designerMode": False,
728
- "domains": None,
729
- "vscodeClient": False,
730
- "codeInterpreterMode": False,
731
- "customProfile": {
732
- "name": "",
733
- "occupation": "",
734
- "traits": [],
735
- "additionalInfo": "",
736
- "enableNewChats": False
737
- },
738
- "webSearchModeOption": {
739
- "autoMode": True,
740
- "webMode": False,
741
- "offlineMode": False
742
- },
743
- "session": session_data,
744
- "isPremium": True,
745
- "subscriptionCache": {
746
- "status": "PREMIUM",
747
- "customerId": customer_id,
748
- "expiryTimestamp": int((datetime.now() + timedelta(days=30)).timestamp()),
749
- "lastChecked": int(datetime.now().timestamp() * 1000),
750
- "isTrialSubscription": True
751
- },
752
- "beastMode": False,
753
- "reasoningMode": False,
754
- "designerMode": False,
755
- "workspaceId": ""
756
- }
757
- if __name__ == "__main__":
758
- # Example usage
759
- client = BLACKBOXAI()
760
- response = client.chat.completions.create(
761
- model="GPT-4.1",
762
- messages=[{"role": "user", "content": "Tell me about india in points"}],
763
- stream=True
764
- )
765
- for chunk in response:
766
- print(chunk.choices[0].delta.content, end='', flush=True)