webscout 8.2.7__py3-none-any.whl → 8.2.8__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.

Potentially problematic release.


This version of webscout might be problematic. Click here for more details.

Files changed (323) hide show
  1. webscout/AIauto.py +1 -1
  2. webscout/AIutel.py +298 -249
  3. webscout/Extra/Act.md +309 -0
  4. webscout/Extra/GitToolkit/__init__.py +10 -0
  5. webscout/Extra/GitToolkit/gitapi/README.md +110 -0
  6. webscout/Extra/GitToolkit/gitapi/__init__.py +12 -0
  7. webscout/Extra/GitToolkit/gitapi/repository.py +195 -0
  8. webscout/Extra/GitToolkit/gitapi/user.py +96 -0
  9. webscout/Extra/GitToolkit/gitapi/utils.py +62 -0
  10. webscout/Extra/YTToolkit/README.md +375 -0
  11. webscout/Extra/YTToolkit/YTdownloader.py +957 -0
  12. webscout/Extra/YTToolkit/__init__.py +3 -0
  13. webscout/Extra/YTToolkit/transcriber.py +476 -0
  14. webscout/Extra/YTToolkit/ytapi/README.md +44 -0
  15. webscout/Extra/YTToolkit/ytapi/__init__.py +6 -0
  16. webscout/Extra/YTToolkit/ytapi/channel.py +307 -0
  17. webscout/Extra/YTToolkit/ytapi/errors.py +13 -0
  18. webscout/Extra/YTToolkit/ytapi/extras.py +118 -0
  19. webscout/Extra/YTToolkit/ytapi/https.py +88 -0
  20. webscout/Extra/YTToolkit/ytapi/patterns.py +61 -0
  21. webscout/Extra/YTToolkit/ytapi/playlist.py +59 -0
  22. webscout/Extra/YTToolkit/ytapi/pool.py +8 -0
  23. webscout/Extra/YTToolkit/ytapi/query.py +40 -0
  24. webscout/Extra/YTToolkit/ytapi/stream.py +63 -0
  25. webscout/Extra/YTToolkit/ytapi/utils.py +62 -0
  26. webscout/Extra/YTToolkit/ytapi/video.py +232 -0
  27. webscout/Extra/__init__.py +7 -0
  28. webscout/Extra/autocoder/__init__.py +9 -0
  29. webscout/Extra/autocoder/autocoder.py +1105 -0
  30. webscout/Extra/autocoder/autocoder_utiles.py +332 -0
  31. webscout/Extra/gguf.md +430 -0
  32. webscout/Extra/gguf.py +684 -0
  33. webscout/Extra/tempmail/README.md +488 -0
  34. webscout/Extra/tempmail/__init__.py +28 -0
  35. webscout/Extra/tempmail/async_utils.py +141 -0
  36. webscout/Extra/tempmail/base.py +161 -0
  37. webscout/Extra/tempmail/cli.py +187 -0
  38. webscout/Extra/tempmail/emailnator.py +84 -0
  39. webscout/Extra/tempmail/mail_tm.py +361 -0
  40. webscout/Extra/tempmail/temp_mail_io.py +292 -0
  41. webscout/Extra/weather.md +281 -0
  42. webscout/Extra/weather.py +194 -0
  43. webscout/Extra/weather_ascii.py +76 -0
  44. webscout/Litlogger/Readme.md +175 -0
  45. webscout/Litlogger/__init__.py +67 -0
  46. webscout/Litlogger/core/__init__.py +6 -0
  47. webscout/Litlogger/core/level.py +23 -0
  48. webscout/Litlogger/core/logger.py +165 -0
  49. webscout/Litlogger/handlers/__init__.py +12 -0
  50. webscout/Litlogger/handlers/console.py +33 -0
  51. webscout/Litlogger/handlers/file.py +143 -0
  52. webscout/Litlogger/handlers/network.py +173 -0
  53. webscout/Litlogger/styles/__init__.py +7 -0
  54. webscout/Litlogger/styles/colors.py +249 -0
  55. webscout/Litlogger/styles/formats.py +458 -0
  56. webscout/Litlogger/styles/text.py +87 -0
  57. webscout/Litlogger/utils/__init__.py +6 -0
  58. webscout/Litlogger/utils/detectors.py +153 -0
  59. webscout/Litlogger/utils/formatters.py +200 -0
  60. webscout/Provider/AI21.py +177 -0
  61. webscout/Provider/AISEARCH/DeepFind.py +254 -0
  62. webscout/Provider/AISEARCH/Perplexity.py +359 -0
  63. webscout/Provider/AISEARCH/README.md +279 -0
  64. webscout/Provider/AISEARCH/__init__.py +9 -0
  65. webscout/Provider/AISEARCH/felo_search.py +228 -0
  66. webscout/Provider/AISEARCH/genspark_search.py +350 -0
  67. webscout/Provider/AISEARCH/hika_search.py +198 -0
  68. webscout/Provider/AISEARCH/iask_search.py +436 -0
  69. webscout/Provider/AISEARCH/monica_search.py +246 -0
  70. webscout/Provider/AISEARCH/scira_search.py +324 -0
  71. webscout/Provider/AISEARCH/webpilotai_search.py +281 -0
  72. webscout/Provider/Aitopia.py +316 -0
  73. webscout/Provider/AllenAI.py +440 -0
  74. webscout/Provider/Andi.py +228 -0
  75. webscout/Provider/Blackboxai.py +673 -0
  76. webscout/Provider/ChatGPTClone.py +237 -0
  77. webscout/Provider/ChatGPTGratis.py +194 -0
  78. webscout/Provider/ChatSandbox.py +342 -0
  79. webscout/Provider/Cloudflare.py +324 -0
  80. webscout/Provider/Cohere.py +208 -0
  81. webscout/Provider/Deepinfra.py +340 -0
  82. webscout/Provider/ExaAI.py +261 -0
  83. webscout/Provider/ExaChat.py +358 -0
  84. webscout/Provider/Flowith.py +217 -0
  85. webscout/Provider/FreeGemini.py +250 -0
  86. webscout/Provider/Gemini.py +169 -0
  87. webscout/Provider/GithubChat.py +370 -0
  88. webscout/Provider/GizAI.py +295 -0
  89. webscout/Provider/Glider.py +225 -0
  90. webscout/Provider/Groq.py +801 -0
  91. webscout/Provider/HF_space/__init__.py +0 -0
  92. webscout/Provider/HF_space/qwen_qwen2.py +206 -0
  93. webscout/Provider/HeckAI.py +285 -0
  94. webscout/Provider/HuggingFaceChat.py +469 -0
  95. webscout/Provider/Hunyuan.py +283 -0
  96. webscout/Provider/Jadve.py +291 -0
  97. webscout/Provider/Koboldai.py +384 -0
  98. webscout/Provider/LambdaChat.py +411 -0
  99. webscout/Provider/Llama3.py +259 -0
  100. webscout/Provider/MCPCore.py +315 -0
  101. webscout/Provider/Marcus.py +198 -0
  102. webscout/Provider/Nemotron.py +218 -0
  103. webscout/Provider/Netwrck.py +270 -0
  104. webscout/Provider/OLLAMA.py +396 -0
  105. webscout/Provider/OPENAI/BLACKBOXAI.py +735 -0
  106. webscout/Provider/OPENAI/Cloudflare.py +378 -0
  107. webscout/Provider/OPENAI/FreeGemini.py +282 -0
  108. webscout/Provider/OPENAI/NEMOTRON.py +244 -0
  109. webscout/Provider/OPENAI/README.md +1253 -0
  110. webscout/Provider/OPENAI/__init__.py +36 -0
  111. webscout/Provider/OPENAI/ai4chat.py +293 -0
  112. webscout/Provider/OPENAI/api.py +810 -0
  113. webscout/Provider/OPENAI/base.py +249 -0
  114. webscout/Provider/OPENAI/c4ai.py +373 -0
  115. webscout/Provider/OPENAI/chatgpt.py +556 -0
  116. webscout/Provider/OPENAI/chatgptclone.py +488 -0
  117. webscout/Provider/OPENAI/chatsandbox.py +172 -0
  118. webscout/Provider/OPENAI/deepinfra.py +319 -0
  119. webscout/Provider/OPENAI/e2b.py +1356 -0
  120. webscout/Provider/OPENAI/exaai.py +411 -0
  121. webscout/Provider/OPENAI/exachat.py +443 -0
  122. webscout/Provider/OPENAI/flowith.py +162 -0
  123. webscout/Provider/OPENAI/freeaichat.py +359 -0
  124. webscout/Provider/OPENAI/glider.py +323 -0
  125. webscout/Provider/OPENAI/groq.py +361 -0
  126. webscout/Provider/OPENAI/heckai.py +307 -0
  127. webscout/Provider/OPENAI/llmchatco.py +335 -0
  128. webscout/Provider/OPENAI/mcpcore.py +383 -0
  129. webscout/Provider/OPENAI/multichat.py +376 -0
  130. webscout/Provider/OPENAI/netwrck.py +356 -0
  131. webscout/Provider/OPENAI/opkfc.py +496 -0
  132. webscout/Provider/OPENAI/scirachat.py +471 -0
  133. webscout/Provider/OPENAI/sonus.py +303 -0
  134. webscout/Provider/OPENAI/standardinput.py +433 -0
  135. webscout/Provider/OPENAI/textpollinations.py +339 -0
  136. webscout/Provider/OPENAI/toolbaz.py +413 -0
  137. webscout/Provider/OPENAI/typefully.py +355 -0
  138. webscout/Provider/OPENAI/typegpt.py +358 -0
  139. webscout/Provider/OPENAI/uncovrAI.py +462 -0
  140. webscout/Provider/OPENAI/utils.py +307 -0
  141. webscout/Provider/OPENAI/venice.py +425 -0
  142. webscout/Provider/OPENAI/wisecat.py +381 -0
  143. webscout/Provider/OPENAI/writecream.py +163 -0
  144. webscout/Provider/OPENAI/x0gpt.py +378 -0
  145. webscout/Provider/OPENAI/yep.py +356 -0
  146. webscout/Provider/OpenGPT.py +209 -0
  147. webscout/Provider/Openai.py +496 -0
  148. webscout/Provider/PI.py +429 -0
  149. webscout/Provider/Perplexitylabs.py +415 -0
  150. webscout/Provider/QwenLM.py +254 -0
  151. webscout/Provider/Reka.py +214 -0
  152. webscout/Provider/StandardInput.py +290 -0
  153. webscout/Provider/TTI/AiForce/README.md +159 -0
  154. webscout/Provider/TTI/AiForce/__init__.py +22 -0
  155. webscout/Provider/TTI/AiForce/async_aiforce.py +224 -0
  156. webscout/Provider/TTI/AiForce/sync_aiforce.py +245 -0
  157. webscout/Provider/TTI/FreeAIPlayground/README.md +99 -0
  158. webscout/Provider/TTI/FreeAIPlayground/__init__.py +9 -0
  159. webscout/Provider/TTI/FreeAIPlayground/async_freeaiplayground.py +181 -0
  160. webscout/Provider/TTI/FreeAIPlayground/sync_freeaiplayground.py +180 -0
  161. webscout/Provider/TTI/ImgSys/README.md +174 -0
  162. webscout/Provider/TTI/ImgSys/__init__.py +23 -0
  163. webscout/Provider/TTI/ImgSys/async_imgsys.py +202 -0
  164. webscout/Provider/TTI/ImgSys/sync_imgsys.py +195 -0
  165. webscout/Provider/TTI/MagicStudio/README.md +101 -0
  166. webscout/Provider/TTI/MagicStudio/__init__.py +2 -0
  167. webscout/Provider/TTI/MagicStudio/async_magicstudio.py +111 -0
  168. webscout/Provider/TTI/MagicStudio/sync_magicstudio.py +109 -0
  169. webscout/Provider/TTI/Nexra/README.md +155 -0
  170. webscout/Provider/TTI/Nexra/__init__.py +22 -0
  171. webscout/Provider/TTI/Nexra/async_nexra.py +286 -0
  172. webscout/Provider/TTI/Nexra/sync_nexra.py +258 -0
  173. webscout/Provider/TTI/PollinationsAI/README.md +146 -0
  174. webscout/Provider/TTI/PollinationsAI/__init__.py +23 -0
  175. webscout/Provider/TTI/PollinationsAI/async_pollinations.py +311 -0
  176. webscout/Provider/TTI/PollinationsAI/sync_pollinations.py +265 -0
  177. webscout/Provider/TTI/README.md +128 -0
  178. webscout/Provider/TTI/__init__.py +12 -0
  179. webscout/Provider/TTI/aiarta/README.md +134 -0
  180. webscout/Provider/TTI/aiarta/__init__.py +2 -0
  181. webscout/Provider/TTI/aiarta/async_aiarta.py +482 -0
  182. webscout/Provider/TTI/aiarta/sync_aiarta.py +440 -0
  183. webscout/Provider/TTI/artbit/README.md +100 -0
  184. webscout/Provider/TTI/artbit/__init__.py +22 -0
  185. webscout/Provider/TTI/artbit/async_artbit.py +155 -0
  186. webscout/Provider/TTI/artbit/sync_artbit.py +148 -0
  187. webscout/Provider/TTI/fastflux/README.md +129 -0
  188. webscout/Provider/TTI/fastflux/__init__.py +22 -0
  189. webscout/Provider/TTI/fastflux/async_fastflux.py +261 -0
  190. webscout/Provider/TTI/fastflux/sync_fastflux.py +252 -0
  191. webscout/Provider/TTI/huggingface/README.md +114 -0
  192. webscout/Provider/TTI/huggingface/__init__.py +22 -0
  193. webscout/Provider/TTI/huggingface/async_huggingface.py +199 -0
  194. webscout/Provider/TTI/huggingface/sync_huggingface.py +195 -0
  195. webscout/Provider/TTI/piclumen/README.md +161 -0
  196. webscout/Provider/TTI/piclumen/__init__.py +23 -0
  197. webscout/Provider/TTI/piclumen/async_piclumen.py +268 -0
  198. webscout/Provider/TTI/piclumen/sync_piclumen.py +233 -0
  199. webscout/Provider/TTI/pixelmuse/README.md +79 -0
  200. webscout/Provider/TTI/pixelmuse/__init__.py +4 -0
  201. webscout/Provider/TTI/pixelmuse/async_pixelmuse.py +249 -0
  202. webscout/Provider/TTI/pixelmuse/sync_pixelmuse.py +182 -0
  203. webscout/Provider/TTI/talkai/README.md +139 -0
  204. webscout/Provider/TTI/talkai/__init__.py +4 -0
  205. webscout/Provider/TTI/talkai/async_talkai.py +229 -0
  206. webscout/Provider/TTI/talkai/sync_talkai.py +207 -0
  207. webscout/Provider/TTS/README.md +192 -0
  208. webscout/Provider/TTS/__init__.py +9 -0
  209. webscout/Provider/TTS/base.py +159 -0
  210. webscout/Provider/TTS/deepgram.py +156 -0
  211. webscout/Provider/TTS/elevenlabs.py +111 -0
  212. webscout/Provider/TTS/gesserit.py +128 -0
  213. webscout/Provider/TTS/murfai.py +113 -0
  214. webscout/Provider/TTS/parler.py +111 -0
  215. webscout/Provider/TTS/speechma.py +580 -0
  216. webscout/Provider/TTS/sthir.py +94 -0
  217. webscout/Provider/TTS/streamElements.py +333 -0
  218. webscout/Provider/TTS/utils.py +280 -0
  219. webscout/Provider/TeachAnything.py +229 -0
  220. webscout/Provider/TextPollinationsAI.py +308 -0
  221. webscout/Provider/TwoAI.py +280 -0
  222. webscout/Provider/TypliAI.py +305 -0
  223. webscout/Provider/UNFINISHED/ChatHub.py +209 -0
  224. webscout/Provider/UNFINISHED/Youchat.py +330 -0
  225. webscout/Provider/UNFINISHED/liner_api_request.py +263 -0
  226. webscout/Provider/UNFINISHED/oivscode.py +351 -0
  227. webscout/Provider/UNFINISHED/test_lmarena.py +119 -0
  228. webscout/Provider/Venice.py +258 -0
  229. webscout/Provider/VercelAI.py +253 -0
  230. webscout/Provider/WiseCat.py +233 -0
  231. webscout/Provider/WrDoChat.py +370 -0
  232. webscout/Provider/Writecream.py +246 -0
  233. webscout/Provider/WritingMate.py +269 -0
  234. webscout/Provider/__init__.py +172 -0
  235. webscout/Provider/ai4chat.py +149 -0
  236. webscout/Provider/akashgpt.py +335 -0
  237. webscout/Provider/asksteve.py +220 -0
  238. webscout/Provider/cerebras.py +290 -0
  239. webscout/Provider/chatglm.py +215 -0
  240. webscout/Provider/cleeai.py +213 -0
  241. webscout/Provider/copilot.py +425 -0
  242. webscout/Provider/elmo.py +283 -0
  243. webscout/Provider/freeaichat.py +285 -0
  244. webscout/Provider/geminiapi.py +208 -0
  245. webscout/Provider/granite.py +235 -0
  246. webscout/Provider/hermes.py +266 -0
  247. webscout/Provider/julius.py +223 -0
  248. webscout/Provider/koala.py +170 -0
  249. webscout/Provider/learnfastai.py +325 -0
  250. webscout/Provider/llama3mitril.py +215 -0
  251. webscout/Provider/llmchat.py +258 -0
  252. webscout/Provider/llmchatco.py +306 -0
  253. webscout/Provider/lmarena.py +198 -0
  254. webscout/Provider/meta.py +801 -0
  255. webscout/Provider/multichat.py +364 -0
  256. webscout/Provider/samurai.py +223 -0
  257. webscout/Provider/scira_chat.py +299 -0
  258. webscout/Provider/scnet.py +243 -0
  259. webscout/Provider/searchchat.py +292 -0
  260. webscout/Provider/sonus.py +258 -0
  261. webscout/Provider/talkai.py +194 -0
  262. webscout/Provider/toolbaz.py +353 -0
  263. webscout/Provider/turboseek.py +266 -0
  264. webscout/Provider/typefully.py +202 -0
  265. webscout/Provider/typegpt.py +289 -0
  266. webscout/Provider/uncovr.py +368 -0
  267. webscout/Provider/x0gpt.py +299 -0
  268. webscout/Provider/yep.py +389 -0
  269. webscout/__init__.py +4 -2
  270. webscout/cli.py +3 -28
  271. webscout/conversation.py +35 -35
  272. webscout/litagent/Readme.md +276 -0
  273. webscout/litagent/__init__.py +29 -0
  274. webscout/litagent/agent.py +455 -0
  275. webscout/litagent/constants.py +60 -0
  276. webscout/litprinter/__init__.py +59 -0
  277. webscout/scout/README.md +402 -0
  278. webscout/scout/__init__.py +8 -0
  279. webscout/scout/core/__init__.py +7 -0
  280. webscout/scout/core/crawler.py +140 -0
  281. webscout/scout/core/scout.py +568 -0
  282. webscout/scout/core/search_result.py +96 -0
  283. webscout/scout/core/text_analyzer.py +63 -0
  284. webscout/scout/core/text_utils.py +277 -0
  285. webscout/scout/core/web_analyzer.py +52 -0
  286. webscout/scout/element.py +460 -0
  287. webscout/scout/parsers/__init__.py +69 -0
  288. webscout/scout/parsers/html5lib_parser.py +172 -0
  289. webscout/scout/parsers/html_parser.py +236 -0
  290. webscout/scout/parsers/lxml_parser.py +178 -0
  291. webscout/scout/utils.py +37 -0
  292. webscout/swiftcli/Readme.md +323 -0
  293. webscout/swiftcli/__init__.py +95 -0
  294. webscout/swiftcli/core/__init__.py +7 -0
  295. webscout/swiftcli/core/cli.py +297 -0
  296. webscout/swiftcli/core/context.py +104 -0
  297. webscout/swiftcli/core/group.py +241 -0
  298. webscout/swiftcli/decorators/__init__.py +28 -0
  299. webscout/swiftcli/decorators/command.py +221 -0
  300. webscout/swiftcli/decorators/options.py +220 -0
  301. webscout/swiftcli/decorators/output.py +252 -0
  302. webscout/swiftcli/exceptions.py +21 -0
  303. webscout/swiftcli/plugins/__init__.py +9 -0
  304. webscout/swiftcli/plugins/base.py +135 -0
  305. webscout/swiftcli/plugins/manager.py +262 -0
  306. webscout/swiftcli/utils/__init__.py +59 -0
  307. webscout/swiftcli/utils/formatting.py +252 -0
  308. webscout/swiftcli/utils/parsing.py +267 -0
  309. webscout/version.py +1 -1
  310. webscout/webscout_search.py +2 -182
  311. webscout/webscout_search_async.py +1 -179
  312. webscout/zeroart/README.md +89 -0
  313. webscout/zeroart/__init__.py +135 -0
  314. webscout/zeroart/base.py +66 -0
  315. webscout/zeroart/effects.py +101 -0
  316. webscout/zeroart/fonts.py +1239 -0
  317. {webscout-8.2.7.dist-info → webscout-8.2.8.dist-info}/METADATA +115 -60
  318. webscout-8.2.8.dist-info/RECORD +334 -0
  319. {webscout-8.2.7.dist-info → webscout-8.2.8.dist-info}/WHEEL +1 -1
  320. webscout-8.2.7.dist-info/RECORD +0 -26
  321. {webscout-8.2.7.dist-info → webscout-8.2.8.dist-info}/entry_points.txt +0 -0
  322. {webscout-8.2.7.dist-info → webscout-8.2.8.dist-info}/licenses/LICENSE.md +0 -0
  323. {webscout-8.2.7.dist-info → webscout-8.2.8.dist-info}/top_level.txt +0 -0
