webscout 8.2.7__py3-none-any.whl → 8.2.9__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 (281) hide show
  1. webscout/AIauto.py +33 -15
  2. webscout/AIbase.py +96 -37
  3. webscout/AIutel.py +703 -250
  4. webscout/Bard.py +441 -323
  5. webscout/Extra/Act.md +309 -0
  6. webscout/Extra/GitToolkit/__init__.py +10 -0
  7. webscout/Extra/GitToolkit/gitapi/README.md +110 -0
  8. webscout/Extra/GitToolkit/gitapi/__init__.py +12 -0
  9. webscout/Extra/GitToolkit/gitapi/repository.py +195 -0
  10. webscout/Extra/GitToolkit/gitapi/user.py +96 -0
  11. webscout/Extra/GitToolkit/gitapi/utils.py +62 -0
  12. webscout/Extra/YTToolkit/README.md +375 -0
  13. webscout/Extra/YTToolkit/YTdownloader.py +957 -0
  14. webscout/Extra/YTToolkit/__init__.py +3 -0
  15. webscout/Extra/YTToolkit/transcriber.py +476 -0
  16. webscout/Extra/YTToolkit/ytapi/README.md +44 -0
  17. webscout/Extra/YTToolkit/ytapi/__init__.py +6 -0
  18. webscout/Extra/YTToolkit/ytapi/channel.py +307 -0
  19. webscout/Extra/YTToolkit/ytapi/errors.py +13 -0
  20. webscout/Extra/YTToolkit/ytapi/extras.py +118 -0
  21. webscout/Extra/YTToolkit/ytapi/https.py +88 -0
  22. webscout/Extra/YTToolkit/ytapi/patterns.py +61 -0
  23. webscout/Extra/YTToolkit/ytapi/playlist.py +59 -0
  24. webscout/Extra/YTToolkit/ytapi/pool.py +8 -0
  25. webscout/Extra/YTToolkit/ytapi/query.py +40 -0
  26. webscout/Extra/YTToolkit/ytapi/stream.py +63 -0
  27. webscout/Extra/YTToolkit/ytapi/utils.py +62 -0
  28. webscout/Extra/YTToolkit/ytapi/video.py +232 -0
  29. webscout/Extra/__init__.py +7 -0
  30. webscout/Extra/autocoder/__init__.py +9 -0
  31. webscout/Extra/autocoder/autocoder.py +1105 -0
  32. webscout/Extra/autocoder/autocoder_utiles.py +332 -0
  33. webscout/Extra/gguf.md +430 -0
  34. webscout/Extra/gguf.py +684 -0
  35. webscout/Extra/tempmail/README.md +488 -0
  36. webscout/Extra/tempmail/__init__.py +28 -0
  37. webscout/Extra/tempmail/async_utils.py +141 -0
  38. webscout/Extra/tempmail/base.py +161 -0
  39. webscout/Extra/tempmail/cli.py +187 -0
  40. webscout/Extra/tempmail/emailnator.py +84 -0
  41. webscout/Extra/tempmail/mail_tm.py +361 -0
  42. webscout/Extra/tempmail/temp_mail_io.py +292 -0
  43. webscout/Extra/weather.md +281 -0
  44. webscout/Extra/weather.py +194 -0
  45. webscout/Extra/weather_ascii.py +76 -0
  46. webscout/Litlogger/README.md +10 -0
  47. webscout/Litlogger/__init__.py +15 -0
  48. webscout/Litlogger/formats.py +4 -0
  49. webscout/Litlogger/handlers.py +103 -0
  50. webscout/Litlogger/levels.py +13 -0
  51. webscout/Litlogger/logger.py +92 -0
  52. webscout/Provider/AI21.py +177 -0
  53. webscout/Provider/AISEARCH/DeepFind.py +254 -0
  54. webscout/Provider/AISEARCH/Perplexity.py +333 -0
  55. webscout/Provider/AISEARCH/README.md +279 -0
  56. webscout/Provider/AISEARCH/__init__.py +9 -0
  57. webscout/Provider/AISEARCH/felo_search.py +202 -0
  58. webscout/Provider/AISEARCH/genspark_search.py +324 -0
  59. webscout/Provider/AISEARCH/hika_search.py +186 -0
  60. webscout/Provider/AISEARCH/iask_search.py +410 -0
  61. webscout/Provider/AISEARCH/monica_search.py +220 -0
  62. webscout/Provider/AISEARCH/scira_search.py +298 -0
  63. webscout/Provider/AISEARCH/webpilotai_search.py +255 -0
  64. webscout/Provider/Aitopia.py +316 -0
  65. webscout/Provider/AllenAI.py +440 -0
  66. webscout/Provider/Andi.py +228 -0
  67. webscout/Provider/Blackboxai.py +791 -0
  68. webscout/Provider/ChatGPTClone.py +237 -0
  69. webscout/Provider/ChatGPTGratis.py +194 -0
  70. webscout/Provider/ChatSandbox.py +342 -0
  71. webscout/Provider/Cloudflare.py +324 -0
  72. webscout/Provider/Cohere.py +208 -0
  73. webscout/Provider/Deepinfra.py +340 -0
  74. webscout/Provider/ExaAI.py +261 -0
  75. webscout/Provider/ExaChat.py +358 -0
  76. webscout/Provider/Flowith.py +217 -0
  77. webscout/Provider/FreeGemini.py +250 -0
  78. webscout/Provider/Gemini.py +169 -0
  79. webscout/Provider/GithubChat.py +369 -0
  80. webscout/Provider/GizAI.py +295 -0
  81. webscout/Provider/Glider.py +225 -0
  82. webscout/Provider/Groq.py +801 -0
  83. webscout/Provider/HF_space/__init__.py +0 -0
  84. webscout/Provider/HF_space/qwen_qwen2.py +206 -0
  85. webscout/Provider/HeckAI.py +375 -0
  86. webscout/Provider/HuggingFaceChat.py +469 -0
  87. webscout/Provider/Hunyuan.py +283 -0
  88. webscout/Provider/Jadve.py +291 -0
  89. webscout/Provider/Koboldai.py +384 -0
  90. webscout/Provider/LambdaChat.py +411 -0
  91. webscout/Provider/Llama3.py +259 -0
  92. webscout/Provider/MCPCore.py +315 -0
  93. webscout/Provider/Marcus.py +198 -0
  94. webscout/Provider/Nemotron.py +218 -0
  95. webscout/Provider/Netwrck.py +270 -0
  96. webscout/Provider/OLLAMA.py +396 -0
  97. webscout/Provider/OPENAI/BLACKBOXAI.py +766 -0
  98. webscout/Provider/OPENAI/Cloudflare.py +378 -0
  99. webscout/Provider/OPENAI/FreeGemini.py +283 -0
  100. webscout/Provider/OPENAI/NEMOTRON.py +232 -0
  101. webscout/Provider/OPENAI/Qwen3.py +283 -0
  102. webscout/Provider/OPENAI/README.md +952 -0
  103. webscout/Provider/OPENAI/TwoAI.py +357 -0
  104. webscout/Provider/OPENAI/__init__.py +40 -0
  105. webscout/Provider/OPENAI/ai4chat.py +293 -0
  106. webscout/Provider/OPENAI/api.py +969 -0
  107. webscout/Provider/OPENAI/base.py +249 -0
  108. webscout/Provider/OPENAI/c4ai.py +373 -0
  109. webscout/Provider/OPENAI/chatgpt.py +556 -0
  110. webscout/Provider/OPENAI/chatgptclone.py +494 -0
  111. webscout/Provider/OPENAI/chatsandbox.py +173 -0
  112. webscout/Provider/OPENAI/copilot.py +242 -0
  113. webscout/Provider/OPENAI/deepinfra.py +322 -0
  114. webscout/Provider/OPENAI/e2b.py +1414 -0
  115. webscout/Provider/OPENAI/exaai.py +417 -0
  116. webscout/Provider/OPENAI/exachat.py +444 -0
  117. webscout/Provider/OPENAI/flowith.py +162 -0
  118. webscout/Provider/OPENAI/freeaichat.py +359 -0
  119. webscout/Provider/OPENAI/glider.py +326 -0
  120. webscout/Provider/OPENAI/groq.py +364 -0
  121. webscout/Provider/OPENAI/heckai.py +308 -0
  122. webscout/Provider/OPENAI/llmchatco.py +335 -0
  123. webscout/Provider/OPENAI/mcpcore.py +389 -0
  124. webscout/Provider/OPENAI/multichat.py +376 -0
  125. webscout/Provider/OPENAI/netwrck.py +357 -0
  126. webscout/Provider/OPENAI/oivscode.py +287 -0
  127. webscout/Provider/OPENAI/opkfc.py +496 -0
  128. webscout/Provider/OPENAI/pydantic_imports.py +172 -0
  129. webscout/Provider/OPENAI/scirachat.py +477 -0
  130. webscout/Provider/OPENAI/sonus.py +304 -0
  131. webscout/Provider/OPENAI/standardinput.py +433 -0
  132. webscout/Provider/OPENAI/textpollinations.py +339 -0
  133. webscout/Provider/OPENAI/toolbaz.py +413 -0
  134. webscout/Provider/OPENAI/typefully.py +355 -0
  135. webscout/Provider/OPENAI/typegpt.py +364 -0
  136. webscout/Provider/OPENAI/uncovrAI.py +463 -0
  137. webscout/Provider/OPENAI/utils.py +318 -0
  138. webscout/Provider/OPENAI/venice.py +431 -0
  139. webscout/Provider/OPENAI/wisecat.py +387 -0
  140. webscout/Provider/OPENAI/writecream.py +163 -0
  141. webscout/Provider/OPENAI/x0gpt.py +365 -0
  142. webscout/Provider/OPENAI/yep.py +382 -0
  143. webscout/Provider/OpenGPT.py +209 -0
  144. webscout/Provider/Openai.py +496 -0
  145. webscout/Provider/PI.py +429 -0
  146. webscout/Provider/Perplexitylabs.py +415 -0
  147. webscout/Provider/QwenLM.py +254 -0
  148. webscout/Provider/Reka.py +214 -0
  149. webscout/Provider/StandardInput.py +290 -0
  150. webscout/Provider/TTI/README.md +82 -0
  151. webscout/Provider/TTI/__init__.py +7 -0
  152. webscout/Provider/TTI/aiarta.py +365 -0
  153. webscout/Provider/TTI/artbit.py +0 -0
  154. webscout/Provider/TTI/base.py +64 -0
  155. webscout/Provider/TTI/fastflux.py +200 -0
  156. webscout/Provider/TTI/magicstudio.py +201 -0
  157. webscout/Provider/TTI/piclumen.py +203 -0
  158. webscout/Provider/TTI/pixelmuse.py +225 -0
  159. webscout/Provider/TTI/pollinations.py +221 -0
  160. webscout/Provider/TTI/utils.py +11 -0
  161. webscout/Provider/TTS/README.md +192 -0
  162. webscout/Provider/TTS/__init__.py +10 -0
  163. webscout/Provider/TTS/base.py +159 -0
  164. webscout/Provider/TTS/deepgram.py +156 -0
  165. webscout/Provider/TTS/elevenlabs.py +111 -0
  166. webscout/Provider/TTS/gesserit.py +128 -0
  167. webscout/Provider/TTS/murfai.py +113 -0
  168. webscout/Provider/TTS/openai_fm.py +129 -0
  169. webscout/Provider/TTS/parler.py +111 -0
  170. webscout/Provider/TTS/speechma.py +580 -0
  171. webscout/Provider/TTS/sthir.py +94 -0
  172. webscout/Provider/TTS/streamElements.py +333 -0
  173. webscout/Provider/TTS/utils.py +280 -0
  174. webscout/Provider/TeachAnything.py +229 -0
  175. webscout/Provider/TextPollinationsAI.py +308 -0
  176. webscout/Provider/TwoAI.py +475 -0
  177. webscout/Provider/TypliAI.py +305 -0
  178. webscout/Provider/UNFINISHED/ChatHub.py +209 -0
  179. webscout/Provider/UNFINISHED/Youchat.py +330 -0
  180. webscout/Provider/UNFINISHED/liner_api_request.py +263 -0
  181. webscout/Provider/UNFINISHED/puterjs.py +635 -0
  182. webscout/Provider/UNFINISHED/test_lmarena.py +119 -0
  183. webscout/Provider/Venice.py +258 -0
  184. webscout/Provider/VercelAI.py +253 -0
  185. webscout/Provider/WiseCat.py +233 -0
  186. webscout/Provider/WrDoChat.py +370 -0
  187. webscout/Provider/Writecream.py +246 -0
  188. webscout/Provider/WritingMate.py +269 -0
  189. webscout/Provider/__init__.py +174 -0
  190. webscout/Provider/ai4chat.py +174 -0
  191. webscout/Provider/akashgpt.py +335 -0
  192. webscout/Provider/asksteve.py +220 -0
  193. webscout/Provider/cerebras.py +290 -0
  194. webscout/Provider/chatglm.py +215 -0
  195. webscout/Provider/cleeai.py +213 -0
  196. webscout/Provider/copilot.py +425 -0
  197. webscout/Provider/elmo.py +283 -0
  198. webscout/Provider/freeaichat.py +285 -0
  199. webscout/Provider/geminiapi.py +208 -0
  200. webscout/Provider/granite.py +235 -0
  201. webscout/Provider/hermes.py +266 -0
  202. webscout/Provider/julius.py +223 -0
  203. webscout/Provider/koala.py +170 -0
  204. webscout/Provider/learnfastai.py +325 -0
  205. webscout/Provider/llama3mitril.py +215 -0
  206. webscout/Provider/llmchat.py +258 -0
  207. webscout/Provider/llmchatco.py +306 -0
  208. webscout/Provider/lmarena.py +198 -0
  209. webscout/Provider/meta.py +801 -0
  210. webscout/Provider/multichat.py +364 -0
  211. webscout/Provider/oivscode.py +309 -0
  212. webscout/Provider/samurai.py +224 -0
  213. webscout/Provider/scira_chat.py +299 -0
  214. webscout/Provider/scnet.py +243 -0
  215. webscout/Provider/searchchat.py +292 -0
  216. webscout/Provider/sonus.py +258 -0
  217. webscout/Provider/talkai.py +194 -0
  218. webscout/Provider/toolbaz.py +353 -0
  219. webscout/Provider/turboseek.py +266 -0
  220. webscout/Provider/typefully.py +202 -0
  221. webscout/Provider/typegpt.py +289 -0
  222. webscout/Provider/uncovr.py +368 -0
  223. webscout/Provider/x0gpt.py +299 -0
  224. webscout/Provider/yep.py +389 -0
  225. webscout/__init__.py +4 -2
  226. webscout/cli.py +3 -28
  227. webscout/client.py +70 -0
  228. webscout/conversation.py +35 -35
  229. webscout/litagent/Readme.md +276 -0
  230. webscout/litagent/__init__.py +29 -0
  231. webscout/litagent/agent.py +455 -0
  232. webscout/litagent/constants.py +60 -0
  233. webscout/litprinter/__init__.py +59 -0
  234. webscout/optimizers.py +419 -419
  235. webscout/scout/README.md +404 -0
  236. webscout/scout/__init__.py +8 -0
  237. webscout/scout/core/__init__.py +7 -0
  238. webscout/scout/core/crawler.py +210 -0
  239. webscout/scout/core/scout.py +607 -0
  240. webscout/scout/core/search_result.py +96 -0
  241. webscout/scout/core/text_analyzer.py +63 -0
  242. webscout/scout/core/text_utils.py +277 -0
  243. webscout/scout/core/web_analyzer.py +52 -0
  244. webscout/scout/element.py +478 -0
  245. webscout/scout/parsers/__init__.py +69 -0
  246. webscout/scout/parsers/html5lib_parser.py +172 -0
  247. webscout/scout/parsers/html_parser.py +236 -0
  248. webscout/scout/parsers/lxml_parser.py +178 -0
  249. webscout/scout/utils.py +37 -0
  250. webscout/swiftcli/Readme.md +323 -0
  251. webscout/swiftcli/__init__.py +95 -0
  252. webscout/swiftcli/core/__init__.py +7 -0
  253. webscout/swiftcli/core/cli.py +297 -0
  254. webscout/swiftcli/core/context.py +104 -0
  255. webscout/swiftcli/core/group.py +241 -0
  256. webscout/swiftcli/decorators/__init__.py +28 -0
  257. webscout/swiftcli/decorators/command.py +221 -0
  258. webscout/swiftcli/decorators/options.py +220 -0
  259. webscout/swiftcli/decorators/output.py +252 -0
  260. webscout/swiftcli/exceptions.py +21 -0
  261. webscout/swiftcli/plugins/__init__.py +9 -0
  262. webscout/swiftcli/plugins/base.py +135 -0
  263. webscout/swiftcli/plugins/manager.py +269 -0
  264. webscout/swiftcli/utils/__init__.py +59 -0
  265. webscout/swiftcli/utils/formatting.py +252 -0
  266. webscout/swiftcli/utils/parsing.py +267 -0
  267. webscout/version.py +1 -1
  268. webscout/webscout_search.py +2 -182
  269. webscout/webscout_search_async.py +1 -179
  270. webscout/zeroart/README.md +89 -0
  271. webscout/zeroart/__init__.py +135 -0
  272. webscout/zeroart/base.py +66 -0
  273. webscout/zeroart/effects.py +101 -0
  274. webscout/zeroart/fonts.py +1239 -0
  275. {webscout-8.2.7.dist-info → webscout-8.2.9.dist-info}/METADATA +262 -83
  276. webscout-8.2.9.dist-info/RECORD +289 -0
  277. {webscout-8.2.7.dist-info → webscout-8.2.9.dist-info}/WHEEL +1 -1
  278. {webscout-8.2.7.dist-info → webscout-8.2.9.dist-info}/entry_points.txt +1 -0
  279. webscout-8.2.7.dist-info/RECORD +0 -26
  280. {webscout-8.2.7.dist-info → webscout-8.2.9.dist-info}/licenses/LICENSE.md +0 -0
  281. {webscout-8.2.7.dist-info → webscout-8.2.9.dist-info}/top_level.txt +0 -0
