webscout 8.3.7__py3-none-any.whl → 2025.10.13__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 (306) hide show
  1. webscout/AIauto.py +250 -250
  2. webscout/AIbase.py +379 -379
  3. webscout/AIutel.py +60 -60
  4. webscout/Bard.py +1012 -1012
  5. webscout/Bing_search.py +417 -417
  6. webscout/DWEBS.py +529 -529
  7. webscout/Extra/Act.md +309 -309
  8. webscout/Extra/GitToolkit/__init__.py +10 -10
  9. webscout/Extra/GitToolkit/gitapi/README.md +110 -110
  10. webscout/Extra/GitToolkit/gitapi/__init__.py +11 -11
  11. webscout/Extra/GitToolkit/gitapi/repository.py +195 -195
  12. webscout/Extra/GitToolkit/gitapi/user.py +96 -96
  13. webscout/Extra/GitToolkit/gitapi/utils.py +61 -61
  14. webscout/Extra/YTToolkit/README.md +375 -375
  15. webscout/Extra/YTToolkit/YTdownloader.py +956 -956
  16. webscout/Extra/YTToolkit/__init__.py +2 -2
  17. webscout/Extra/YTToolkit/transcriber.py +475 -475
  18. webscout/Extra/YTToolkit/ytapi/README.md +44 -44
  19. webscout/Extra/YTToolkit/ytapi/__init__.py +6 -6
  20. webscout/Extra/YTToolkit/ytapi/channel.py +307 -307
  21. webscout/Extra/YTToolkit/ytapi/errors.py +13 -13
  22. webscout/Extra/YTToolkit/ytapi/extras.py +118 -118
  23. webscout/Extra/YTToolkit/ytapi/https.py +88 -88
  24. webscout/Extra/YTToolkit/ytapi/patterns.py +61 -61
  25. webscout/Extra/YTToolkit/ytapi/playlist.py +58 -58
  26. webscout/Extra/YTToolkit/ytapi/pool.py +7 -7
  27. webscout/Extra/YTToolkit/ytapi/query.py +39 -39
  28. webscout/Extra/YTToolkit/ytapi/stream.py +62 -62
  29. webscout/Extra/YTToolkit/ytapi/utils.py +62 -62
  30. webscout/Extra/YTToolkit/ytapi/video.py +232 -232
  31. webscout/Extra/autocoder/__init__.py +9 -9
  32. webscout/Extra/autocoder/autocoder.py +1105 -1105
  33. webscout/Extra/autocoder/autocoder_utiles.py +332 -332
  34. webscout/Extra/gguf.md +429 -429
  35. webscout/Extra/gguf.py +1213 -1213
  36. webscout/Extra/tempmail/README.md +487 -487
  37. webscout/Extra/tempmail/__init__.py +27 -27
  38. webscout/Extra/tempmail/async_utils.py +140 -140
  39. webscout/Extra/tempmail/base.py +160 -160
  40. webscout/Extra/tempmail/cli.py +186 -186
  41. webscout/Extra/tempmail/emailnator.py +84 -84
  42. webscout/Extra/tempmail/mail_tm.py +360 -360
  43. webscout/Extra/tempmail/temp_mail_io.py +291 -291
  44. webscout/Extra/weather.md +281 -281
  45. webscout/Extra/weather.py +193 -193
  46. webscout/Litlogger/README.md +10 -10
  47. webscout/Litlogger/__init__.py +15 -15
  48. webscout/Litlogger/formats.py +13 -13
  49. webscout/Litlogger/handlers.py +121 -121
  50. webscout/Litlogger/levels.py +13 -13
  51. webscout/Litlogger/logger.py +134 -134
  52. webscout/Provider/AISEARCH/Perplexity.py +332 -332
  53. webscout/Provider/AISEARCH/README.md +279 -279
  54. webscout/Provider/AISEARCH/__init__.py +16 -1
  55. webscout/Provider/AISEARCH/felo_search.py +206 -206
  56. webscout/Provider/AISEARCH/genspark_search.py +323 -323
  57. webscout/Provider/AISEARCH/hika_search.py +185 -185
  58. webscout/Provider/AISEARCH/iask_search.py +410 -410
  59. webscout/Provider/AISEARCH/monica_search.py +219 -219
  60. webscout/Provider/AISEARCH/scira_search.py +316 -316
  61. webscout/Provider/AISEARCH/stellar_search.py +177 -177
  62. webscout/Provider/AISEARCH/webpilotai_search.py +255 -255
  63. webscout/Provider/Aitopia.py +314 -314
  64. webscout/Provider/Andi.py +1 -1
  65. webscout/Provider/Apriel.py +306 -0
  66. webscout/Provider/ChatGPTClone.py +237 -236
  67. webscout/Provider/ChatSandbox.py +343 -343
  68. webscout/Provider/Cloudflare.py +324 -324
  69. webscout/Provider/Cohere.py +208 -208
  70. webscout/Provider/Deepinfra.py +370 -366
  71. webscout/Provider/ExaAI.py +260 -260
  72. webscout/Provider/ExaChat.py +308 -308
  73. webscout/Provider/Flowith.py +221 -221
  74. webscout/Provider/GMI.py +293 -0
  75. webscout/Provider/Gemini.py +164 -164
  76. webscout/Provider/GeminiProxy.py +167 -167
  77. webscout/Provider/GithubChat.py +371 -372
  78. webscout/Provider/Groq.py +800 -800
  79. webscout/Provider/HeckAI.py +383 -383
  80. webscout/Provider/Jadve.py +282 -282
  81. webscout/Provider/K2Think.py +307 -307
  82. webscout/Provider/Koboldai.py +205 -205
  83. webscout/Provider/LambdaChat.py +423 -423
  84. webscout/Provider/Nemotron.py +244 -244
  85. webscout/Provider/Netwrck.py +248 -248
  86. webscout/Provider/OLLAMA.py +395 -395
  87. webscout/Provider/OPENAI/Cloudflare.py +393 -393
  88. webscout/Provider/OPENAI/FalconH1.py +451 -451
  89. webscout/Provider/OPENAI/FreeGemini.py +296 -296
  90. webscout/Provider/OPENAI/K2Think.py +431 -431
  91. webscout/Provider/OPENAI/NEMOTRON.py +240 -240
  92. webscout/Provider/OPENAI/PI.py +427 -427
  93. webscout/Provider/OPENAI/README.md +959 -959
  94. webscout/Provider/OPENAI/TogetherAI.py +345 -345
  95. webscout/Provider/OPENAI/TwoAI.py +465 -465
  96. webscout/Provider/OPENAI/__init__.py +33 -18
  97. webscout/Provider/OPENAI/base.py +248 -248
  98. webscout/Provider/OPENAI/chatglm.py +528 -0
  99. webscout/Provider/OPENAI/chatgpt.py +592 -592
  100. webscout/Provider/OPENAI/chatgptclone.py +521 -521
  101. webscout/Provider/OPENAI/chatsandbox.py +202 -202
  102. webscout/Provider/OPENAI/deepinfra.py +318 -314
  103. webscout/Provider/OPENAI/e2b.py +1665 -1665
  104. webscout/Provider/OPENAI/exaai.py +420 -420
  105. webscout/Provider/OPENAI/exachat.py +452 -452
  106. webscout/Provider/OPENAI/friendli.py +232 -232
  107. webscout/Provider/OPENAI/{refact.py → gmi.py} +324 -274
  108. webscout/Provider/OPENAI/groq.py +364 -364
  109. webscout/Provider/OPENAI/heckai.py +314 -314
  110. webscout/Provider/OPENAI/llmchatco.py +337 -337
  111. webscout/Provider/OPENAI/netwrck.py +355 -355
  112. webscout/Provider/OPENAI/oivscode.py +290 -290
  113. webscout/Provider/OPENAI/opkfc.py +518 -518
  114. webscout/Provider/OPENAI/pydantic_imports.py +1 -1
  115. webscout/Provider/OPENAI/scirachat.py +535 -535
  116. webscout/Provider/OPENAI/sonus.py +308 -308
  117. webscout/Provider/OPENAI/standardinput.py +442 -442
  118. webscout/Provider/OPENAI/textpollinations.py +340 -340
  119. webscout/Provider/OPENAI/toolbaz.py +419 -416
  120. webscout/Provider/OPENAI/typefully.py +362 -362
  121. webscout/Provider/OPENAI/utils.py +295 -295
  122. webscout/Provider/OPENAI/venice.py +436 -436
  123. webscout/Provider/OPENAI/wisecat.py +387 -387
  124. webscout/Provider/OPENAI/writecream.py +166 -166
  125. webscout/Provider/OPENAI/x0gpt.py +378 -378
  126. webscout/Provider/OPENAI/yep.py +389 -389
  127. webscout/Provider/OpenGPT.py +230 -230
  128. webscout/Provider/Openai.py +243 -243
  129. webscout/Provider/PI.py +405 -405
  130. webscout/Provider/Perplexitylabs.py +430 -430
  131. webscout/Provider/QwenLM.py +272 -272
  132. webscout/Provider/STT/__init__.py +16 -1
  133. webscout/Provider/Sambanova.py +257 -257
  134. webscout/Provider/StandardInput.py +309 -309
  135. webscout/Provider/TTI/README.md +82 -82
  136. webscout/Provider/TTI/__init__.py +33 -18
  137. webscout/Provider/TTI/aiarta.py +413 -413
  138. webscout/Provider/TTI/base.py +136 -136
  139. webscout/Provider/TTI/bing.py +243 -243
  140. webscout/Provider/TTI/gpt1image.py +149 -149
  141. webscout/Provider/TTI/imagen.py +196 -196
  142. webscout/Provider/TTI/infip.py +211 -211
  143. webscout/Provider/TTI/magicstudio.py +232 -232
  144. webscout/Provider/TTI/monochat.py +219 -219
  145. webscout/Provider/TTI/piclumen.py +214 -214
  146. webscout/Provider/TTI/pixelmuse.py +232 -232
  147. webscout/Provider/TTI/pollinations.py +232 -232
  148. webscout/Provider/TTI/together.py +288 -288
  149. webscout/Provider/TTI/utils.py +12 -12
  150. webscout/Provider/TTI/venice.py +367 -367
  151. webscout/Provider/TTS/README.md +192 -192
  152. webscout/Provider/TTS/__init__.py +33 -18
  153. webscout/Provider/TTS/parler.py +110 -110
  154. webscout/Provider/TTS/streamElements.py +333 -333
  155. webscout/Provider/TTS/utils.py +280 -280
  156. webscout/Provider/TeachAnything.py +237 -237
  157. webscout/Provider/TextPollinationsAI.py +310 -310
  158. webscout/Provider/TogetherAI.py +356 -356
  159. webscout/Provider/TwoAI.py +312 -312
  160. webscout/Provider/TypliAI.py +311 -311
  161. webscout/Provider/UNFINISHED/ChatHub.py +208 -208
  162. webscout/Provider/UNFINISHED/ChutesAI.py +313 -313
  163. webscout/Provider/UNFINISHED/GizAI.py +294 -294
  164. webscout/Provider/UNFINISHED/Marcus.py +198 -198
  165. webscout/Provider/UNFINISHED/Qodo.py +477 -477
  166. webscout/Provider/UNFINISHED/VercelAIGateway.py +338 -338
  167. webscout/Provider/UNFINISHED/XenAI.py +324 -324
  168. webscout/Provider/UNFINISHED/Youchat.py +330 -330
  169. webscout/Provider/UNFINISHED/liner.py +334 -0
  170. webscout/Provider/UNFINISHED/liner_api_request.py +262 -262
  171. webscout/Provider/UNFINISHED/puterjs.py +634 -634
  172. webscout/Provider/UNFINISHED/samurai.py +223 -223
  173. webscout/Provider/UNFINISHED/test_lmarena.py +119 -119
  174. webscout/Provider/Venice.py +250 -250
  175. webscout/Provider/VercelAI.py +256 -256
  176. webscout/Provider/WiseCat.py +231 -231
  177. webscout/Provider/WrDoChat.py +366 -366
  178. webscout/Provider/__init__.py +33 -18
  179. webscout/Provider/ai4chat.py +174 -174
  180. webscout/Provider/akashgpt.py +331 -331
  181. webscout/Provider/cerebras.py +446 -446
  182. webscout/Provider/chatglm.py +394 -301
  183. webscout/Provider/cleeai.py +211 -211
  184. webscout/Provider/elmo.py +282 -282
  185. webscout/Provider/geminiapi.py +208 -208
  186. webscout/Provider/granite.py +261 -261
  187. webscout/Provider/hermes.py +263 -263
  188. webscout/Provider/julius.py +223 -223
  189. webscout/Provider/learnfastai.py +309 -309
  190. webscout/Provider/llama3mitril.py +214 -214
  191. webscout/Provider/llmchat.py +243 -243
  192. webscout/Provider/llmchatco.py +290 -290
  193. webscout/Provider/meta.py +801 -801
  194. webscout/Provider/oivscode.py +309 -309
  195. webscout/Provider/scira_chat.py +383 -383
  196. webscout/Provider/searchchat.py +292 -292
  197. webscout/Provider/sonus.py +258 -258
  198. webscout/Provider/toolbaz.py +370 -367
  199. webscout/Provider/turboseek.py +273 -273
  200. webscout/Provider/typefully.py +207 -207
  201. webscout/Provider/yep.py +372 -372
  202. webscout/__init__.py +27 -31
  203. webscout/__main__.py +5 -5
  204. webscout/auth/api_key_manager.py +189 -189
  205. webscout/auth/config.py +175 -175
  206. webscout/auth/models.py +185 -185
  207. webscout/auth/routes.py +663 -664
  208. webscout/auth/simple_logger.py +236 -236
  209. webscout/cli.py +523 -523
  210. webscout/conversation.py +438 -438
  211. webscout/exceptions.py +361 -361
  212. webscout/litagent/Readme.md +298 -298
  213. webscout/litagent/__init__.py +28 -28
  214. webscout/litagent/agent.py +581 -581
  215. webscout/litagent/constants.py +59 -59
  216. webscout/litprinter/__init__.py +58 -58
  217. webscout/models.py +181 -181
  218. webscout/optimizers.py +419 -419
  219. webscout/prompt_manager.py +288 -288
  220. webscout/sanitize.py +1078 -1078
  221. webscout/scout/README.md +401 -401
  222. webscout/scout/__init__.py +8 -8
  223. webscout/scout/core/__init__.py +6 -6
  224. webscout/scout/core/crawler.py +297 -297
  225. webscout/scout/core/scout.py +706 -706
  226. webscout/scout/core/search_result.py +95 -95
  227. webscout/scout/core/text_analyzer.py +62 -62
  228. webscout/scout/core/text_utils.py +277 -277
  229. webscout/scout/core/web_analyzer.py +51 -51
  230. webscout/scout/element.py +599 -599
  231. webscout/scout/parsers/__init__.py +69 -69
  232. webscout/scout/parsers/html5lib_parser.py +172 -172
  233. webscout/scout/parsers/html_parser.py +236 -236
  234. webscout/scout/parsers/lxml_parser.py +178 -178
  235. webscout/scout/utils.py +37 -37
  236. webscout/search/__init__.py +51 -0
  237. webscout/search/base.py +195 -0
  238. webscout/search/duckduckgo_main.py +54 -0
  239. webscout/search/engines/__init__.py +48 -0
  240. webscout/search/engines/bing.py +84 -0
  241. webscout/search/engines/bing_news.py +52 -0
  242. webscout/search/engines/brave.py +43 -0
  243. webscout/search/engines/duckduckgo/__init__.py +25 -0
  244. webscout/search/engines/duckduckgo/answers.py +78 -0
  245. webscout/search/engines/duckduckgo/base.py +187 -0
  246. webscout/search/engines/duckduckgo/images.py +97 -0
  247. webscout/search/engines/duckduckgo/maps.py +168 -0
  248. webscout/search/engines/duckduckgo/news.py +68 -0
  249. webscout/search/engines/duckduckgo/suggestions.py +21 -0
  250. webscout/search/engines/duckduckgo/text.py +211 -0
  251. webscout/search/engines/duckduckgo/translate.py +47 -0
  252. webscout/search/engines/duckduckgo/videos.py +63 -0
  253. webscout/search/engines/duckduckgo/weather.py +74 -0
  254. webscout/search/engines/mojeek.py +37 -0
  255. webscout/search/engines/wikipedia.py +56 -0
  256. webscout/search/engines/yahoo.py +65 -0
  257. webscout/search/engines/yahoo_news.py +64 -0
  258. webscout/search/engines/yandex.py +43 -0
  259. webscout/search/engines/yep/__init__.py +13 -0
  260. webscout/search/engines/yep/base.py +32 -0
  261. webscout/search/engines/yep/images.py +99 -0
  262. webscout/search/engines/yep/suggestions.py +35 -0
  263. webscout/search/engines/yep/text.py +114 -0
  264. webscout/search/http_client.py +156 -0
  265. webscout/search/results.py +137 -0
  266. webscout/search/yep_main.py +44 -0
  267. webscout/swiftcli/Readme.md +323 -323
  268. webscout/swiftcli/__init__.py +95 -95
  269. webscout/swiftcli/core/__init__.py +7 -7
  270. webscout/swiftcli/core/cli.py +308 -308
  271. webscout/swiftcli/core/context.py +104 -104
  272. webscout/swiftcli/core/group.py +241 -241
  273. webscout/swiftcli/decorators/__init__.py +28 -28
  274. webscout/swiftcli/decorators/command.py +221 -221
  275. webscout/swiftcli/decorators/options.py +220 -220
  276. webscout/swiftcli/decorators/output.py +302 -302
  277. webscout/swiftcli/exceptions.py +21 -21
  278. webscout/swiftcli/plugins/__init__.py +9 -9
  279. webscout/swiftcli/plugins/base.py +135 -135
  280. webscout/swiftcli/plugins/manager.py +269 -269
  281. webscout/swiftcli/utils/__init__.py +59 -59
  282. webscout/swiftcli/utils/formatting.py +252 -252
  283. webscout/swiftcli/utils/parsing.py +267 -267
  284. webscout/update_checker.py +117 -117
  285. webscout/version.py +1 -1
  286. webscout/version.py.bak +2 -0
  287. webscout/zeroart/README.md +89 -89
  288. webscout/zeroart/__init__.py +134 -134
  289. webscout/zeroart/base.py +66 -66
  290. webscout/zeroart/effects.py +100 -100
  291. webscout/zeroart/fonts.py +1238 -1238
  292. {webscout-8.3.7.dist-info → webscout-2025.10.13.dist-info}/METADATA +936 -937
  293. webscout-2025.10.13.dist-info/RECORD +329 -0
  294. webscout/Provider/AISEARCH/DeepFind.py +0 -254
  295. webscout/Provider/OPENAI/Qwen3.py +0 -303
  296. webscout/Provider/OPENAI/qodo.py +0 -630
  297. webscout/Provider/OPENAI/xenai.py +0 -514
  298. webscout/tempid.py +0 -134
  299. webscout/webscout_search.py +0 -1183
  300. webscout/webscout_search_async.py +0 -649
  301. webscout/yep_search.py +0 -346
  302. webscout-8.3.7.dist-info/RECORD +0 -301
  303. {webscout-8.3.7.dist-info → webscout-2025.10.13.dist-info}/WHEEL +0 -0
  304. {webscout-8.3.7.dist-info → webscout-2025.10.13.dist-info}/entry_points.txt +0 -0
  305. {webscout-8.3.7.dist-info → webscout-2025.10.13.dist-info}/licenses/LICENSE.md +0 -0
  306. {webscout-8.3.7.dist-info → webscout-2025.10.13.dist-info}/top_level.txt +0 -0