@@ -0,0 +1,209 @@
1
+ import requests
2
+ import json
3
+ import os
4
+ from typing import Any, Dict, Optional, Generator, List, Union
5
+
6
+ from webscout.AIutel import Optimizers
7
+ from webscout.AIutel import Conversation
8
+ from webscout.AIutel import AwesomePrompts, sanitize_stream
9
+ from webscout.AIbase import Provider, AsyncProvider
10
+ from webscout import exceptions
11
+
12
+ class ChatHub(Provider):
13
+ """
14
+ A class to interact with the ChatHub API.
15
+ """
16
+
17
+ AVAILABLE_MODELS = [
18
+ 'meta/llama3.1-8b',
19
+ 'mistral/mixtral-8x7b',
20
+ 'google/gemma-2',
21
+ 'perplexity/sonar-online',
22
+ ]
23
+ model_aliases = { # Aliases for shorter model names
24
+ "llama3.1-8b": 'meta/llama3.1-8b',
25
+ "mixtral-8x7b": 'mistral/mixtral-8x7b',
26
+ "gemma-2": 'google/gemma-2',
27
+ "sonar-online": 'perplexity/sonar-online',
28
+ }
29
+
30
+
31
+ def __init__(
32
+ self,
33
+ is_conversation: bool = True,
34
+ max_tokens: int = 2049,
35
+ timeout: int = 30,
36
+ intro: str = None,
37
+ filepath: str = None,
38
+ update_file: bool = True,
39
+ proxies: dict = {},
40
+ history_offset: int = 10250,
41
+ act: str = None,
42
+ model: str = "sonar-online",
43
+ ):
44
+ """Initializes the ChatHub API client."""
45
+ self.url = "https://app.chathub.gg"
46
+ self.api_endpoint = "https://app.chathub.gg/api/v3/chat/completions"
47
+ self.headers = {
48
+ 'Accept': '*/*',
49
+ 'Accept-Language': 'en-US,en;q=0.9',
50
+ 'Content-Type': 'application/json',
51
+ 'Origin': self.url,
52
+ 'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.0.0 Safari/537.36',
53
+ 'X-App-Id': 'web'
54
+ }
55
+ self.session = requests.Session()
56
+ self.session.headers.update(self.headers)
57
+ self.session.proxies.update(proxies)
58
+ self.timeout = timeout
59
+ self.last_response = {}
60
+
61
+ self.is_conversation = is_conversation
62
+ self.max_tokens_to_sample = max_tokens
63
+ self.__available_optimizers = (
64
+ method
65
+ for method in dir(Optimizers)
66
+ if callable(getattr(Optimizers, method)) and not method.startswith("__")
67
+ )
68
+ Conversation.intro = (
69
+ AwesomePrompts().get_act(
70
+ act, raise_not_found=True, default=None, case_insensitive=True
71
+ )
72
+ if act
73
+ else intro or Conversation.intro
74
+ )
75
+
76
+ self.conversation = Conversation(
77
+ is_conversation, self.max_tokens_to_sample, filepath, update_file
78
+ )
79
+ self.conversation.history_offset = history_offset
80
+
81
+ #Resolve the model
82
+ self.model = self.get_model(model)
83
+
84
+
85
+ def get_model(self, model: str) -> str:
86
+ """
87
+ Resolves the model name using aliases or defaults.
88
+ """
89
+
90
+ if model in self.AVAILABLE_MODELS:
91
+ return model
92
+ elif model in self.model_aliases:
93
+ return self.model_aliases[model]
94
+ else:
95
+ print(f"Model '{model}' not found. Using default model '{self.default_model}'.")
96
+ return self.default_model # Use class-level default
97
+
98
+ def ask(
99
+ self,
100
+ prompt: str,
101
+ stream: bool = False,
102
+ raw: bool = False,
103
+ optimizer: str = None,
104
+ conversationally: bool = False,
105
+ ) -> Union[Dict[str, Any], Generator]:
106
+
107
+ conversation_prompt = self.conversation.gen_complete_prompt(prompt)
108
+ if optimizer:
109
+ if optimizer in self.__available_optimizers:
110
+ conversation_prompt = getattr(Optimizers, optimizer)(
111
+ conversation_prompt if conversationally else prompt
112
+ )
113
+ else:
114
+ raise Exception(f"Optimizer is not one of {self.__available_optimizers}")
115
+
116
+
117
+ data = {
118
+ "model": self.model,
119
+ "messages": [{"role": "user", "content": conversation_prompt}],
120
+ "tools": []
121
+ }
122
+
123
+ # Set the Referer header dynamically based on the resolved model
124
+ self.headers['Referer'] = f"{self.url}/chat/{self.model}"
125
+
126
+
127
+ def for_stream():
128
+ try:
129
+ with requests.post(self.api_endpoint, headers=self.headers, json=data, stream=True, timeout=self.timeout) as response:
130
+ response.raise_for_status()
131
+ streaming_text = ""
132
+
133
+ for line in response.iter_lines(decode_unicode=True):
134
+ if line:
135
+ decoded_line = line.strip()
136
+ if decoded_line.startswith('data:'):
137
+ data_str = decoded_line[5:].strip()
138
+ if data_str == '[DONE]':
139
+ break
140
+ try:
141
+ data_json = json.loads(data_str)
142
+ text_delta = data_json.get('textDelta')
143
+ if text_delta:
144
+ streaming_text += text_delta
145
+ resp = dict(text=text_delta)
146
+ yield resp if raw else resp
147
+
148
+ except json.JSONDecodeError:
149
+ continue
150
+ self.conversation.update_chat_history(prompt, streaming_text)
151
+ self.last_response.update({"text": streaming_text})
152
+ except requests.exceptions.RequestException as e:
153
+ raise exceptions.FailedToGenerateResponseError(f"Request error: {e}")
154
+
155
+
156
+ def for_non_stream():
157
+ for _ in for_stream():
158
+ pass
159
+ return self.last_response
160
+
161
+ return for_stream() if stream else for_non_stream()
162
+
163
+
164
+
165
+
166
+ def chat(
167
+ self,
168
+ prompt: str,
169
+ stream: bool = False,
170
+ optimizer: str = None,
171
+ conversationally: bool = False,
172
+ ) -> Union[str, Generator]:
173
+ """Generate response `str`"""
174
+
175
+ def for_stream():
176
+ for response in self.ask(
177
+ prompt, stream=True, optimizer=optimizer, conversationally=conversationally
178
+ ):
179
+ yield self.get_message(response)
180
+
181
+ def for_non_stream():
182
+ return self.get_message(
183
+ self.ask(
184
+ prompt,
185
+ stream=False, # Pass stream=False
186
+ optimizer=optimizer,
187
+ conversationally=conversationally,
188
+ )
189
+ )
190
+
191
+ return for_stream() if stream else for_non_stream()
192
+
193
+
194
+
195
+ def get_message(self, response: dict) -> str:
196
+ """Retrieves message only from response"""
197
+ assert isinstance(response, dict), "Response should be of dict data-type only"
198
+ return response.get("text", "")
199
+
200
+
201
+ if __name__ == "__main__":
202
+ from rich import print
203
+ bot = ChatHub()
204
+ try:
205
+ response = bot.chat("tell me about Abhay koul, HelpingAI", stream=True)
206
+ for chunk in response:
207
+ print(chunk, end="", flush=True)
208
+ except Exception as e:
209
+ print(f"An error occurred: {e}")
@@ -0,0 +1,330 @@
1
+ from uuid import uuid4
2
+ import json
3
+ import datetime
4
+ from webscout.AIutel import Optimizers
5
+ from webscout.AIutel import Conversation
6
+ from webscout.AIutel import AwesomePrompts
7
+ from webscout.AIbase import Provider
8
+ from webscout import exceptions
9
+ import cloudscraper
10
+
11
+
12
+ class YouChat(Provider):
13
+ """
14
+ This class provides methods for interacting with the You.com chat API in a consistent provider structure.
15
+ """
16
+
17
+ # Updated available models based on latest aiModels list
18
+ # All models with isProOnly: false are included
19
+ AVAILABLE_MODELS = [
20
+ # ProOnly models (not available without subscription)
21
+ # "gpt_4_5_preview", # isProOnly: true
22
+ # "openai_o3_mini_high", # isProOnly: true
23
+ # "openai_o3_mini_medium", # isProOnly: true
24
+ # "openai_o1", # isProOnly: true
25
+ # "openai_o1_preview", # isProOnly: true
26
+ # "openai_o1_mini", # isProOnly: true
27
+ # "gpt_4", # isProOnly: true
28
+ # "claude_3_7_sonnet_thinking", # isProOnly: true
29
+ # "claude_3_7_sonnet", # isProOnly: true
30
+ # "claude_3_5_sonnet", # isProOnly: true
31
+ # "claude_3_opus", # isProOnly: true
32
+ # "qwq_32b", # isProOnly: true
33
+ # "deepseek_r1", # isProOnly: true
34
+ # "deepseek_v3", # isProOnly: true
35
+ # "gemini_2_5_pro_experimental", # isProOnly: true
36
+
37
+ # Free models (isProOnly: false)
38
+ "gpt_4o_mini",
39
+ "gpt_4o",
40
+ "gpt_4_turbo",
41
+ "claude_3_sonnet",
42
+ "claude_3_5_haiku",
43
+ "qwen2p5_72b",
44
+ "qwen2p5_coder_32b",
45
+ "gemini_2_flash",
46
+ "gemini_1_5_flash",
47
+ "gemini_1_5_pro",
48
+ "grok_2",
49
+ "llama4_maverick",
50
+ "llama4_scout",
51
+ "llama3_1_405b",
52
+ "mistral_large_2",
53
+ "command_r_plus",
54
+
55
+ # Free models not enabled for user chat modes
56
+ "llama3_3_70b", # isAllowedForUserChatModes: false
57
+ "llama3_2_90b", # isAllowedForUserChatModes: false
58
+ "databricks_dbrx_instruct", # isAllowedForUserChatModes: false
59
+ "solar_1_mini", # isAllowedForUserChatModes: false
60
+ "dolphin_2_5", # isAllowedForUserChatModes: false, isUncensoredModel: true
61
+ ]
62
+
63
+ def __init__(
64
+ self,
65
+ is_conversation: bool = True,
66
+ max_tokens: int = 600,
67
+ timeout: int = 30,
68
+ intro: str = None,
69
+ filepath: str = None,
70
+ update_file: bool = True,
71
+ proxies: dict = {},
72
+ history_offset: int = 10250,
73
+ act: str = None,
74
+ model: str = "gemini_2_flash",
75
+ ):
76
+ """Instantiates YouChat
77
+
78
+ Args:
79
+ is_conversation (bool, optional): Flag for chatting conversationally. Defaults to True.
80
+ max_tokens (int, optional): Maximum number of tokens to be generated upon completion. Defaults to 600.
81
+ timeout (int, optional): Http request timeout. Defaults to 30.
82
+ intro (str, optional): Conversation introductory prompt. Defaults to None.
83
+ filepath (str, optional): Path to file containing conversation history. Defaults to None.
84
+ update_file (bool, optional): Add new prompts and responses to the file. Defaults to True.
85
+ proxies (dict, optional): Http request proxies. Defaults to {}.
86
+ history_offset (int, optional): Limit conversation history to this number of last texts. Defaults to 10250.
87
+ act (str|int, optional): Awesome prompt key or index. (Used as intro). Defaults to None.
88
+ model (str, optional): Model to use. Defaults to "gemini_2_flash".
89
+ """
90
+ if model not in self.AVAILABLE_MODELS:
91
+ raise ValueError(f"Invalid model: {model}. Choose from: {self.AVAILABLE_MODELS}")
92
+
93
+ self.session = cloudscraper.create_scraper() # Create a Cloudscraper session
94
+ self.is_conversation = is_conversation
95
+ self.max_tokens_to_sample = max_tokens
96
+ self.chat_endpoint = "https://you.com/api/streamingSearch"
97
+ self.stream_chunk_size = 64
98
+ self.timeout = timeout
99
+ self.last_response = {}
100
+ self.model = model
101
+ self.headers = {
102
+ "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36 Edg/135.0.0.0",
103
+ "Accept": "text/event-stream",
104
+ "Accept-Language": "en-US,en;q=0.9,en-IN;q=0.8",
105
+ "Referer": "https://you.com/search?q=hi&fromSearchBar=true&tbm=youchat",
106
+ "Connection": "keep-alive",
107
+ "DNT": "1",
108
+ "Content-Type": "text/plain;charset=UTF-8",
109
+ }
110
+ self.cookies = {
111
+ "uuid_guest": uuid4().hex,
112
+ "uuid_guest_backup": uuid4().hex,
113
+ "youchat_personalization": "true",
114
+ "youchat_smart_learn": "true",
115
+ "youpro_subscription": "false",
116
+ "you_subscription": "freemium",
117
+ "safesearch_guest": "Moderate",
118
+ "__cf_bm": uuid4().hex,
119
+ }
120
+
121
+ self.__available_optimizers = (
122
+ method
123
+ for method in dir(Optimizers)
124
+ if callable(getattr(Optimizers, method)) and not method.startswith("__")
125
+ )
126
+ Conversation.intro = (
127
+ AwesomePrompts().get_act(
128
+ act, raise_not_found=True, default=None, case_insensitive=True
129
+ )
130
+ if act
131
+ else intro or Conversation.intro
132
+ )
133
+ self.conversation = Conversation(
134
+ is_conversation, self.max_tokens_to_sample, filepath, update_file
135
+ )
136
+ self.conversation.history_offset = history_offset
137
+ self.session.proxies = proxies
138
+
139
+ def ask(
140
+ self,
141
+ prompt: str,
142
+ stream: bool = False,
143
+ raw: bool = False,
144
+ optimizer: str = None,
145
+ conversationally: bool = False,
146
+ ) -> dict:
147
+ """Chat with AI
148
+
149
+ Args:
150
+ prompt (str): Prompt to be send.
151
+ stream (bool, optional): Flag for streaming response. Defaults to False.
152
+ raw (bool, optional): Stream back raw response as received. Defaults to False.
153
+ optimizer (str, optional): Prompt optimizer name - `[code, shell_command]`. Defaults to None.
154
+ conversationally (bool, optional): Chat conversationally when using optimizer. Defaults to False.
155
+ Returns:
156
+ dict : {}
157
+ ```json
158
+ {
159
+ "text" : "How may I assist you today?"
160
+ }
161
+ ```
162
+ """
163
+ conversation_prompt = self.conversation.gen_complete_prompt(prompt)
164
+ if optimizer:
165
+ if optimizer in self.__available_optimizers:
166
+ conversation_prompt = getattr(Optimizers, optimizer)(
167
+ conversation_prompt if conversationally else prompt
168
+ )
169
+ else:
170
+ raise Exception(
171
+ f"Optimizer is not one of {self.__available_optimizers}"
172
+ )
173
+
174
+ trace_id = str(uuid4())
175
+ conversation_turn_id = str(uuid4())
176
+
177
+ # Current timestamp in ISO format for traceId
178
+ current_time = datetime.datetime.now().isoformat()
179
+
180
+ # Updated query parameters to match the new API format
181
+ params = {
182
+ "page": 1,
183
+ "count": 10,
184
+ "safeSearch": "Moderate",
185
+ "mkt": "en-IN",
186
+ "enable_worklow_generation_ux": "true",
187
+ "domain": "youchat",
188
+ "use_personalization_extraction": "true",
189
+ "queryTraceId": trace_id,
190
+ "chatId": trace_id,
191
+ "conversationTurnId": conversation_turn_id,
192
+ "pastChatLength": len(self.conversation.history) if hasattr(self.conversation, "history") else 0,
193
+ "selectedChatMode": "custom",
194
+ "selectedAiModel": self.model,
195
+ # "enable_agent_clarification_questions": "true",
196
+ "traceId": f"{trace_id}|{conversation_turn_id}|{current_time}",
197
+ "use_nested_youchat_updates": "true"
198
+ }
199
+
200
+ # New payload format is JSON
201
+ payload = {
202
+ "query": conversation_prompt,
203
+ "chat": "[]"
204
+ }
205
+
206
+ def for_stream():
207
+ response = self.session.post(
208
+ self.chat_endpoint,
209
+ headers=self.headers,
210
+ cookies=self.cookies,
211
+ params=params,
212
+ data=json.dumps(payload),
213
+ stream=True,
214
+ timeout=self.timeout
215
+ )
216
+ if not response.ok:
217
+ raise exceptions.FailedToGenerateResponseError(
218
+ f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
219
+ )
220
+
221
+ streaming_text = ""
222
+ # New SSE event-based parsing
223
+ event_type = None
224
+ for value in response.iter_lines(
225
+ decode_unicode=True,
226
+ chunk_size=self.stream_chunk_size,
227
+ delimiter="\n",
228
+ ):
229
+ if not value:
230
+ continue
231
+ if value.startswith("event: "):
232
+ event_type = value[7:].strip()
233
+ continue
234
+ if value.startswith("data: "):
235
+ data_str = value[6:]
236
+ if event_type == "youChatToken":
237
+ try:
238
+ data = json.loads(data_str)
239
+ token = data.get("youChatToken", "")
240
+ if token:
241
+ streaming_text += token
242
+ yield token if raw else dict(text=token)
243
+ except Exception:
244
+ pass
245
+ # Reset event_type after processing
246
+ event_type = None
247
+
248
+ self.last_response.update(dict(text=streaming_text))
249
+ self.conversation.update_chat_history(
250
+ prompt, self.get_message(self.last_response)
251
+ )
252
+
253
+ def for_non_stream():
254
+ for _ in for_stream():
255
+ pass
256
+ return self.last_response
257
+
258
+ return for_stream() if stream else for_non_stream()
259
+
260
+ def chat(
261
+ self,
262
+ prompt: str,
263
+ stream: bool = False,
264
+ optimizer: str = None,
265
+ conversationally: bool = False,
266
+ ) -> str:
267
+ """Generate response `str`
268
+ Args:
269
+ prompt (str): Prompt to be send.
270
+ stream (bool, optional): Flag for streaming response. Defaults to False.
271
+ optimizer (str, optional): Prompt optimizer name - `[code, shell_command]`. Defaults to None.
272
+ conversationally (bool, optional): Chat conversationally when using optimizer. Defaults to False.
273
+ Returns:
274
+ str: Response generated
275
+ """
276
+
277
+ def for_stream():
278
+ for response in self.ask(
279
+ prompt, True, optimizer=optimizer, conversationally=conversationally
280
+ ):
281
+ yield self.get_message(response)
282
+
283
+ def for_non_stream():
284
+ return self.get_message(
285
+ self.ask(
286
+ prompt,
287
+ False,
288
+ optimizer=optimizer,
289
+ conversationally=conversationally,
290
+ )
291
+ )
292
+
293
+ return for_stream() if stream else for_non_stream()
294
+
295
+ def get_message(self, response: dict) -> str:
296
+ """Retrieves message only from response
297
+
298
+ str: Message extracted
299
+ """
300
+ assert isinstance(response, dict), "Response should be of dict data-type only"
301
+ return response["text"]
302
+
303
+ if __name__ == '__main__':
304
+ print("-" * 80)
305
+ print(f"{'Model':<50} {'Status':<10} {'Response'}")
306
+ print("-" * 80)
307
+
308
+ # Test all available models
309
+ working = 0
310
+ total = len(YouChat.AVAILABLE_MODELS)
311
+
312
+ for model in YouChat.AVAILABLE_MODELS:
313
+ try:
314
+ test_ai = YouChat(model=model, timeout=60)
315
+ response = test_ai.chat("Say 'Hello' in one word", stream=True)
316
+ response_text = ""
317
+ for chunk in response:
318
+ response_text += chunk
319
+ print(f"\r{model:<50} {'Testing...':<10}", end="", flush=True)
320
+
321
+ if response_text and len(response_text.strip()) > 0:
322
+ status = "✓"
323
+ # Truncate response if too long
324
+ display_text = response_text.strip()[:50] + "..." if len(response_text.strip()) > 50 else response_text.strip()
325
+ else:
326
+ status = "✗"
327
+ display_text = "Empty or invalid response"
328
+ print(f"\r{model:<50} {status:<10} {display_text}")
329
+ except Exception as e:
330
+ print(f"\r{model:<50} {'✗':<10} {str(e)}")