@@ -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)}")
@@ -0,0 +1,263 @@
1
+ import requests
2
+ import json
3
+ from typing import Dict, Optional, Generator, Union, Any
4
+ from uuid import uuid4
5
+ import time
6
+ import base64
7
+ import random
8
+
9
+ from webscout.AIbase import AISearch
10
+ from webscout import exceptions
11
+ from webscout import LitAgent
12
+
13
+
14
+ class Response:
15
+ """A wrapper class for Liner API responses.
16
+
17
+ This class automatically converts response objects to their text representation
18
+ when printed or converted to string.
19
+
20
+ Attributes:
21
+ text (str): The text content of the response
22
+
23
+ Example:
24
+ >>> response = Response("Hello, world!")
25
+ >>> print(response)
26
+ Hello, world!
27
+ >>> str(response)
28
+ 'Hello, world!'
29
+ """
30
+ def __init__(self, text: str):
31
+ self.text = text
32
+
33
+ def __str__(self):
34
+ return self.text
35
+
36
+ def __repr__(self):
37
+ return self.text
38
+
39
+
40
+ class Liner(AISearch):
41
+ """A class to interact with the Liner AI search API.
42
+
43
+ Liner provides a powerful search interface that returns AI-generated responses
44
+ based on web content. It supports both streaming and non-streaming responses.
45
+
46
+ Basic Usage:
47
+ >>> from webscout import Liner
48
+ >>> ai = Liner(cookies_path="cookies.json")
49
+ >>> # Non-streaming example
50
+ >>> response = ai.search("What is Python?")
51
+ >>> print(response)
52
+ Python is a high-level programming language...
53
+
54
+ >>> # Streaming example
55
+ >>> for chunk in ai.search("Tell me about AI", stream=True):
56
+ ... print(chunk, end="", flush=True)
57
+ Artificial Intelligence is...
58
+
59
+ >>> # Raw response format
60
+ >>> for chunk in ai.search("Hello", stream=True, raw=True):
61
+ ... print(chunk)
62
+ {'text': 'Hello'}
63
+ {'text': ' there!'}
64
+
65
+ Args:
66
+ cookies_path (str): Path to the cookies JSON file
67
+ timeout (int, optional): Request timeout in seconds. Defaults to 30.
68
+ proxies (dict, optional): Proxy configuration for requests. Defaults to None.
69
+ deep_search (bool, optional): Enable deep research mode. Defaults to True.
70
+ reasoning_mode (bool, optional): Enable reasoning mode. Defaults to False.
71
+ """
72
+
73
+ def __init__(
74
+ self,
75
+ cookies_path: str,
76
+ timeout: int = 600,
77
+ proxies: Optional[dict] = None,
78
+ deep_search: bool = True,
79
+ reasoning_mode: bool = False,
80
+ ):
81
+ """Initialize the Liner API client.
82
+
83
+ Args:
84
+ cookies_path (str): Path to the cookies JSON file
85
+ timeout (int, optional): Request timeout in seconds. Defaults to 30.
86
+ proxies (dict, optional): Proxy configuration for requests. Defaults to None.
87
+ deep_search (bool, optional): Enable deep research mode. Defaults to True.
88
+ reasoning_mode (bool, optional): Enable reasoning mode. Defaults to False.
89
+ """
90
+ self.session = requests.Session()
91
+ self.chat_endpoint = "https://getliner.com/lisa/v1/answer"
92
+ self.stream_chunk_size = 64
93
+ self.timeout = timeout
94
+ self.last_response = {}
95
+ self.cookies_path = cookies_path
96
+ self.deep_search = deep_search
97
+ self.reasoning_mode = reasoning_mode
98
+
99
+ # Generate random IDs
100
+ self.space_id = random.randint(10000000, 99999999)
101
+ self.thread_id = random.randint(10000000, 99999999)
102
+ self.user_message_id = random.randint(100000000, 999999999)
103
+ self.user_id = random.randint(1000000, 9999999)
104
+
105
+ self.headers = {
106
+ "accept": "text/event-stream",
107
+ "accept-encoding": "gzip, deflate, br, zstd",
108
+ "accept-language": "en-US,en;q=0.9,en-IN;q=0.8",
109
+ "content-type": "application/json",
110
+ "dnt": "1",
111
+ "origin": "https://getliner.com",
112
+ "referer": f"https://getliner.com/search/s/{self.space_id}/t/t_{uuid4()}?mode=temp&msg-entry-type=main&build-id=kwJaNRjnCKjh7PijZgqV2",
113
+ "sec-ch-ua": '"Chromium";v="134", "Not:A-Brand";v="24", "Microsoft Edge";v="134"',
114
+ "sec-ch-ua-mobile": "?0",
115
+ "sec-ch-ua-platform": '"Windows"',
116
+ "sec-fetch-dest": "empty",
117
+ "sec-fetch-mode": "cors",
118
+ "sec-fetch-site": "same-origin",
119
+ "sec-gpc": "1",
120
+ "user-agent": LitAgent().random()
121
+ }
122
+
123
+ # Load cookies from JSON file
124
+ self.cookies = self._load_cookies()
125
+ if not self.cookies:
126
+ raise ValueError("Failed to load cookies from file")
127
+
128
+ # Set headers and cookies in session
129
+ self.session.headers.update(self.headers)
130
+ self.session.cookies.update(self.cookies)
131
+ self.session.proxies = proxies or {}
132
+
133
+ def _load_cookies(self) -> Optional[Dict[str, str]]:
134
+ """Load cookies from a JSON file.
135
+
136
+ Returns:
137
+ Optional[Dict[str, str]]: Dictionary of cookies if successful, None otherwise
138
+ """
139
+ try:
140
+ with open(self.cookies_path, 'r') as f:
141
+ cookies_data = json.load(f)
142
+ return {cookie['name']: cookie['value'] for cookie in cookies_data}
143
+ except FileNotFoundError:
144
+ print(f"Error: {self.cookies_path} file not found!")
145
+ return None
146
+ except json.JSONDecodeError:
147
+ print(f"Error: Invalid JSON format in {self.cookies_path}!")
148
+ return None
149
+ except KeyError:
150
+ print(f"Error: Invalid cookie format in {self.cookies_path}! Each cookie must have 'name' and 'value' keys.")
151
+ return None
152
+
153
+ def search(
154
+ self,
155
+ prompt: str,
156
+ stream: bool = False,
157
+ raw: bool = False,
158
+ ) -> Union[Response, Generator[Union[Dict[str, str], Response], None, None]]:
159
+ """Search using the Liner API and get AI-generated responses.
160
+
161
+ Args:
162
+ prompt (str): The search query or prompt to send to the API.
163
+ stream (bool, optional): If True, yields response chunks as they arrive.
164
+ If False, returns complete response. Defaults to False.
165
+ raw (bool, optional): If True, returns raw response dictionaries with 'text' key.
166
+ If False, returns Response objects that convert to text automatically.
167
+ Defaults to False.
168
+
169
+ Returns:
170
+ Union[Response, Generator[Union[Dict[str, str], Response], None, None]]:
171
+ - If stream=False: Returns complete response
172
+ - If stream=True: Yields response chunks as they arrive
173
+
174
+ Raises:
175
+ APIConnectionError: If the API request fails
176
+ """
177
+ payload = {
178
+ "spaceId": self.space_id,
179
+ "threadId": self.thread_id,
180
+ "userMessageId": self.user_message_id,
181
+ "userId": self.user_id,
182
+ "query": prompt,
183
+ "agentId": "liner",
184
+ "platform": "web",
185
+ "regenerate": False,
186
+ "showReferenceChunks": True,
187
+ "mode": "general",
188
+ "answerMode": "search",
189
+ "isReasoningMode": self.reasoning_mode,
190
+ "experimentId": random.randint(80, 90),
191
+ "modelType": "liner",
192
+ "experimentVariants": [],
193
+ "isDeepResearchMode": self.deep_search
194
+ }
195
+
196
+ def for_stream():
197
+ try:
198
+ with self.session.post(
199
+ self.chat_endpoint,
200
+ json=payload,
201
+ stream=True,
202
+ timeout=self.timeout,
203
+ ) as response:
204
+ if not response.ok:
205
+ raise exceptions.APIConnectionError(
206
+ f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
207
+ )
208
+
209
+ current_reasoning = ""
210
+ current_answer = ""
211
+
212
+ for line in response.iter_lines(decode_unicode=True):
213
+ if line == "event:finish_answer":
214
+ break
215
+
216
+ if line.startswith('data:'):
217
+ try:
218
+ data = json.loads(line[5:]) # Remove 'data:' prefix
219
+
220
+ # Handle reasoning updates if enabled
221
+ if self.reasoning_mode and 'reasoning' in data:
222
+ current_reasoning += data['reasoning']
223
+ if raw:
224
+ yield {"text": data['reasoning']}
225
+ else:
226
+ yield Response(data['reasoning'])
227
+
228
+ # Handle answer updates
229
+ if 'answer' in data:
230
+ current_answer += data['answer']
231
+ if raw:
232
+ yield {"text": data['answer']}
233
+ else:
234
+ yield Response(data['answer'])
235
+
236
+ except json.JSONDecodeError:
237
+ continue
238
+
239
+ except requests.exceptions.RequestException as e:
240
+ raise exceptions.APIConnectionError(f"Request failed: {e}")
241
+
242
+ def for_non_stream():
243
+ full_response = ""
244
+ for chunk in for_stream():
245
+ if raw:
246
+ yield chunk
247
+ else:
248
+ full_response += str(chunk)
249
+
250
+ if not raw:
251
+ self.last_response = Response(full_response)
252
+ return self.last_response
253
+
254
+ return for_stream() if stream else for_non_stream()
255
+
256
+
257
+ if __name__ == "__main__":
258
+ from rich import print
259
+
260
+ ai = Liner(cookies_path="cookies.json")
261
+ response = ai.search(input(">>> "), stream=True, raw=False)
262
+ for chunk in response:
263
+ print(chunk, end="", flush=True)