webscout 8.3.7__py3-none-any.whl → 2025.10.11__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 (273) 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/Apriel.py +306 -0
  65. webscout/Provider/ChatGPTClone.py +236 -236
  66. webscout/Provider/ChatSandbox.py +343 -343
  67. webscout/Provider/Cloudflare.py +324 -324
  68. webscout/Provider/Cohere.py +208 -208
  69. webscout/Provider/Deepinfra.py +370 -366
  70. webscout/Provider/ExaAI.py +260 -260
  71. webscout/Provider/ExaChat.py +308 -308
  72. webscout/Provider/Flowith.py +221 -221
  73. webscout/Provider/GMI.py +293 -0
  74. webscout/Provider/Gemini.py +164 -164
  75. webscout/Provider/GeminiProxy.py +167 -167
  76. webscout/Provider/GithubChat.py +371 -372
  77. webscout/Provider/Groq.py +800 -800
  78. webscout/Provider/HeckAI.py +383 -383
  79. webscout/Provider/Jadve.py +282 -282
  80. webscout/Provider/K2Think.py +307 -307
  81. webscout/Provider/Koboldai.py +205 -205
  82. webscout/Provider/LambdaChat.py +423 -423
  83. webscout/Provider/Nemotron.py +244 -244
  84. webscout/Provider/Netwrck.py +248 -248
  85. webscout/Provider/OLLAMA.py +395 -395
  86. webscout/Provider/OPENAI/Cloudflare.py +393 -393
  87. webscout/Provider/OPENAI/FalconH1.py +451 -451
  88. webscout/Provider/OPENAI/FreeGemini.py +296 -296
  89. webscout/Provider/OPENAI/K2Think.py +431 -431
  90. webscout/Provider/OPENAI/NEMOTRON.py +240 -240
  91. webscout/Provider/OPENAI/PI.py +427 -427
  92. webscout/Provider/OPENAI/README.md +959 -959
  93. webscout/Provider/OPENAI/TogetherAI.py +345 -345
  94. webscout/Provider/OPENAI/TwoAI.py +465 -465
  95. webscout/Provider/OPENAI/__init__.py +33 -18
  96. webscout/Provider/OPENAI/base.py +248 -248
  97. webscout/Provider/OPENAI/chatglm.py +528 -0
  98. webscout/Provider/OPENAI/chatgpt.py +592 -592
  99. webscout/Provider/OPENAI/chatgptclone.py +521 -521
  100. webscout/Provider/OPENAI/chatsandbox.py +202 -202
  101. webscout/Provider/OPENAI/deepinfra.py +318 -314
  102. webscout/Provider/OPENAI/e2b.py +1665 -1665
  103. webscout/Provider/OPENAI/exaai.py +420 -420
  104. webscout/Provider/OPENAI/exachat.py +452 -452
  105. webscout/Provider/OPENAI/friendli.py +232 -232
  106. webscout/Provider/OPENAI/{refact.py → gmi.py} +324 -274
  107. webscout/Provider/OPENAI/groq.py +364 -364
  108. webscout/Provider/OPENAI/heckai.py +314 -314
  109. webscout/Provider/OPENAI/llmchatco.py +337 -337
  110. webscout/Provider/OPENAI/netwrck.py +355 -355
  111. webscout/Provider/OPENAI/oivscode.py +290 -290
  112. webscout/Provider/OPENAI/opkfc.py +518 -518
  113. webscout/Provider/OPENAI/pydantic_imports.py +1 -1
  114. webscout/Provider/OPENAI/scirachat.py +535 -535
  115. webscout/Provider/OPENAI/sonus.py +308 -308
  116. webscout/Provider/OPENAI/standardinput.py +442 -442
  117. webscout/Provider/OPENAI/textpollinations.py +340 -340
  118. webscout/Provider/OPENAI/toolbaz.py +419 -416
  119. webscout/Provider/OPENAI/typefully.py +362 -362
  120. webscout/Provider/OPENAI/utils.py +295 -295
  121. webscout/Provider/OPENAI/venice.py +436 -436
  122. webscout/Provider/OPENAI/wisecat.py +387 -387
  123. webscout/Provider/OPENAI/writecream.py +166 -166
  124. webscout/Provider/OPENAI/x0gpt.py +378 -378
  125. webscout/Provider/OPENAI/yep.py +389 -389
  126. webscout/Provider/OpenGPT.py +230 -230
  127. webscout/Provider/Openai.py +243 -243
  128. webscout/Provider/PI.py +405 -405
  129. webscout/Provider/Perplexitylabs.py +430 -430
  130. webscout/Provider/QwenLM.py +272 -272
  131. webscout/Provider/STT/__init__.py +16 -1
  132. webscout/Provider/Sambanova.py +257 -257
  133. webscout/Provider/StandardInput.py +309 -309
  134. webscout/Provider/TTI/README.md +82 -82
  135. webscout/Provider/TTI/__init__.py +33 -18
  136. webscout/Provider/TTI/aiarta.py +413 -413
  137. webscout/Provider/TTI/base.py +136 -136
  138. webscout/Provider/TTI/bing.py +243 -243
  139. webscout/Provider/TTI/gpt1image.py +149 -149
  140. webscout/Provider/TTI/imagen.py +196 -196
  141. webscout/Provider/TTI/infip.py +211 -211
  142. webscout/Provider/TTI/magicstudio.py +232 -232
  143. webscout/Provider/TTI/monochat.py +219 -219
  144. webscout/Provider/TTI/piclumen.py +214 -214
  145. webscout/Provider/TTI/pixelmuse.py +232 -232
  146. webscout/Provider/TTI/pollinations.py +232 -232
  147. webscout/Provider/TTI/together.py +288 -288
  148. webscout/Provider/TTI/utils.py +12 -12
  149. webscout/Provider/TTI/venice.py +367 -367
  150. webscout/Provider/TTS/README.md +192 -192
  151. webscout/Provider/TTS/__init__.py +33 -18
  152. webscout/Provider/TTS/parler.py +110 -110
  153. webscout/Provider/TTS/streamElements.py +333 -333
  154. webscout/Provider/TTS/utils.py +280 -280
  155. webscout/Provider/TeachAnything.py +237 -237
  156. webscout/Provider/TextPollinationsAI.py +310 -310
  157. webscout/Provider/TogetherAI.py +356 -356
  158. webscout/Provider/TwoAI.py +312 -312
  159. webscout/Provider/TypliAI.py +311 -311
  160. webscout/Provider/UNFINISHED/ChatHub.py +208 -208
  161. webscout/Provider/UNFINISHED/ChutesAI.py +313 -313
  162. webscout/Provider/UNFINISHED/GizAI.py +294 -294
  163. webscout/Provider/UNFINISHED/Marcus.py +198 -198
  164. webscout/Provider/UNFINISHED/Qodo.py +477 -477
  165. webscout/Provider/UNFINISHED/VercelAIGateway.py +338 -338
  166. webscout/Provider/UNFINISHED/XenAI.py +324 -324
  167. webscout/Provider/UNFINISHED/Youchat.py +330 -330
  168. webscout/Provider/UNFINISHED/liner.py +334 -0
  169. webscout/Provider/UNFINISHED/liner_api_request.py +262 -262
  170. webscout/Provider/UNFINISHED/puterjs.py +634 -634
  171. webscout/Provider/UNFINISHED/samurai.py +223 -223
  172. webscout/Provider/UNFINISHED/test_lmarena.py +119 -119
  173. webscout/Provider/Venice.py +250 -250
  174. webscout/Provider/VercelAI.py +256 -256
  175. webscout/Provider/WiseCat.py +231 -231
  176. webscout/Provider/WrDoChat.py +366 -366
  177. webscout/Provider/__init__.py +33 -18
  178. webscout/Provider/ai4chat.py +174 -174
  179. webscout/Provider/akashgpt.py +331 -331
  180. webscout/Provider/cerebras.py +446 -446
  181. webscout/Provider/chatglm.py +394 -301
  182. webscout/Provider/cleeai.py +211 -211
  183. webscout/Provider/elmo.py +282 -282
  184. webscout/Provider/geminiapi.py +208 -208
  185. webscout/Provider/granite.py +261 -261
  186. webscout/Provider/hermes.py +263 -263
  187. webscout/Provider/julius.py +223 -223
  188. webscout/Provider/learnfastai.py +309 -309
  189. webscout/Provider/llama3mitril.py +214 -214
  190. webscout/Provider/llmchat.py +243 -243
  191. webscout/Provider/llmchatco.py +290 -290
  192. webscout/Provider/meta.py +801 -801
  193. webscout/Provider/oivscode.py +309 -309
  194. webscout/Provider/scira_chat.py +383 -383
  195. webscout/Provider/searchchat.py +292 -292
  196. webscout/Provider/sonus.py +258 -258
  197. webscout/Provider/toolbaz.py +370 -367
  198. webscout/Provider/turboseek.py +273 -273
  199. webscout/Provider/typefully.py +207 -207
  200. webscout/Provider/yep.py +372 -372
  201. webscout/__init__.py +30 -31
  202. webscout/__main__.py +5 -5
  203. webscout/auth/api_key_manager.py +189 -189
  204. webscout/auth/config.py +175 -175
  205. webscout/auth/models.py +185 -185
  206. webscout/auth/routes.py +664 -664
  207. webscout/auth/simple_logger.py +236 -236
  208. webscout/cli.py +523 -523
  209. webscout/conversation.py +438 -438
  210. webscout/exceptions.py +361 -361
  211. webscout/litagent/Readme.md +298 -298
  212. webscout/litagent/__init__.py +28 -28
  213. webscout/litagent/agent.py +581 -581
  214. webscout/litagent/constants.py +59 -59
  215. webscout/litprinter/__init__.py +58 -58
  216. webscout/models.py +181 -181
  217. webscout/optimizers.py +419 -419
  218. webscout/prompt_manager.py +288 -288
  219. webscout/sanitize.py +1078 -1078
  220. webscout/scout/README.md +401 -401
  221. webscout/scout/__init__.py +8 -8
  222. webscout/scout/core/__init__.py +6 -6
  223. webscout/scout/core/crawler.py +297 -297
  224. webscout/scout/core/scout.py +706 -706
  225. webscout/scout/core/search_result.py +95 -95
  226. webscout/scout/core/text_analyzer.py +62 -62
  227. webscout/scout/core/text_utils.py +277 -277
  228. webscout/scout/core/web_analyzer.py +51 -51
  229. webscout/scout/element.py +599 -599
  230. webscout/scout/parsers/__init__.py +69 -69
  231. webscout/scout/parsers/html5lib_parser.py +172 -172
  232. webscout/scout/parsers/html_parser.py +236 -236
  233. webscout/scout/parsers/lxml_parser.py +178 -178
  234. webscout/scout/utils.py +37 -37
  235. webscout/swiftcli/Readme.md +323 -323
  236. webscout/swiftcli/__init__.py +95 -95
  237. webscout/swiftcli/core/__init__.py +7 -7
  238. webscout/swiftcli/core/cli.py +308 -308
  239. webscout/swiftcli/core/context.py +104 -104
  240. webscout/swiftcli/core/group.py +241 -241
  241. webscout/swiftcli/decorators/__init__.py +28 -28
  242. webscout/swiftcli/decorators/command.py +221 -221
  243. webscout/swiftcli/decorators/options.py +220 -220
  244. webscout/swiftcli/decorators/output.py +302 -302
  245. webscout/swiftcli/exceptions.py +21 -21
  246. webscout/swiftcli/plugins/__init__.py +9 -9
  247. webscout/swiftcli/plugins/base.py +135 -135
  248. webscout/swiftcli/plugins/manager.py +269 -269
  249. webscout/swiftcli/utils/__init__.py +59 -59
  250. webscout/swiftcli/utils/formatting.py +252 -252
  251. webscout/swiftcli/utils/parsing.py +267 -267
  252. webscout/update_checker.py +117 -117
  253. webscout/version.py +1 -1
  254. webscout/webscout_search.py +1183 -1183
  255. webscout/webscout_search_async.py +649 -649
  256. webscout/yep_search.py +346 -346
  257. webscout/zeroart/README.md +89 -89
  258. webscout/zeroart/__init__.py +134 -134
  259. webscout/zeroart/base.py +66 -66
  260. webscout/zeroart/effects.py +100 -100
  261. webscout/zeroart/fonts.py +1238 -1238
  262. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/METADATA +937 -937
  263. webscout-2025.10.11.dist-info/RECORD +300 -0
  264. webscout/Provider/AISEARCH/DeepFind.py +0 -254
  265. webscout/Provider/OPENAI/Qwen3.py +0 -303
  266. webscout/Provider/OPENAI/qodo.py +0 -630
  267. webscout/Provider/OPENAI/xenai.py +0 -514
  268. webscout/tempid.py +0 -134
  269. webscout-8.3.7.dist-info/RECORD +0 -301
  270. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/WHEEL +0 -0
  271. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/entry_points.txt +0 -0
  272. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/licenses/LICENSE.md +0 -0
  273. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/top_level.txt +0 -0
