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,218 @@
1
+ import requests
2
+ import json
3
+ import random
4
+ import datetime
5
+ from typing import Any, Dict, Optional, Union, Generator
6
+ from webscout.AIutel import Optimizers, Conversation, AwesomePrompts, sanitize_stream
7
+ from webscout.AIbase import Provider
8
+ from webscout import exceptions
9
+
10
+ class NEMOTRON(Provider):
11
+ """NEMOTRON provider for interacting with the nemotron.one API."""
12
+ url = "https://nemotron.one/api/chat"
13
+
14
+ AVAILABLE_MODELS = [
15
+ "gpt4o",
16
+ "nemotron70b",
17
+ ]
18
+
19
+ def __init__(
20
+ self,
21
+ is_conversation: bool = True,
22
+ max_tokens: int = 8000,
23
+ timeout: int = 30,
24
+ intro: str = None,
25
+ filepath: str = None,
26
+ update_file: bool = True,
27
+ proxies: dict = {},
28
+ history_offset: int = 10250,
29
+ act: str = None,
30
+ model: str = "gpt4o"
31
+ ):
32
+ """Initialize NEMOTRON with configuration options."""
33
+ self.session = requests.Session()
34
+ self.max_tokens = max_tokens
35
+ self.is_conversation = is_conversation
36
+ self.timeout = timeout
37
+ self.last_response = {}
38
+ self.model = self.get_model(model)
39
+
40
+ self.headers = {
41
+ "authority": "nemotron.one",
42
+ "accept": "*/*",
43
+ "accept-language": "en-US,en;q=0.9",
44
+ "content-type": "application/json",
45
+ "origin": "https://nemotron.one",
46
+ "referer": f"https://nemotron.one/chat/{self.model}",
47
+ "sec-ch-ua": '"Chromium";v="136", "Not.A/Brand";v="99"',
48
+ "sec-ch-ua-mobile": "?0",
49
+ "sec-ch-ua-platform": '"Windows"',
50
+ "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36"
51
+ }
52
+
53
+ self.__available_optimizers = (
54
+ method for method in dir(Optimizers)
55
+ if callable(getattr(Optimizers, method)) and not method.startswith("__")
56
+ )
57
+
58
+ Conversation.intro = (
59
+ AwesomePrompts().get_act(
60
+ act, raise_not_found=True, default=None, case_insensitive=True
61
+ )
62
+ if act
63
+ else intro or Conversation.intro
64
+ )
65
+
66
+ self.conversation = Conversation(
67
+ is_conversation, self.max_tokens, filepath, update_file
68
+ )
69
+ self.conversation.history_offset = history_offset
70
+ self.session.proxies = proxies
71
+
72
+ @staticmethod
73
+ def _generate_random_email() -> str:
74
+ """Generate a random email address."""
75
+ random_letter = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
76
+ random_string = ''.join(random.choice(random_letter) for _ in range(10))
77
+ return f"{random_string}@gmail.com"
78
+
79
+ @staticmethod
80
+ def _generate_random_id() -> str:
81
+ """Generate a random user ID."""
82
+ timestamp = datetime.datetime.now().strftime("%Y%m%d%H%M%S%f")
83
+ random_letter = "abcdefghijklmnopqrstuvwxyz0123456789"
84
+ random_string = ''.join(random.choice(random_letter) for _ in range(8))
85
+ return f"cm{random_string}{timestamp[:10]}"
86
+
87
+ @classmethod
88
+ def get_model(cls, model: str) -> str:
89
+ """Resolve model name from alias."""
90
+ if model in cls.AVAILABLE_MODELS:
91
+ return model # Simply return the model name if it's in the list
92
+ raise ValueError(f"Unknown model: {model}. Available models: {', '.join(cls.AVAILABLE_MODELS)}")
93
+
94
+ def _get_user_data(self) -> Dict[str, Any]:
95
+ """Generate user data for the request."""
96
+ current_time = datetime.datetime.now().isoformat()
97
+ return {
98
+ "name": "user",
99
+ "email": self._generate_random_email(),
100
+ "image": "https://lh3.googleusercontent.com/a/default-user=s96-c",
101
+ "id": self._generate_random_id(),
102
+ "password": None,
103
+ "emailVerified": None,
104
+ "credits": 100000000000,
105
+ "isPro": False,
106
+ "createdAt": current_time,
107
+ "updatedAt": current_time
108
+ }
109
+
110
+ def _make_request(
111
+ self,
112
+ message: str,
113
+ stream: bool = False
114
+ ) -> Generator[str, None, None]:
115
+ """Make request to NEMOTRON API."""
116
+ payload = {
117
+ "content": message,
118
+ "imageSrc": "",
119
+ "model": self.model,
120
+ "user": self._get_user_data(),
121
+ "conversationId": ""
122
+ }
123
+
124
+ try:
125
+ if stream:
126
+ with self.session.post(
127
+ self.url,
128
+ headers=self.headers,
129
+ json=payload,
130
+ stream=True,
131
+ timeout=self.timeout
132
+ ) as response:
133
+ response.raise_for_status()
134
+ yield from sanitize_stream(
135
+ response.iter_content(chunk_size=1024),
136
+ to_json=False,
137
+ )
138
+ else:
139
+ response = self.session.post(
140
+ self.url,
141
+ headers=self.headers,
142
+ json=payload,
143
+ timeout=self.timeout
144
+ )
145
+ response.raise_for_status()
146
+ yield response.text
147
+
148
+ except requests.exceptions.RequestException as e:
149
+ raise exceptions.ProviderConnectionError(f"Connection error: {str(e)}")
150
+
151
+ def ask(
152
+ self,
153
+ prompt: str,
154
+ stream: bool = False,
155
+ raw: bool = False,
156
+ optimizer: str = None,
157
+ conversationally: bool = False,
158
+ ) -> Union[Dict[str, str], Generator[Dict[str, str], None, None]]:
159
+ """Send a prompt to NEMOTRON API and return the response."""
160
+ conversation_prompt = self.conversation.gen_complete_prompt(prompt)
161
+ if optimizer:
162
+ if optimizer in self.__available_optimizers:
163
+ conversation_prompt = getattr(Optimizers, optimizer)(
164
+ conversation_prompt if conversationally else prompt
165
+ )
166
+ else:
167
+ raise ValueError(f"Optimizer is not one of {self.__available_optimizers}")
168
+
169
+ def for_stream():
170
+ for text in self._make_request(conversation_prompt, stream=True):
171
+ yield {"text": text}
172
+
173
+ def for_non_stream():
174
+ response_text = next(self._make_request(conversation_prompt, stream=False))
175
+ self.last_response = {"text": response_text}
176
+ return self.last_response
177
+
178
+ return for_stream() if stream else for_non_stream()
179
+
180
+ def chat(
181
+ self,
182
+ prompt: str,
183
+ stream: bool = False,
184
+ optimizer: str = None,
185
+ conversationally: bool = False,
186
+ ) -> Union[str, Generator[str, None, None]]:
187
+ """Generate response as string."""
188
+ def for_stream():
189
+ for response in self.ask(
190
+ prompt,
191
+ stream=True,
192
+ optimizer=optimizer,
193
+ conversationally=conversationally
194
+ ):
195
+ yield self.get_message(response)
196
+
197
+ def for_non_stream():
198
+ return self.get_message(
199
+ self.ask(
200
+ prompt,
201
+ stream=False,
202
+ optimizer=optimizer,
203
+ conversationally=conversationally,
204
+ )
205
+ )
206
+
207
+ return for_stream() if stream else for_non_stream()
208
+
209
+ def get_message(self, response: Dict[str, Any]) -> str:
210
+ """Extract message from response dictionary."""
211
+ assert isinstance(response, dict), "Response should be of dict data-type only"
212
+ return response["text"]
213
+
214
+ if __name__ == "__main__":
215
+ # Example usage
216
+ nemotron = NEMOTRON()
217
+ response = nemotron.chat("Hello, how are you?", stream=False)
218
+ print(response)
@@ -0,0 +1,270 @@
1
+ from typing import Any, Dict, Optional, Generator, Union
2
+ from webscout.AIutel import Optimizers, Conversation, AwesomePrompts, sanitize_stream # Import sanitize_stream
3
+ from webscout.AIbase import Provider
4
+ from webscout import exceptions
5
+ from webscout.litagent import LitAgent
6
+ # Replace requests with curl_cffi
7
+ from curl_cffi.requests import Session # Import Session
8
+ from curl_cffi import CurlError # Import CurlError
9
+
10
+ class Netwrck(Provider):
11
+ """
12
+ A class to interact with the Netwrck.com API. Supports streaming.
13
+ """
14
+ greeting = """Hello! I'm a helpful assistant. How can I help you today?"""
15
+
16
+ AVAILABLE_MODELS = [
17
+ "neversleep/llama-3-lumimaid-8b:extended",
18
+ "x-ai/grok-2",
19
+ "anthropic/claude-3-7-sonnet-20250219",
20
+ "sao10k/l3-euryale-70b",
21
+ "openai/gpt-4.1-mini",
22
+ "gryphe/mythomax-l2-13b",
23
+ "google/gemini-pro-1.5",
24
+ "google/gemini-2.5-flash-preview-04-17",
25
+ "nvidia/llama-3.1-nemotron-70b-instruct",
26
+ "deepseek/deepseek-r1",
27
+ "deepseek/deepseek-chat"
28
+
29
+ ]
30
+
31
+ def __init__(
32
+ self,
33
+ model: str = "anthropic/claude-3-7-sonnet-20250219",
34
+ is_conversation: bool = True,
35
+ max_tokens: int = 4096, # Note: max_tokens is not used by this API
36
+ timeout: int = 30,
37
+ intro: Optional[str] = None,
38
+ filepath: Optional[str] = None,
39
+ update_file: bool = False,
40
+ proxies: Optional[dict] = None,
41
+ history_offset: int = 0,
42
+ act: Optional[str] = None,
43
+ system_prompt: str = "You are a helpful assistant.",
44
+ temperature: float = 0.7, # Note: temperature is not used by this API
45
+ top_p: float = 0.8 # Note: top_p is not used by this API
46
+ ):
47
+ """Initializes the Netwrck API client."""
48
+ if model not in self.AVAILABLE_MODELS:
49
+ raise ValueError(f"Invalid model: {model}. Choose from: {self.AVAILABLE_MODELS}")
50
+
51
+ self.model = model
52
+ self.model_name = model
53
+ self.system_prompt = system_prompt
54
+ # Initialize curl_cffi Session
55
+ self.session = Session()
56
+ self.is_conversation = is_conversation
57
+ self.max_tokens_to_sample = max_tokens
58
+ self.timeout = timeout
59
+ self.last_response: Dict[str, Any] = {}
60
+ self.temperature = temperature
61
+ self.top_p = top_p
62
+
63
+ self.agent = LitAgent() # Keep for potential future use or other headers
64
+ self.headers = {
65
+ 'authority': 'netwrck.com',
66
+ 'accept': '*/*',
67
+ 'accept-language': 'en-US,en;q=0.9',
68
+ 'content-type': 'application/json',
69
+ 'origin': 'https://netwrck.com',
70
+ 'referer': 'https://netwrck.com/',
71
+ 'user-agent': self.agent.random()
72
+ # Add sec-ch-ua headers if needed for impersonation consistency
73
+ }
74
+
75
+ # Update curl_cffi session headers and proxies
76
+ self.session.headers.update(self.headers)
77
+ self.proxies = proxies or {}
78
+ self.session.proxies = self.proxies # Assign proxies directly
79
+
80
+ Conversation.intro = (
81
+ AwesomePrompts().get_act(act, raise_not_found=True, default=None, case_insensitive=True)
82
+ if act
83
+ else intro or Conversation.intro
84
+ )
85
+
86
+ self.conversation = Conversation(is_conversation, max_tokens, filepath, update_file)
87
+ self.conversation.history_offset = history_offset
88
+ self.__available_optimizers = (
89
+ method for method in dir(Optimizers)
90
+ if callable(getattr(Optimizers, method)) and not method.startswith("__")
91
+ )
92
+
93
+ @staticmethod
94
+ def _netwrck_extractor(chunk: Union[str, Dict[str, Any]]) -> Optional[str]:
95
+ """Removes surrounding quotes and handles potential escapes."""
96
+ if isinstance(chunk, str):
97
+ text = chunk.strip('"')
98
+ # Handle potential unicode escapes if they appear
99
+ # text = text.encode().decode('unicode_escape') # Uncomment if needed
100
+ return text
101
+ return None
102
+ def ask(
103
+ self,
104
+ prompt: str,
105
+ stream: bool = False,
106
+ raw: bool = False, # Keep raw param for interface consistency
107
+ optimizer: Optional[str] = None,
108
+ conversationally: bool = False,
109
+ ) -> Union[Dict[str, Any], Generator]:
110
+ """Sends a prompt to the Netwrck API and returns the response."""
111
+ if optimizer and optimizer not in self.__available_optimizers:
112
+ raise exceptions.FailedToGenerateResponseError(f"Optimizer is not one of {self.__available_optimizers}")
113
+
114
+ conversation_prompt = self.conversation.gen_complete_prompt(prompt)
115
+ if optimizer:
116
+ conversation_prompt = getattr(Optimizers, optimizer)(
117
+ conversation_prompt if conversationally else prompt
118
+ )
119
+
120
+ payload = {
121
+ "query": prompt,
122
+ "context": self.system_prompt,
123
+ "examples": [],
124
+ "model_name": self.model_name,
125
+ "greeting": self.greeting
126
+ }
127
+
128
+ def for_stream():
129
+ try:
130
+ # Use curl_cffi session post with impersonate
131
+ response = self.session.post(
132
+ "https://netwrck.com/api/chatpred_or",
133
+ json=payload,
134
+ # headers are set on the session
135
+ # proxies are set on the session
136
+ timeout=self.timeout,
137
+ stream=True,
138
+ impersonate="chrome110" # Use a common impersonation profile
139
+ )
140
+ response.raise_for_status() # Check for HTTP errors
141
+
142
+ streaming_text = ""
143
+ # Use sanitize_stream
144
+ processed_stream = sanitize_stream(
145
+ data=response.iter_content(chunk_size=None), # Pass byte iterator
146
+ intro_value=None, # No prefix
147
+ to_json=False, # It's text
148
+ content_extractor=self._netwrck_extractor, # Use the quote stripper
149
+ yield_raw_on_error=True
150
+ )
151
+ for content_chunk in processed_stream:
152
+ if content_chunk and isinstance(content_chunk, str):
153
+ streaming_text += content_chunk
154
+ yield {"text": content_chunk} if not raw else content_chunk
155
+ # Update history after stream finishes
156
+ self.last_response = {"text": streaming_text} # Store aggregated text
157
+ self.conversation.update_chat_history(payload["query"], streaming_text)
158
+
159
+ except CurlError as e: # Catch CurlError
160
+ raise exceptions.ProviderConnectionError(f"Network error (CurlError): {str(e)}") from e
161
+ except Exception as e: # Catch other potential exceptions (like HTTPError)
162
+ err_text = getattr(e, 'response', None) and getattr(e.response, 'text', '')
163
+ raise exceptions.ProviderConnectionError(f"Unexpected error ({type(e).__name__}): {str(e)} - {err_text}") from e
164
+
165
+ def for_non_stream():
166
+ try:
167
+ # Use curl_cffi session post with impersonate
168
+ response = self.session.post(
169
+ "https://netwrck.com/api/chatpred_or",
170
+ json=payload,
171
+ # headers are set on the session
172
+ # proxies are set on the session
173
+ timeout=self.timeout,
174
+ impersonate="chrome110" # Use a common impersonation profile
175
+ )
176
+ response.raise_for_status() # Check for HTTP errors
177
+
178
+ response_text_raw = response.text # Get raw text
179
+
180
+ # Process the text using sanitize_stream
181
+ processed_stream = sanitize_stream(
182
+ data=response_text_raw,
183
+ intro_value=None,
184
+ to_json=False,
185
+ content_extractor=self._netwrck_extractor
186
+ )
187
+ # Aggregate the single result
188
+ text = "".join(list(processed_stream))
189
+
190
+ self.last_response = {"text": text} # Store processed text
191
+ self.conversation.update_chat_history(prompt, text)
192
+
193
+ # Return dict or raw string
194
+ return text if raw else self.last_response
195
+
196
+ except CurlError as e: # Catch CurlError
197
+ raise exceptions.FailedToGenerateResponseError(f"Network error (CurlError): {str(e)}") from e
198
+ except Exception as e: # Catch other potential exceptions (like HTTPError)
199
+ err_text = getattr(e, 'response', None) and getattr(e.response, 'text', '')
200
+ raise exceptions.FailedToGenerateResponseError(f"Unexpected error ({type(e).__name__}): {str(e)} - {err_text}") from e
201
+
202
+ return for_stream() if stream else for_non_stream()
203
+
204
+ def chat(
205
+ self,
206
+ prompt: str,
207
+ stream: bool = False,
208
+ optimizer: Optional[str] = None,
209
+ conversationally: bool = False,
210
+ ) -> str:
211
+ """Generates a response from the Netwrck API."""
212
+ def for_stream_chat():
213
+ # ask() yields dicts or strings when streaming
214
+ gen = self.ask(
215
+ prompt,
216
+ stream=True,
217
+ raw=False, # Ensure ask yields dicts for get_message
218
+ optimizer=optimizer,
219
+ conversationally=conversationally
220
+ )
221
+ for response_dict in gen:
222
+ yield self.get_message(response_dict) # get_message expects dict
223
+
224
+ def for_non_stream_chat():
225
+ # ask() returns dict or str when not streaming
226
+ response_data = self.ask(
227
+ prompt,
228
+ stream=False,
229
+ raw=False, # Ensure ask returns dict for get_message
230
+ optimizer=optimizer,
231
+ conversationally=conversationally,
232
+ )
233
+ return self.get_message(response_data) # get_message expects dict
234
+
235
+ return for_stream_chat() if stream else for_non_stream_chat()
236
+
237
+ def get_message(self, response: Dict[str, Any]) -> str:
238
+ """Retrieves message only from response"""
239
+ assert isinstance(response, dict), "Response should be of dict data-type only"
240
+ return response["text"].replace('\\n', '\n').replace('\\n\\n', '\n\n')
241
+
242
+ if __name__ == "__main__":
243
+ # Ensure curl_cffi is installed
244
+ print("-" * 80)
245
+ print(f"{'Model':<50} {'Status':<10} {'Response'}")
246
+ print("-" * 80)
247
+
248
+ # Test all available models
249
+ working = 0
250
+ total = len(Netwrck.AVAILABLE_MODELS)
251
+
252
+ for model in Netwrck.AVAILABLE_MODELS:
253
+ try:
254
+ test_ai = Netwrck(model=model, timeout=60)
255
+ response = test_ai.chat("Say 'Hello' in one word", stream=True)
256
+ response_text = ""
257
+ for chunk in response:
258
+ response_text += chunk
259
+ print(f"\r{model:<50} {'Testing...':<10}", end="", flush=True)
260
+
261
+ if response_text and len(response_text.strip()) > 0:
262
+ status = "✓"
263
+ # Truncate response if too long
264
+ display_text = response_text.strip()[:50] + "..." if len(response_text.strip()) > 50 else response_text.strip()
265
+ else:
266
+ status = "✗"
267
+ display_text = "Empty or invalid response"
268
+ print(f"\r{model:<50} {status:<10} {display_text}")
269
+ except Exception as e:
270
+ print(f"\r{model:<50} {'✗':<10} {str(e)}")