@@ -1,302 +1,395 @@
1
- from curl_cffi import CurlError
2
- from curl_cffi.requests import Session
3
- from typing import Any, Dict, Optional, Generator, List, Union
4
- import uuid
5
- from webscout.AIutel import Optimizers
6
- from webscout.AIutel import Conversation
7
- from webscout.AIutel import AwesomePrompts, sanitize_stream # Import sanitize_stream
8
- from webscout.AIbase import Provider
9
- from webscout import exceptions
10
- from webscout.litagent import LitAgent
11
-
12
-
13
- class ChatGLM(Provider):
14
- """
15
- A class to interact with the Z.AI Chat API (GLM-4.5).
16
- """
17
- required_auth = False
18
- url = "https://chat.z.ai"
19
- # Model nickname mapping system
20
- MODEL_MAPPING = {
21
- "glm-4.5V": "glm-4.5v",
22
- "glm-4-32B": "main_chat",
23
- "glm-4.5-Air": "0727-106B-API",
24
- "glm-4.5": "0727-360B-API",
25
- # Add more nicknames as needed
26
- }
27
- # Reverse mapping: API format to nickname
28
- GLM_TO_MODEL = {v: k for k, v in MODEL_MAPPING.items()}
29
- AVAILABLE_MODELS = list(MODEL_MAPPING.keys()) + list(GLM_TO_MODEL.keys()) + ["0727-106B-API", "0727-360B-API", "glm-4.5v", "main_chat"]
30
-
31
- @classmethod
32
- def _resolve_model(cls, model: str) -> str:
33
- """
34
- Resolve a model nickname or API name to the API format.
35
- """
36
- if model in cls.GLM_TO_MODEL:
37
- return model
38
- if model in cls.MODEL_MAPPING:
39
- return cls.MODEL_MAPPING[model]
40
- # fallback to direct API name if present
41
- if model in ["0727-106B-API", "0727-360B-API", "glm-4.5v", "main_chat"]:
42
- return model
43
- raise ValueError(f"Invalid model: {model}. Choose from: {cls.AVAILABLE_MODELS}")
44
- def __init__(
45
- self,
46
- is_conversation: bool = True,
47
- max_tokens: int = 600,
48
- timeout: int = 30,
49
- intro: str = None,
50
- filepath: str = None,
51
- update_file: bool = True,
52
- proxies: dict = {},
53
- history_offset: int = 10250,
54
- act: str = None,
55
- model: str = "0727-106B-API",
56
- ):
57
- """Initializes the Z.AI Chat API client."""
58
- self.session = Session()
59
- self.is_conversation = is_conversation
60
- self.max_tokens_to_sample = max_tokens
61
- self.timeout = timeout
62
- self.last_response = {}
63
- self.headers = {
64
- 'Accept-Language': 'en-US,en;q=0.9',
65
- 'App-Name': 'chatglm',
66
- 'Content-Type': 'application/json',
67
- 'Origin': self.url,
68
- 'User-Agent': LitAgent().random(),
69
- 'X-App-Platform': 'pc',
70
- 'X-App-Version': '0.0.1',
71
- 'Accept': 'text/event-stream',
72
- }
73
- self.api_endpoint = f"{self.url}/api/chat/completions"
74
- self.__available_optimizers = (
75
- method
76
- for method in dir(Optimizers)
77
- if callable(getattr(Optimizers, method)) and not method.startswith("__")
78
- )
79
- self.session.headers.update(self.headers)
80
- Conversation.intro = (
81
- AwesomePrompts().get_act(
82
- act, raise_not_found=True, default=None, case_insensitive=True
83
- )
84
- if act
85
- else intro or Conversation.intro
86
- )
87
- self.conversation = Conversation(
88
- is_conversation, self.max_tokens_to_sample, filepath, update_file
89
- )
90
- self.conversation.history_offset = history_offset
91
- self.session.proxies = proxies
92
- # Use nickname resolution for model
93
- self.model = self._resolve_model(model)
94
-
95
- def _get_api_key(self):
96
- if not hasattr(self, 'api_key') or not self.api_key:
97
- response = self.session.get(f"{self.url}/api/v1/auths/")
98
- self.api_key = response.json().get("token")
99
- return self.api_key
100
-
101
- def _get_cookie(self):
102
- """Get authentication cookie from the site"""
103
- if not hasattr(self, 'cookie') or not self.cookie:
104
- response = self.session.get(f"{self.url}/")
105
- self.cookie = response.headers.get('Set-Cookie', '')
106
- return self.cookie
107
-
108
-
109
- # _zai_extractor removed; use extract_regexes in sanitize_stream
110
-
111
-
112
- def ask(
113
- self,
114
- prompt: str,
115
- stream: bool = False,
116
- raw: bool = False,
117
- optimizer: str = None,
118
- conversationally: bool = False,
119
- ) -> Union[Dict[str, Any], Generator[Any, None, None]]:
120
- """Chat with Z.AI API
121
- Args:
122
- prompt (str): Prompt to be sent.
123
- stream (bool, optional): Flag for streaming response. Defaults to False.
124
- raw (bool, optional): Stream back raw response as received. Defaults to False.
125
- optimizer (str, optional): Prompt optimizer name. Defaults to None.
126
- conversationally (bool, optional): Chat conversationally when using optimizer. Defaults to False.
127
- model (str, optional): Model name. Defaults to None.
128
- Returns:
129
- Union[Dict, Generator[Dict, None, None]]: Response generated
130
- """
131
- conversation_prompt = self.conversation.gen_complete_prompt(prompt)
132
- if optimizer:
133
- if optimizer in self.__available_optimizers:
134
- conversation_prompt = getattr(Optimizers, optimizer)(
135
- conversation_prompt if conversationally else prompt
136
- )
137
- else:
138
- raise exceptions.FailedToGenerateResponseError(
139
- f"Optimizer is not one of {self.__available_optimizers}"
140
- )
141
- api_key = self._get_api_key()
142
- payload = {
143
- "stream": True,
144
- "model": self.model, # Already resolved to API format
145
- "messages": [
146
- {"role": "user", "content": conversation_prompt}
147
- ],
148
- "params": {},
149
- "features": {"image_generation": False, "web_search": False, "auto_web_search": False, "preview_mode": True, "flags": [], "features": [{"type": "mcp", "server": "vibe-coding", "status": "hidden"}, {"type": "mcp", "server": "ppt-maker", "status": "hidden"}, {"type": "mcp", "server": "image-search", "status": "hidden"}], "enable_thinking": True},
150
- "actions": [],
151
- "tags": [],
152
- "chat_id": "local",
153
- "id": str(uuid.uuid4())
154
- }
155
-
156
- def for_stream():
157
- streaming_text = ""
158
- try:
159
- cookie = self._get_cookie()
160
- response = self.session.post(
161
- self.api_endpoint,
162
- json=payload,
163
- stream=True,
164
- timeout=self.timeout,
165
- impersonate="chrome120",
166
- headers={
167
- "Authorization": f"Bearer {api_key}",
168
- "x-fe-version": "prod-fe-1.0.70",
169
- }
170
- )
171
- response.raise_for_status()
172
-
173
- def glm_content_extractor(chunk):
174
- if not isinstance(chunk, dict) or chunk.get("type") != "chat:completion":
175
- return None
176
- data = chunk.get("data", {})
177
- phase = data.get("phase")
178
- usage = data.get("usage")
179
- if usage:
180
- return None
181
- delta_content = data.get("delta_content")
182
- if delta_content:
183
- if phase == "thinking":
184
- # Remove details/summary tags if present
185
- split_text = delta_content.split("</summary>\n>")[-1]
186
- return {"reasoning_content": split_text}
187
- elif phase == "answer":
188
- return {"content": delta_content}
189
- else:
190
- return {"content": delta_content}
191
- return None
192
-
193
- processed_stream = sanitize_stream(
194
- data=response.iter_content(chunk_size=None),
195
- intro_value="data:",
196
- to_json=True,
197
- content_extractor=glm_content_extractor,
198
- yield_raw_on_error=False,
199
- raw=False
200
- )
201
- last_content = ""
202
- last_reasoning = ""
203
- in_think = False
204
- for chunk in processed_stream:
205
- if not chunk:
206
- continue
207
- content = chunk.get('content') if isinstance(chunk, dict) else None
208
- reasoning = chunk.get('reasoning_content') if isinstance(chunk, dict) else None
209
- # Handle reasoning_content with <think> tags
210
- if reasoning and reasoning != last_reasoning:
211
- if not in_think:
212
- yield "<think>\n\n"
213
- in_think = True
214
- yield reasoning
215
- last_reasoning = reasoning
216
- # If we were in <think> and now have new content, close <think>
217
- if in_think and content and content != last_content:
218
- yield "\n</think>\n\n"
219
- in_think = False
220
- # Handle normal content
221
- if content and content != last_content:
222
- yield content
223
- streaming_text += content
224
- last_content = content
225
- if not raw:
226
- self.last_response = {"text": content}
227
- self.conversation.update_chat_history(prompt, streaming_text)
228
- except CurlError as e:
229
- raise exceptions.APIConnectionError(f"Request failed (CurlError): {e}") from e
230
- except Exception as e:
231
- raise exceptions.FailedToGenerateResponseError(f"An unexpected error occurred ({type(e).__name__}): {e}") from e
232
-
233
- def for_non_stream():
234
- full_text = ""
235
- try:
236
- for chunk_data in for_stream():
237
- if raw:
238
- if isinstance(chunk_data, str):
239
- full_text += chunk_data
240
- else:
241
- if isinstance(chunk_data, dict) and "text" in chunk_data:
242
- full_text += chunk_data["text"]
243
- except Exception as e:
244
- if not full_text:
245
- raise exceptions.FailedToGenerateResponseError(f"Failed to get non-stream response: {str(e)}") from e
246
- self.last_response = {"text": full_text}
247
- return full_text if raw else self.last_response
248
- return for_stream() if stream else for_non_stream()
249
-
250
-
251
- def chat(
252
- self,
253
- prompt: str,
254
- stream: bool = False,
255
- optimizer: str = None,
256
- conversationally: bool = False,
257
- raw: bool = False,
258
- ) -> Union[str, Generator[str, None, None]]:
259
- """Generate response `str`"""
260
-
261
- def for_stream():
262
- for response in self.ask(
263
- prompt, True, raw=raw, optimizer=optimizer, conversationally=conversationally
264
- ):
265
- if raw:
266
- yield response
267
- else:
268
- # Only call get_message on dicts, yield str directly
269
- if isinstance(response, dict):
270
- yield self.get_message(response)
271
- elif isinstance(response, str):
272
- yield response
273
-
274
- def for_non_stream():
275
- result = self.ask(
276
- prompt,
277
- False,
278
- raw=raw,
279
- optimizer=optimizer,
280
- conversationally=conversationally,
281
- )
282
- if raw:
283
- return result if isinstance(result, str) else self.get_message(result)
284
- else:
285
- return self.get_message(result)
286
-
287
- return for_stream() if stream else for_non_stream()
288
-
289
-
290
- def get_message(self, response: dict) -> str:
291
- """Retrieves message only from response"""
292
- assert isinstance(response, dict), "Response should be of dict data-type only"
293
- return response.get("text", "")
294
-
295
-
296
-
297
- if __name__ == "__main__":
298
- from rich import print
299
- ai = ChatGLM(model="glm-4-32B")
300
- response = ai.chat("hi", stream=True, raw=False)
301
- for chunk in response:
1
+ from curl_cffi import CurlError
2
+ from curl_cffi.requests import Session
3
+ from typing import Any, Dict, Optional, Generator, List, Union
4
+ import uuid
5
+ import time
6
+ import urllib.parse
7
+ from webscout.AIutel import Optimizers
8
+ from webscout.AIutel import Conversation
9
+ from webscout.AIutel import AwesomePrompts, sanitize_stream # Import sanitize_stream
10
+ from webscout.AIbase import Provider
11
+ from webscout import exceptions
12
+ from webscout.litagent import LitAgent
13
+
14
+
15
+ class ChatGLM(Provider):
16
+ """
17
+ A class to interact with the Z.AI Chat API (GLM-4.5).
18
+ """
19
+ required_auth = False
20
+ url = "https://chat.z.ai"
21
+ # Model nickname mapping system
22
+ MODEL_MAPPING = {
23
+ "glm-4.5V": "glm-4.5v",
24
+ "glm-4-32B": "main_chat",
25
+ "glm-4.5-Air": "0727-106B-API",
26
+ "glm-4.5": "0727-360B-API",
27
+ "glm-4.6": "GLM-4-6-API-V1",
28
+ # Add more nicknames as needed
29
+ }
30
+ # Reverse mapping: API format to nickname
31
+ GLM_TO_MODEL = {v: k for k, v in MODEL_MAPPING.items()}
32
+ AVAILABLE_MODELS = list(MODEL_MAPPING.keys()) + list(GLM_TO_MODEL.keys()) + ["0727-106B-API", "0727-360B-API", "glm-4.5v", "main_chat"]
33
+
34
+ @classmethod
35
+ def _resolve_model(cls, model: str) -> str:
36
+ """
37
+ Resolve a model nickname or API name to the API format.
38
+ """
39
+ if model in cls.GLM_TO_MODEL:
40
+ return model
41
+ if model in cls.MODEL_MAPPING:
42
+ return cls.MODEL_MAPPING[model]
43
+ # fallback to direct API name if present
44
+ if model in ["0727-106B-API", "0727-360B-API", "glm-4.5v", "main_chat"]:
45
+ return model
46
+ raise ValueError(f"Invalid model: {model}. Choose from: {cls.AVAILABLE_MODELS}")
47
+ def __init__(
48
+ self,
49
+ is_conversation: bool = True,
50
+ max_tokens: int = 600,
51
+ timeout: int = 30,
52
+ intro: str = None,
53
+ filepath: str = None,
54
+ update_file: bool = True,
55
+ proxies: dict = {},
56
+ history_offset: int = 10250,
57
+ act: str = None,
58
+ model: str = "0727-106B-API",
59
+ ):
60
+ """Initializes the Z.AI Chat API client."""
61
+ self.session = Session()
62
+ self.is_conversation = is_conversation
63
+ self.max_tokens_to_sample = max_tokens
64
+ self.timeout = timeout
65
+ self.last_response = {}
66
+ self.headers = {
67
+ 'Accept-Language': 'en-US,en;q=0.9',
68
+ 'App-Name': 'chatglm',
69
+ 'Content-Type': 'application/json',
70
+ 'Origin': self.url,
71
+ 'User-Agent': LitAgent().random(),
72
+ 'X-App-Platform': 'pc',
73
+ 'X-App-Version': '0.0.1',
74
+ 'Accept': 'text/event-stream',
75
+ }
76
+ self.api_endpoint = f"{self.url}/api/chat/completions"
77
+ self.__available_optimizers = (
78
+ method
79
+ for method in dir(Optimizers)
80
+ if callable(getattr(Optimizers, method)) and not method.startswith("__")
81
+ )
82
+ self.session.headers.update(self.headers)
83
+ Conversation.intro = (
84
+ AwesomePrompts().get_act(
85
+ act, raise_not_found=True, default=None, case_insensitive=True
86
+ )
87
+ if act
88
+ else intro or Conversation.intro
89
+ )
90
+ self.conversation = Conversation(
91
+ is_conversation, self.max_tokens_to_sample, filepath, update_file
92
+ )
93
+ self.conversation.history_offset = history_offset
94
+ self.session.proxies = proxies
95
+ # Use nickname resolution for model
96
+ self.model = self._resolve_model(model)
97
+
98
+ def _get_api_key(self):
99
+ if not hasattr(self, 'api_key') or not self.api_key:
100
+ response = self.session.get(f"{self.url}/api/v1/auths/")
101
+ self.api_key = response.json().get("token")
102
+ return self.api_key
103
+
104
+ def _get_user_id(self):
105
+ """Get user_id from the auth response"""
106
+ if not hasattr(self, 'user_id') or not self.user_id:
107
+ response = self.session.get(f"{self.url}/api/v1/auths/")
108
+ data = response.json()
109
+ self.user_id = data.get("id", str(uuid.uuid4()))
110
+ return self.user_id
111
+
112
+ def _get_cookie(self):
113
+ """Get authentication cookie from the site"""
114
+ if not hasattr(self, 'cookie') or not self.cookie:
115
+ response = self.session.get(f"{self.url}/")
116
+ self.cookie = response.headers.get('Set-Cookie', '')
117
+ return self.cookie
118
+
119
+ def _build_api_url(self, chat_id: str = "local"):
120
+ """Build the API URL with all required query parameters"""
121
+ api_key = self._get_api_key()
122
+ user_id = self._get_user_id()
123
+ timestamp = str(int(time.time() * 1000))
124
+ request_id = str(uuid.uuid4())
125
+ user_agent = self.session.headers.get('User-Agent', 'Mozilla/5.0')
126
+
127
+ params = {
128
+ 'timestamp': timestamp,
129
+ 'requestId': request_id,
130
+ 'user_id': user_id,
131
+ 'version': '0.0.1',
132
+ 'platform': 'web',
133
+ 'token': api_key,
134
+ 'user_agent': user_agent,
135
+ 'language': 'en-US',
136
+ 'languages': 'en-US,en',
137
+ 'timezone': 'UTC',
138
+ 'cookie_enabled': 'true',
139
+ 'screen_width': '1920',
140
+ 'screen_height': '1080',
141
+ 'screen_resolution': '1920x1080',
142
+ 'viewport_height': '1080',
143
+ 'viewport_width': '1920',
144
+ 'viewport_size': '1920x1080',
145
+ 'color_depth': '24',
146
+ 'pixel_ratio': '1',
147
+ 'current_url': f'https://chat.z.ai/c/{chat_id}',
148
+ 'pathname': f'/c/{chat_id}',
149
+ 'search': '',
150
+ 'hash': '',
151
+ 'host': 'chat.z.ai',
152
+ 'hostname': 'chat.z.ai',
153
+ 'protocol': 'https:',
154
+ 'referrer': '',
155
+ 'title': 'Z.ai Chat - Free AI powered by GLM-4.6',
156
+ 'timezone_offset': '0',
157
+ 'is_mobile': 'false',
158
+ 'is_touch': 'false',
159
+ 'max_touch_points': '0',
160
+ 'browser_name': 'Chrome',
161
+ 'os_name': 'Windows',
162
+ 'signature_timestamp': timestamp
163
+ }
164
+
165
+ query_string = urllib.parse.urlencode(params)
166
+ return f"{self.api_endpoint}?{query_string}"
167
+
168
+
169
+ # _zai_extractor removed; use extract_regexes in sanitize_stream
170
+
171
+
172
+ def ask(
173
+ self,
174
+ prompt: str,
175
+ stream: bool = False,
176
+ raw: bool = False,
177
+ optimizer: str = None,
178
+ conversationally: bool = False,
179
+ ) -> Union[Dict[str, Any], Generator[Any, None, None]]:
180
+ """Chat with Z.AI API
181
+ Args:
182
+ prompt (str): Prompt to be sent.
183
+ stream (bool, optional): Flag for streaming response. Defaults to False.
184
+ raw (bool, optional): Stream back raw response as received. Defaults to False.
185
+ optimizer (str, optional): Prompt optimizer name. Defaults to None.
186
+ conversationally (bool, optional): Chat conversationally when using optimizer. Defaults to False.
187
+ model (str, optional): Model name. Defaults to None.
188
+ Returns:
189
+ Union[Dict, Generator[Dict, None, None]]: Response generated
190
+ """
191
+ conversation_prompt = self.conversation.gen_complete_prompt(prompt)
192
+ if optimizer:
193
+ if optimizer in self.__available_optimizers:
194
+ conversation_prompt = getattr(Optimizers, optimizer)(
195
+ conversation_prompt if conversationally else prompt
196
+ )
197
+ else:
198
+ raise exceptions.FailedToGenerateResponseError(
199
+ f"Optimizer is not one of {self.__available_optimizers}"
200
+ )
201
+ api_key = self._get_api_key()
202
+ chat_id = str(uuid.uuid4())
203
+ payload = {
204
+ "stream": True,
205
+ "model": self.model, # Already resolved to API format
206
+ "messages": [
207
+ {"role": "user", "content": conversation_prompt}
208
+ ],
209
+ "params": {},
210
+ "features": {
211
+ "image_generation": False,
212
+ "web_search": False,
213
+ "auto_web_search": False,
214
+ "preview_mode": True,
215
+ "flags": [],
216
+ "features": [
217
+ {"type": "mcp", "server": "vibe-coding", "status": "hidden"},
218
+ {"type": "mcp", "server": "ppt-maker", "status": "hidden"},
219
+ {"type": "mcp", "server": "image-search", "status": "hidden"},
220
+ {"type": "mcp", "server": "deep-research", "status": "hidden"},
221
+ {"type": "tool_selector", "server": "tool_selector", "status": "hidden"},
222
+ {"type": "mcp", "server": "advanced-search", "status": "hidden"}
223
+ ],
224
+ "enable_thinking": True
225
+ },
226
+ "actions": [],
227
+ "tags": [],
228
+ "chat_id": chat_id,
229
+ "id": str(uuid.uuid4())
230
+ }
231
+
232
+ def for_stream():
233
+ streaming_text = ""
234
+ try:
235
+ cookie = self._get_cookie()
236
+ api_url = self._build_api_url(chat_id)
237
+ response = self.session.post(
238
+ api_url,
239
+ json=payload,
240
+ stream=True,
241
+ timeout=self.timeout,
242
+ impersonate="chrome120",
243
+ headers={
244
+ "Authorization": f"Bearer {api_key}",
245
+ "x-fe-version": "prod-fe-1.0.95",
246
+ "accept": "*/*",
247
+ "accept-language": "en-US",
248
+ "content-type": "application/json",
249
+ "dnt": "1",
250
+ "origin": self.url,
251
+ "referer": f"{self.url}/c/{chat_id}",
252
+ "sec-ch-ua": '"Chromium";v="140", "Not=A?Brand";v="24", "Microsoft Edge";v="140"',
253
+ "sec-ch-ua-mobile": "?0",
254
+ "sec-ch-ua-platform": '"Windows"',
255
+ "sec-fetch-dest": "empty",
256
+ "sec-fetch-mode": "cors",
257
+ "sec-fetch-site": "same-origin",
258
+ "sec-gpc": "1",
259
+ }
260
+ )
261
+ response.raise_for_status()
262
+
263
+ def glm_content_extractor(chunk):
264
+ if not isinstance(chunk, dict) or chunk.get("type") != "chat:completion":
265
+ return None
266
+ data = chunk.get("data", {})
267
+ phase = data.get("phase")
268
+ usage = data.get("usage")
269
+ if usage:
270
+ return None
271
+ delta_content = data.get("delta_content")
272
+ if delta_content:
273
+ if phase == "thinking":
274
+ # Remove details/summary tags if present
275
+ split_text = delta_content.split("</summary>\n>")[-1]
276
+ return {"reasoning_content": split_text}
277
+ elif phase == "answer":
278
+ return {"content": delta_content}
279
+ else:
280
+ return {"content": delta_content}
281
+ return None
282
+
283
+ processed_stream = sanitize_stream(
284
+ data=response.iter_content(chunk_size=None),
285
+ intro_value="data:",
286
+ to_json=True,
287
+ content_extractor=glm_content_extractor,
288
+ yield_raw_on_error=False,
289
+ raw=False
290
+ )
291
+ last_content = ""
292
+ last_reasoning = ""
293
+ in_think = False
294
+ for chunk in processed_stream:
295
+ if not chunk:
296
+ continue
297
+ content = chunk.get('content') if isinstance(chunk, dict) else None
298
+ reasoning = chunk.get('reasoning_content') if isinstance(chunk, dict) else None
299
+ # Handle reasoning_content with <think> tags
300
+ if reasoning and reasoning != last_reasoning:
301
+ if not in_think:
302
+ yield "<think>\n\n"
303
+ in_think = True
304
+ yield reasoning
305
+ last_reasoning = reasoning
306
+ # If we were in <think> and now have new content, close <think>
307
+ if in_think and content and content != last_content:
308
+ yield "\n</think>\n\n"
309
+ in_think = False
310
+ # Handle normal content
311
+ if content and content != last_content:
312
+ yield content
313
+ streaming_text += content
314
+ last_content = content
315
+ # Close <think> tag if still open at end
316
+ if in_think:
317
+ yield "\n</think>\n\n"
318
+ if not raw:
319
+ self.last_response = {"text": streaming_text}
320
+ self.conversation.update_chat_history(prompt, streaming_text)
321
+ except CurlError as e:
322
+ raise exceptions.APIConnectionError(f"Request failed (CurlError): {e}") from e
323
+ except Exception as e:
324
+ raise exceptions.FailedToGenerateResponseError(f"An unexpected error occurred ({type(e).__name__}): {e}") from e
325
+
326
+ def for_non_stream():
327
+ full_text = ""
328
+ try:
329
+ for chunk_data in for_stream():
330
+ if raw:
331
+ if isinstance(chunk_data, str):
332
+ full_text += chunk_data
333
+ else:
334
+ if isinstance(chunk_data, dict) and "text" in chunk_data:
335
+ full_text += chunk_data["text"]
336
+ except Exception as e:
337
+ if not full_text:
338
+ raise exceptions.FailedToGenerateResponseError(f"Failed to get non-stream response: {str(e)}") from e
339
+ self.last_response = {"text": full_text}
340
+ return full_text if raw else self.last_response
341
+ return for_stream() if stream else for_non_stream()
342
+
343
+
344
+ def chat(
345
+ self,
346
+ prompt: str,
347
+ stream: bool = False,
348
+ optimizer: str = None,
349
+ conversationally: bool = False,
350
+ raw: bool = False,
351
+ ) -> Union[str, Generator[str, None, None]]:
352
+ """Generate response `str`"""
353
+
354
+ def for_stream():
355
+ for response in self.ask(
356
+ prompt, True, raw=raw, optimizer=optimizer, conversationally=conversationally
357
+ ):
358
+ if raw:
359
+ yield response
360
+ else:
361
+ # Only call get_message on dicts, yield str directly
362
+ if isinstance(response, dict):
363
+ yield self.get_message(response)
364
+ elif isinstance(response, str):
365
+ yield response
366
+
367
+ def for_non_stream():
368
+ result = self.ask(
369
+ prompt,
370
+ False,
371
+ raw=raw,
372
+ optimizer=optimizer,
373
+ conversationally=conversationally,
374
+ )
375
+ if raw:
376
+ return result if isinstance(result, str) else self.get_message(result)
377
+ else:
378
+ return self.get_message(result)
379
+
380
+ return for_stream() if stream else for_non_stream()
381
+
382
+
383
+ def get_message(self, response: dict) -> str:
384
+ """Retrieves message only from response"""
385
+ assert isinstance(response, dict), "Response should be of dict data-type only"
386
+ return response.get("text", "")
387
+
388
+
389
+
390
+ if __name__ == "__main__":
391
+ from rich import print
392
+ ai = ChatGLM(model="glm-4.6")
393
+ response = ai.chat("hi", stream=True, raw=True)
394
+ for chunk in response:
302
395
  print(chunk, end="", flush=True)