@@ -1,258 +1,258 @@
1
- from curl_cffi.requests import Session
2
- from curl_cffi import CurlError
3
- import json
4
- from typing import Union, Any, Dict, Generator
5
-
6
- from webscout.AIutel import Optimizers
7
- from webscout.AIutel import Conversation
8
- from webscout.AIutel import AwesomePrompts
9
- from webscout.AIbase import Provider
10
- from webscout import exceptions
11
-
12
- class Sambanova(Provider):
13
- """
14
- A class to interact with the Sambanova API.
15
- """
16
- required_auth = True
17
- AVAILABLE_MODELS = [
18
- "DeepSeek-R1-0528",
19
- "DeepSeek-R1-Distill-Llama-70B",
20
- "DeepSeek-V3.1",
21
- "gpt-oss-120b",
22
- "Qwen3-32B",
23
- "DeepSeek-V3-0324",
24
- "Meta-Llama-3.1-8B-Instruct",
25
- "Meta-Llama-3.3-70B-Instruct",
26
- "Llama-3.3-Swallow-70B-Instruct-v0.4",
27
- "Llama-4-Maverick-17B-128E-Instruct"
28
- ]
29
-
30
- def __init__(
31
- self,
32
- api_key: str = None,
33
- is_conversation: bool = True,
34
- max_tokens: int = 600,
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 = "Meta-Llama-3.1-8B-Instruct",
43
- system_prompt: str = "You are a helpful AI assistant.",
44
- ):
45
- """
46
- Initializes the Sambanova API with given parameters.
47
- """
48
- if model not in self.AVAILABLE_MODELS:
49
- raise ValueError(f"Invalid model: {model}. Choose from: {self.AVAILABLE_MODELS}")
50
-
51
- self.api_key = api_key
52
- self.model = model
53
- self.system_prompt = system_prompt
54
-
55
- # Initialize curl_cffi Session
56
- self.session = Session()
57
- self.is_conversation = is_conversation
58
- self.max_tokens_to_sample = max_tokens
59
- self.timeout = timeout
60
- self.last_response = ""
61
-
62
- self.__available_optimizers = (
63
- method
64
- for method in dir(Optimizers)
65
- if callable(getattr(Optimizers, method)) and not method.startswith("__")
66
- )
67
- Conversation.intro = (
68
- AwesomePrompts().get_act(
69
- act, raise_not_found=True, default=None, case_insensitive=True
70
- )
71
- if act
72
- else intro or Conversation.intro
73
- )
74
- self.conversation = Conversation(
75
- is_conversation, self.max_tokens_to_sample, filepath, update_file
76
- )
77
- self.conversation.history_offset = history_offset
78
-
79
- # Configure the API base URL and headers
80
- self.base_url = "https://api.sambanova.ai/v1/chat/completions"
81
- self.headers = {
82
- "Authorization": f"Bearer {self.api_key}",
83
- "Content-Type": "application/json",
84
- # Add User-Agent or sec-ch-ua headers if needed, or rely on impersonate
85
- }
86
-
87
- # Update curl_cffi session headers and proxies
88
- self.session.headers.update(self.headers)
89
- self.session.proxies = proxies # Assign proxies directly
90
-
91
- def ask(
92
- self,
93
- prompt: str,
94
- stream: bool = False,
95
- raw: bool = False,
96
- optimizer: str = None,
97
- conversationally: bool = False,
98
- ) -> Union[Any, Generator[Any, None, None]]:
99
- """Chat with AI using the Sambanova API."""
100
- conversation_prompt = self.conversation.gen_complete_prompt(prompt)
101
- if optimizer:
102
- if optimizer in self.__available_optimizers:
103
- conversation_prompt = getattr(Optimizers, optimizer)(
104
- conversation_prompt if conversationally else prompt
105
- )
106
- else:
107
- raise Exception(
108
- f"Optimizer is not one of {list(self.__available_optimizers)}"
109
- )
110
-
111
- payload = {
112
- "model": self.model,
113
- "messages": [
114
- {"role": "system", "content": self.system_prompt},
115
- {"role": "user", "content": conversation_prompt},
116
- ],
117
- "max_tokens": self.max_tokens_to_sample,
118
- "stream": True # API seems to always stream based on endpoint name
119
- }
120
-
121
- def for_stream():
122
- streaming_text = "" # Initialize outside try block
123
- try:
124
- # Use curl_cffi session post with impersonate
125
- response = self.session.post(
126
- self.base_url,
127
- # headers are set on the session
128
- json=payload,
129
- stream=True,
130
- timeout=self.timeout,
131
- # proxies are set on the session
132
- impersonate="chrome110" # Use a common impersonation profile
133
- )
134
- response.raise_for_status() # Check for HTTP errors
135
-
136
- # Iterate over bytes and decode manually
137
- for line_bytes in response.iter_lines():
138
- if line_bytes:
139
- try:
140
- line_str = line_bytes.decode('utf-8').strip()
141
- if line_str.startswith("data:"):
142
- data = line_str[5:].strip()
143
- else:
144
- data = line_str # Handle cases where 'data:' prefix might be missing
145
-
146
- if data == "[DONE]":
147
- break
148
-
149
- json_data = json.loads(data)
150
- # Skip entries without valid choices
151
- if not json_data.get("choices"):
152
- continue
153
- choice = json_data["choices"][0]
154
- delta = choice.get("delta", {})
155
- if "content" in delta:
156
- content = delta["content"]
157
- if content: # Ensure content is not None or empty
158
- streaming_text += content
159
- resp = {"text": content}
160
- # Yield dict or raw string chunk
161
- yield resp if not raw else content
162
- # If finish_reason is provided, consider the stream complete
163
- if choice.get("finish_reason"):
164
- break
165
- except (json.JSONDecodeError, UnicodeDecodeError):
166
- continue # Ignore lines that are not valid JSON or cannot be decoded
167
-
168
- # Update history after stream finishes
169
- self.last_response = streaming_text # Store aggregated text
170
- self.conversation.update_chat_history(
171
- prompt, self.last_response
172
- )
173
- except CurlError as e: # Catch CurlError
174
- raise exceptions.ProviderConnectionError(f"Request failed (CurlError): {e}") from e
175
- except Exception as e: # Catch other potential exceptions (like HTTPError)
176
- err_text = getattr(e, 'response', None) and getattr(e.response, 'text', '')
177
- raise exceptions.ProviderConnectionError(f"Request failed ({type(e).__name__}): {e} - {err_text}") from e
178
-
179
-
180
- def for_non_stream():
181
- # Aggregate the stream using the updated for_stream logic
182
- full_response_text = ""
183
- try:
184
- # Ensure raw=False so for_stream yields dicts
185
- for chunk_data in for_stream():
186
- if isinstance(chunk_data, dict) and "text" in chunk_data:
187
- full_response_text += chunk_data["text"]
188
- # Handle raw string case if raw=True was passed
189
- elif raw and isinstance(chunk_data, str):
190
- full_response_text += chunk_data
191
- except Exception as e:
192
- # If aggregation fails but some text was received, use it. Otherwise, re-raise.
193
- if not full_response_text:
194
- raise exceptions.FailedToGenerateResponseError(f"Failed to get non-stream response: {str(e)}") from e
195
-
196
- # last_response and history are updated within for_stream
197
- # Return the final aggregated response dict or raw string
198
- return full_response_text if raw else {"text": self.last_response} # Return dict for consistency
199
-
200
-
201
- # Since the API endpoint suggests streaming, always call the stream generator.
202
- # The non-stream wrapper will handle aggregation if stream=False.
203
- return for_stream() if stream else for_non_stream()
204
-
205
- def chat(
206
- self,
207
- prompt: str,
208
- stream: bool = False,
209
- optimizer: str = None,
210
- conversationally: bool = False,
211
- ) -> Union[str, Generator[str, None, None]]:
212
- """Generate response `str`"""
213
-
214
- def for_stream_chat():
215
- # ask() yields dicts or strings when streaming
216
- gen = self.ask(
217
- prompt, stream=True, raw=False, # Ensure ask yields dicts
218
- optimizer=optimizer, conversationally=conversationally
219
- )
220
- for response_dict in gen:
221
- yield self.get_message(response_dict) # get_message expects dict or string
222
-
223
- def for_non_stream_chat():
224
- # ask() returns dict or str when not streaming
225
- response_data = self.ask(
226
- prompt,
227
- stream=False,
228
- raw=False, # Ensure ask returns dict
229
- optimizer=optimizer,
230
- conversationally=conversationally,
231
- )
232
- return self.get_message(response_data) # get_message expects dict or string
233
-
234
- return for_stream_chat() if stream else for_non_stream_chat()
235
-
236
- def get_message(self, response: Any) -> str:
237
- """
238
- Retrieves a clean message from the provided response.
239
-
240
- Args:
241
- response: The raw response data.
242
-
243
- Returns:
244
- str: The extracted message.
245
- """
246
- if isinstance(response, str):
247
- return response
248
- elif isinstance(response, dict) and "text" in response:
249
- return response["text"]
250
- return ""
251
-
252
- if __name__ == "__main__":
253
- # Ensure curl_cffi is installed
254
- from rich import print
255
- ai = Sambanova(api_key='')
256
- response = ai.chat(input(">>> "), stream=True)
257
- for chunk in response:
1
+ from curl_cffi.requests import Session
2
+ from curl_cffi import CurlError
3
+ import json
4
+ from typing import Union, Any, Dict, Generator
5
+
6
+ from webscout.AIutel import Optimizers
7
+ from webscout.AIutel import Conversation
8
+ from webscout.AIutel import AwesomePrompts
9
+ from webscout.AIbase import Provider
10
+ from webscout import exceptions
11
+
12
+ class Sambanova(Provider):
13
+ """
14
+ A class to interact with the Sambanova API.
15
+ """
16
+ required_auth = True
17
+ AVAILABLE_MODELS = [
18
+ "DeepSeek-R1-0528",
19
+ "DeepSeek-R1-Distill-Llama-70B",
20
+ "DeepSeek-V3.1",
21
+ "gpt-oss-120b",
22
+ "Qwen3-32B",
23
+ "DeepSeek-V3-0324",
24
+ "Meta-Llama-3.1-8B-Instruct",
25
+ "Meta-Llama-3.3-70B-Instruct",
26
+ "Llama-3.3-Swallow-70B-Instruct-v0.4",
27
+ "Llama-4-Maverick-17B-128E-Instruct"
28
+ ]
29
+
30
+ def __init__(
31
+ self,
32
+ api_key: str = None,
33
+ is_conversation: bool = True,
34
+ max_tokens: int = 600,
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 = "Meta-Llama-3.1-8B-Instruct",
43
+ system_prompt: str = "You are a helpful AI assistant.",
44
+ ):
45
+ """
46
+ Initializes the Sambanova API with given parameters.
47
+ """
48
+ if model not in self.AVAILABLE_MODELS:
49
+ raise ValueError(f"Invalid model: {model}. Choose from: {self.AVAILABLE_MODELS}")
50
+
51
+ self.api_key = api_key
52
+ self.model = model
53
+ self.system_prompt = system_prompt
54
+
55
+ # Initialize curl_cffi Session
56
+ self.session = Session()
57
+ self.is_conversation = is_conversation
58
+ self.max_tokens_to_sample = max_tokens
59
+ self.timeout = timeout
60
+ self.last_response = ""
61
+
62
+ self.__available_optimizers = (
63
+ method
64
+ for method in dir(Optimizers)
65
+ if callable(getattr(Optimizers, method)) and not method.startswith("__")
66
+ )
67
+ Conversation.intro = (
68
+ AwesomePrompts().get_act(
69
+ act, raise_not_found=True, default=None, case_insensitive=True
70
+ )
71
+ if act
72
+ else intro or Conversation.intro
73
+ )
74
+ self.conversation = Conversation(
75
+ is_conversation, self.max_tokens_to_sample, filepath, update_file
76
+ )
77
+ self.conversation.history_offset = history_offset
78
+
79
+ # Configure the API base URL and headers
80
+ self.base_url = "https://api.sambanova.ai/v1/chat/completions"
81
+ self.headers = {
82
+ "Authorization": f"Bearer {self.api_key}",
83
+ "Content-Type": "application/json",
84
+ # Add User-Agent or sec-ch-ua headers if needed, or rely on impersonate
85
+ }
86
+
87
+ # Update curl_cffi session headers and proxies
88
+ self.session.headers.update(self.headers)
89
+ self.session.proxies = proxies # Assign proxies directly
90
+
91
+ def ask(
92
+ self,
93
+ prompt: str,
94
+ stream: bool = False,
95
+ raw: bool = False,
96
+ optimizer: str = None,
97
+ conversationally: bool = False,
98
+ ) -> Union[Any, Generator[Any, None, None]]:
99
+ """Chat with AI using the Sambanova API."""
100
+ conversation_prompt = self.conversation.gen_complete_prompt(prompt)
101
+ if optimizer:
102
+ if optimizer in self.__available_optimizers:
103
+ conversation_prompt = getattr(Optimizers, optimizer)(
104
+ conversation_prompt if conversationally else prompt
105
+ )
106
+ else:
107
+ raise Exception(
108
+ f"Optimizer is not one of {list(self.__available_optimizers)}"
109
+ )
110
+
111
+ payload = {
112
+ "model": self.model,
113
+ "messages": [
114
+ {"role": "system", "content": self.system_prompt},
115
+ {"role": "user", "content": conversation_prompt},
116
+ ],
117
+ "max_tokens": self.max_tokens_to_sample,
118
+ "stream": True # API seems to always stream based on endpoint name
119
+ }
120
+
121
+ def for_stream():
122
+ streaming_text = "" # Initialize outside try block
123
+ try:
124
+ # Use curl_cffi session post with impersonate
125
+ response = self.session.post(
126
+ self.base_url,
127
+ # headers are set on the session
128
+ json=payload,
129
+ stream=True,
130
+ timeout=self.timeout,
131
+ # proxies are set on the session
132
+ impersonate="chrome110" # Use a common impersonation profile
133
+ )
134
+ response.raise_for_status() # Check for HTTP errors
135
+
136
+ # Iterate over bytes and decode manually
137
+ for line_bytes in response.iter_lines():
138
+ if line_bytes:
139
+ try:
140
+ line_str = line_bytes.decode('utf-8').strip()
141
+ if line_str.startswith("data:"):
142
+ data = line_str[5:].strip()
143
+ else:
144
+ data = line_str # Handle cases where 'data:' prefix might be missing
145
+
146
+ if data == "[DONE]":
147
+ break
148
+
149
+ json_data = json.loads(data)
150
+ # Skip entries without valid choices
151
+ if not json_data.get("choices"):
152
+ continue
153
+ choice = json_data["choices"][0]
154
+ delta = choice.get("delta", {})
155
+ if "content" in delta:
156
+ content = delta["content"]
157
+ if content: # Ensure content is not None or empty
158
+ streaming_text += content
159
+ resp = {"text": content}
160
+ # Yield dict or raw string chunk
161
+ yield resp if not raw else content
162
+ # If finish_reason is provided, consider the stream complete
163
+ if choice.get("finish_reason"):
164
+ break
165
+ except (json.JSONDecodeError, UnicodeDecodeError):
166
+ continue # Ignore lines that are not valid JSON or cannot be decoded
167
+
168
+ # Update history after stream finishes
169
+ self.last_response = streaming_text # Store aggregated text
170
+ self.conversation.update_chat_history(
171
+ prompt, self.last_response
172
+ )
173
+ except CurlError as e: # Catch CurlError
174
+ raise exceptions.ProviderConnectionError(f"Request failed (CurlError): {e}") from e
175
+ except Exception as e: # Catch other potential exceptions (like HTTPError)
176
+ err_text = getattr(e, 'response', None) and getattr(e.response, 'text', '')
177
+ raise exceptions.ProviderConnectionError(f"Request failed ({type(e).__name__}): {e} - {err_text}") from e
178
+
179
+
180
+ def for_non_stream():
181
+ # Aggregate the stream using the updated for_stream logic
182
+ full_response_text = ""
183
+ try:
184
+ # Ensure raw=False so for_stream yields dicts
185
+ for chunk_data in for_stream():
186
+ if isinstance(chunk_data, dict) and "text" in chunk_data:
187
+ full_response_text += chunk_data["text"]
188
+ # Handle raw string case if raw=True was passed
189
+ elif raw and isinstance(chunk_data, str):
190
+ full_response_text += chunk_data
191
+ except Exception as e:
192
+ # If aggregation fails but some text was received, use it. Otherwise, re-raise.
193
+ if not full_response_text:
194
+ raise exceptions.FailedToGenerateResponseError(f"Failed to get non-stream response: {str(e)}") from e
195
+
196
+ # last_response and history are updated within for_stream
197
+ # Return the final aggregated response dict or raw string
198
+ return full_response_text if raw else {"text": self.last_response} # Return dict for consistency
199
+
200
+
201
+ # Since the API endpoint suggests streaming, always call the stream generator.
202
+ # The non-stream wrapper will handle aggregation if stream=False.
203
+ return for_stream() if stream else for_non_stream()
204
+
205
+ def chat(
206
+ self,
207
+ prompt: str,
208
+ stream: bool = False,
209
+ optimizer: str = None,
210
+ conversationally: bool = False,
211
+ ) -> Union[str, Generator[str, None, None]]:
212
+ """Generate response `str`"""
213
+
214
+ def for_stream_chat():
215
+ # ask() yields dicts or strings when streaming
216
+ gen = self.ask(
217
+ prompt, stream=True, raw=False, # Ensure ask yields dicts
218
+ optimizer=optimizer, conversationally=conversationally
219
+ )
220
+ for response_dict in gen:
221
+ yield self.get_message(response_dict) # get_message expects dict or string
222
+
223
+ def for_non_stream_chat():
224
+ # ask() returns dict or str when not streaming
225
+ response_data = self.ask(
226
+ prompt,
227
+ stream=False,
228
+ raw=False, # Ensure ask returns dict
229
+ optimizer=optimizer,
230
+ conversationally=conversationally,
231
+ )
232
+ return self.get_message(response_data) # get_message expects dict or string
233
+
234
+ return for_stream_chat() if stream else for_non_stream_chat()
235
+
236
+ def get_message(self, response: Any) -> str:
237
+ """
238
+ Retrieves a clean message from the provided response.
239
+
240
+ Args:
241
+ response: The raw response data.
242
+
243
+ Returns:
244
+ str: The extracted message.
245
+ """
246
+ if isinstance(response, str):
247
+ return response
248
+ elif isinstance(response, dict) and "text" in response:
249
+ return response["text"]
250
+ return ""
251
+
252
+ if __name__ == "__main__":
253
+ # Ensure curl_cffi is installed
254
+ from rich import print
255
+ ai = Sambanova(api_key='')
256
+ response = ai.chat(input(">>> "), stream=True)
257
+ for chunk in response:
258
258
  print(chunk, end="", flush=True)