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,635 +1,635 @@
1
- import random
2
- import re
3
- import time
4
- from typing import Dict, List, Optional, Any, Generator, Tuple, Union
5
- import uuid
6
- from curl_cffi.requests import Session
7
- from curl_cffi import CurlError
8
- from webscout.AIutel import Conversation as JsonConversation
9
- from webscout import exceptions
10
- from webscout.Provider.Blackboxai import to_data_uri
11
-
12
- class RateLimitError(Exception):
13
- pass
14
-
15
- class ModelNotFoundError(Exception):
16
- pass
17
-
18
- Messages = List[Dict[str, Any]]
19
- MediaListType = List[Tuple[Any, str]]
20
- Result = Generator[Union[str, JsonConversation, Any], None, None]
21
-
22
- class AuthData:
23
- def __init__(self):
24
- self.auth_token: Optional[str] = None
25
- self.app_token: Optional[str] = None
26
- self.created_at: float = time.time()
27
- self.tokens_valid: bool = False
28
- self.rate_limited_until: float = 0
29
- def is_valid(self, expiration_time: int) -> bool:
30
- return (self.auth_token and self.app_token and self.tokens_valid and time.time() - self.created_at < expiration_time)
31
- def invalidate(self):
32
- self.tokens_valid = False
33
- def set_rate_limit(self, seconds: int = 60):
34
- self.rate_limited_until = time.time() + seconds
35
- def is_rate_limited(self) -> bool:
36
- return time.time() < self.rate_limited_until
37
-
38
- class Conversation(JsonConversation):
39
- message_history: Messages = []
40
- def __init__(self, model: str):
41
- self.model = model
42
- self.message_history = []
43
- self._auth_data: Dict[str, AuthData] = {}
44
- def get_auth_for_model(self, model: str, provider) -> AuthData:
45
- if model not in self._auth_data:
46
- self._auth_data[model] = AuthData()
47
- return self._auth_data[model]
48
- def get_dict(self) -> Dict[str, Any]:
49
- return {"model": self.model, "message_history": self.message_history}
50
- def __getstate__(self) -> Dict[str, Any]:
51
- state = self.__dict__.copy()
52
- return state
53
- def __setstate__(self, state: Dict[str, Any]) -> None:
54
- self.__dict__.update(state)
55
-
56
- class PuterJS():
57
- label = "Puter.js"
58
- url = "https://docs.puter.com/playground"
59
- api_endpoint = "https://api.puter.com/drivers/call"
60
- working = True
61
- needs_auth = False
62
- supports_stream = False
63
- supports_system_message = True
64
- supports_message_history = True
65
- default_model = 'gpt-4o'
66
- default_vision_model = default_model
67
- openai_models = [default_vision_model]
68
- claude_models = []
69
- mistral_models = []
70
- xai_models = []
71
- deepseek_models = []
72
- gemini_models = []
73
- openrouter_models = []
74
- vision_models = [*openai_models]
75
- models = vision_models
76
- TOKEN_EXPIRATION = 30 * 60
77
- MAX_RETRIES = 3
78
- RETRY_DELAY = 5
79
- RATE_LIMIT_DELAY = 60
80
- Conversation = Conversation
81
- AuthData = AuthData
82
- _shared_auth_data = {}
83
-
84
- @staticmethod
85
- def get_driver_for_model(model: str) -> str:
86
- if model in PuterJS.openai_models:
87
- return "openai-completion"
88
- elif model in PuterJS.claude_models:
89
- return "claude"
90
- elif model in PuterJS.mistral_models:
91
- return "mistral"
92
- elif model in PuterJS.xai_models:
93
- return "xai"
94
- elif model in PuterJS.deepseek_models:
95
- return "deepseek"
96
- elif model in PuterJS.gemini_models:
97
- return "gemini"
98
- elif model in PuterJS.openrouter_models:
99
- return "openrouter"
100
- else:
101
- return "openai-completion"
102
-
103
- @staticmethod
104
- def format_messages_with_images(messages: Messages, media: MediaListType = None) -> Messages:
105
- if not media:
106
- return messages
107
-
108
- formatted_messages = messages.copy()
109
-
110
- for i in range(len(formatted_messages) - 1, -1, -1):
111
- if formatted_messages[i]["role"] == "user":
112
- user_msg = formatted_messages[i]
113
-
114
- if isinstance(user_msg["content"], str):
115
- text_content = user_msg["content"]
116
- user_msg["content"] = [{"type": "text", "text": text_content}]
117
- elif not isinstance(user_msg["content"], list):
118
- user_msg["content"] = []
119
-
120
- for image_data, image_name in media:
121
- if isinstance(image_data, str) and (image_data.startswith("http://") or image_data.startswith("https://")):
122
- user_msg["content"].append({
123
- "type": "image_url",
124
- "image_url": {"url": image_data}
125
- })
126
- else:
127
- image_uri = to_data_uri(image_data)
128
- user_msg["content"].append({
129
- "type": "image_url",
130
- "image_url": {"url": image_uri}
131
- })
132
-
133
- formatted_messages[i] = user_msg
134
- break
135
-
136
- return formatted_messages
137
-
138
- @classmethod
139
- def _create_temporary_account(cls, session: Session, proxy: str = None) -> Dict[str, str]:
140
- signup_headers = {
141
- "Content-Type": "application/json",
142
- "host": "puter.com",
143
- "connection": "keep-alive",
144
- "sec-ch-ua-platform": "macOS",
145
- "user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36",
146
- "sec-ch-ua": '"Google Chrome";v="135", "Not-A.Brand";v="8", "Chromium";v="135"',
147
- "sec-ch-ua-mobile": "?0",
148
- "accept": "*/*",
149
- "origin": "https://puter.com",
150
- "sec-fetch-site": "same-site",
151
- "sec-fetch-mode": "cors",
152
- "sec-fetch-dest": "empty",
153
- "referer": "https://puter.com/",
154
- "accept-encoding": "gzip",
155
- "accept-language": "en-US,en;q=0.9"
156
- }
157
-
158
- signup_data = {
159
- "is_temp": True,
160
- "client_id": str(uuid.uuid4())
161
- }
162
-
163
- for attempt in range(cls.MAX_RETRIES):
164
- try:
165
- response = session.post(
166
- "https://puter.com/signup",
167
- headers=signup_headers,
168
- json=signup_data,
169
- proxies={"https": proxy} if proxy else None,
170
- timeout=30
171
- )
172
-
173
- if response.status_code == 429:
174
- retry_after = int(response.headers.get('Retry-After', cls.RATE_LIMIT_DELAY))
175
- if attempt < cls.MAX_RETRIES - 1:
176
- time.sleep(retry_after)
177
- continue
178
- else:
179
- raise RateLimitError(f"Rate limited by Puter.js API. Try again after {retry_after} seconds.")
180
-
181
- if response.status_code != 200:
182
- error_text = response.text
183
- if attempt < cls.MAX_RETRIES - 1:
184
- time.sleep(cls.RETRY_DELAY * (attempt + 1))
185
- continue
186
- else:
187
- raise Exception(f"Failed to create temporary account. Status: {response.status_code}, Details: {error_text}")
188
-
189
- try:
190
- return response.json()
191
- except Exception as e:
192
- if attempt < cls.MAX_RETRIES - 1:
193
- time.sleep(cls.RETRY_DELAY)
194
- continue
195
- else:
196
- raise Exception(f"Failed to parse signup response as JSON: {e}")
197
-
198
- except Exception as e:
199
- if attempt < cls.MAX_RETRIES - 1:
200
- time.sleep(cls.RETRY_DELAY * (2 ** attempt))
201
- continue
202
- else:
203
- raise e
204
-
205
- raise Exception("Failed to create temporary account after multiple retries")
206
-
207
- @classmethod
208
- def _get_app_token(cls, session: Session, auth_token: str, proxy: str = None) -> Dict[str, str]:
209
- app_token_headers = {
210
- "host": "api.puter.com",
211
- "connection": "keep-alive",
212
- "authorization": f"Bearer {auth_token}",
213
- "user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36",
214
- "accept": "*/*",
215
- "origin": "https://puter.com",
216
- "sec-fetch-site": "same-site",
217
- "sec-fetch-mode": "cors",
218
- "sec-fetch-dest": "empty",
219
- "referer": "https://puter.com/",
220
- "accept-encoding": "gzip",
221
- "accept-language": "en-US,en;q=0.9",
222
- "content-type": "application/json"
223
- }
224
-
225
- origins = ["http://docs.puter.com", "https://docs.puter.com", "https://puter.com"]
226
- app_token_data = {"origin": random.choice(origins)}
227
-
228
- for attempt in range(cls.MAX_RETRIES):
229
- try:
230
- response = session.post(
231
- "https://api.puter.com/auth/get-user-app-token",
232
- headers=app_token_headers,
233
- json=app_token_data,
234
- proxies={"https": proxy} if proxy else None,
235
- timeout=30
236
- )
237
-
238
- if response.status_code == 429:
239
- retry_after = int(response.headers.get('Retry-After', cls.RATE_LIMIT_DELAY))
240
- if attempt < cls.MAX_RETRIES - 1:
241
- time.sleep(retry_after)
242
- continue
243
- else:
244
- raise RateLimitError(f"Rate limited by Puter.js API. Try again after {retry_after} seconds.")
245
-
246
- if response.status_code != 200:
247
- error_text = response.text
248
- if attempt < cls.MAX_RETRIES - 1:
249
- time.sleep(cls.RETRY_DELAY * (attempt + 1))
250
- continue
251
- else:
252
- raise Exception(f"Failed to get app token. Status: {response.status_code}, Details: {error_text}")
253
-
254
- try:
255
- return response.json()
256
- except Exception as e:
257
- if attempt < cls.MAX_RETRIES - 1:
258
- time.sleep(cls.RETRY_DELAY)
259
- continue
260
- else:
261
- raise Exception(f"Failed to parse app token response as JSON: {e}")
262
-
263
- except Exception as e:
264
- if attempt < cls.MAX_RETRIES - 1:
265
- time.sleep(cls.RETRY_DELAY * (2 ** attempt))
266
- continue
267
- else:
268
- raise e
269
-
270
- raise Exception("Failed to get app token after multiple retries")
271
-
272
- @classmethod
273
- def get_model(cls, model: str) -> str:
274
- """Get the internal model name from the user-provided model name."""
275
-
276
- if not model:
277
- return cls.default_model
278
-
279
- # Check if the model exists directly in our models list
280
- if model in cls.models:
281
- return model
282
-
283
- # Check if there's an alias for this model
284
- if model in cls.model_aliases:
285
- alias = cls.model_aliases[model]
286
- # If the alias is a list, randomly select one of the options
287
- if isinstance(alias, list):
288
- selected_model = random.choice(alias)
289
- return selected_model
290
- return alias
291
-
292
- raise ModelNotFoundError(f"Model {model} not found")
293
-
294
- @classmethod
295
- def create_completion(
296
- cls,
297
- model: str,
298
- messages: Messages,
299
- proxy: str = None,
300
- stream: bool = None, # Ignored in synchronous version
301
- conversation: Optional[JsonConversation] = None,
302
- return_conversation: bool = False,
303
- media: MediaListType = None, # Add media parameter for images
304
- **kwargs
305
- ) -> Result:
306
- model = cls.get_model(model)
307
-
308
- # Check if we need to use a vision model
309
- has_images = False
310
- if media is not None and len(media) > 0:
311
- has_images = True
312
- # If images are present and model doesn't support vision, switch to default vision model
313
- if model not in cls.vision_models:
314
- model = cls.default_vision_model
315
-
316
- # Check for image URLs in messages
317
- if not has_images:
318
- for msg in messages:
319
- if msg["role"] == "user":
320
- content = msg.get("content", "")
321
- if isinstance(content, list):
322
- for item in content:
323
- if item.get("type") == "image_url":
324
- has_images = True
325
- if model not in cls.vision_models:
326
- model = cls.default_vision_model
327
- break
328
- elif isinstance(content, str):
329
- # Check for URLs in the text
330
- urls = re.findall(r'https?://\S+\.(jpg|jpeg|png|gif|webp)', content, re.IGNORECASE)
331
- if urls:
332
- has_images = True
333
- if model not in cls.vision_models:
334
- model = cls.default_vision_model
335
- break
336
-
337
- # Check if the conversation is of the correct type
338
- if conversation is not None and not isinstance(conversation, cls.Conversation):
339
- # Convert generic JsonConversation to our specific Conversation class
340
- new_conversation = cls.Conversation(model)
341
- new_conversation.message_history = conversation.message_history.copy() if hasattr(conversation, 'message_history') else messages.copy()
342
- conversation = new_conversation
343
-
344
- # Initialize or update conversation
345
- if conversation is None:
346
- conversation = cls.Conversation(model)
347
- # Format messages with images if needed
348
- if has_images and media:
349
- conversation.message_history = cls.format_messages_with_images(messages, media)
350
- else:
351
- conversation.message_history = messages.copy()
352
- else:
353
- # Update message history with new messages
354
- if has_images and media:
355
- formatted_messages = cls.format_messages_with_images(messages, media)
356
- for msg in formatted_messages:
357
- if msg not in conversation.message_history:
358
- conversation.message_history.append(msg)
359
- else:
360
- for msg in messages:
361
- if msg not in conversation.message_history:
362
- conversation.message_history.append(msg)
363
-
364
- # Get the authentication data for this specific model
365
- auth_data = conversation.get_auth_for_model(model, cls)
366
-
367
- # Check if we can use shared auth data
368
- if model in cls._shared_auth_data and cls._shared_auth_data[model].is_valid(cls.TOKEN_EXPIRATION):
369
- # Copy shared auth data to conversation
370
- shared_auth = cls._shared_auth_data[model]
371
- auth_data.auth_token = shared_auth.auth_token
372
- auth_data.app_token = shared_auth.app_token
373
- auth_data.created_at = shared_auth.created_at
374
- auth_data.tokens_valid = shared_auth.tokens_valid
375
-
376
- # Check if rate limited
377
- if auth_data.is_rate_limited():
378
- wait_time = auth_data.rate_limited_until - time.time()
379
- if wait_time > 0:
380
- yield f"Rate limited. Please try again in {int(wait_time)} seconds."
381
- return
382
-
383
- with Session() as session:
384
- # Step 1: Create a temporary account (if needed)
385
- if not auth_data.is_valid(cls.TOKEN_EXPIRATION):
386
- try:
387
- # Try to authenticate
388
- signup_data = cls._create_temporary_account(session, proxy)
389
- auth_data.auth_token = signup_data.get("token")
390
-
391
- if not auth_data.auth_token:
392
- yield f"Error: No auth token in response for model {model}"
393
- return
394
-
395
- # Get app token
396
- app_token_data = cls._get_app_token(session, auth_data.auth_token, proxy)
397
- auth_data.app_token = app_token_data.get("token")
398
-
399
- if not auth_data.app_token:
400
- yield f"Error: No app token in response for model {model}"
401
- return
402
-
403
- # Mark tokens as valid
404
- auth_data.created_at = time.time()
405
- auth_data.tokens_valid = True
406
-
407
- # Update shared auth data
408
- cls._shared_auth_data[model] = auth_data
409
-
410
- except RateLimitError as e:
411
- # Set rate limit and inform user
412
- auth_data.set_rate_limit(cls.RATE_LIMIT_DELAY)
413
- yield str(e)
414
- return
415
- except Exception as e:
416
- yield f"Error during authentication for model {model}: {str(e)}"
417
- return
418
-
419
- # Step 3: Make the chat request with proper image handling
420
- try:
421
- chat_headers = {
422
- "host": "api.puter.com",
423
- "connection": "keep-alive",
424
- "authorization": f"Bearer {auth_data.app_token}",
425
- "user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36",
426
- "content-type": "application/json;charset=UTF-8",
427
- "accept": "*/*",
428
- "origin": "http://docs.puter.com",
429
- "sec-fetch-site": "cross-site",
430
- "sec-fetch-mode": "cors",
431
- "sec-fetch-dest": "empty",
432
- "referer": "http://docs.puter.com/",
433
- "accept-encoding": "gzip",
434
- "accept-language": "en-US,en;q=0.9"
435
- }
436
-
437
- driver = cls.get_driver_for_model(model)
438
-
439
- processed_messages = conversation.message_history
440
-
441
- if has_images and not any(isinstance(msg.get("content"), list) for msg in processed_messages):
442
- for i, msg in enumerate(processed_messages):
443
- if msg["role"] == "user":
444
- if media and len(media) > 0:
445
- processed_messages = cls.format_messages_with_images([msg], media)
446
- else:
447
- content = msg.get("content", "")
448
- if isinstance(content, str):
449
- urls = re.findall(r'https?://\S+\.(jpg|jpeg|png|gif|webp)', content, re.IGNORECASE)
450
- if urls:
451
- text_parts = []
452
- image_urls = []
453
-
454
- words = content.split()
455
- for word in words:
456
- if re.match(r'https?://\S+\.(jpg|jpeg|png|gif|webp)', word, re.IGNORECASE):
457
- image_urls.append(word)
458
- else:
459
- text_parts.append(word)
460
-
461
- formatted_content = []
462
- if text_parts:
463
- formatted_content.append({
464
- "type": "text",
465
- "text": " ".join(text_parts)
466
- })
467
-
468
- for url in image_urls:
469
- formatted_content.append({
470
- "type": "image_url",
471
- "image_url": {"url": url}
472
- })
473
-
474
- processed_messages[i]["content"] = formatted_content
475
- break
476
-
477
- chat_data = {
478
- "interface": "puter-chat-completion",
479
- "driver": driver,
480
- "test_mode": False,
481
- "method": "complete",
482
- "args": {
483
- "messages": processed_messages,
484
- "model": model,
485
- "stream": False,
486
- "max_tokens": kwargs.get("max_tokens", 4096)
487
- }
488
- }
489
-
490
- for key, value in kwargs.items():
491
- if key not in ["messages", "model", "stream", "max_tokens"]:
492
- chat_data["args"][key] = value
493
-
494
- for attempt in range(cls.MAX_RETRIES):
495
- try:
496
- response = session.post(
497
- cls.api_endpoint,
498
- headers=chat_headers,
499
- json=chat_data,
500
- proxies={"https": proxy} if proxy else None,
501
- timeout=120
502
- )
503
-
504
- if response.status_code == 429:
505
- retry_after = int(response.headers.get('Retry-After', cls.RATE_LIMIT_DELAY))
506
- auth_data.set_rate_limit(retry_after)
507
- if attempt < cls.MAX_RETRIES - 1:
508
- time.sleep(min(retry_after, 10))
509
- continue
510
- else:
511
- raise RateLimitError(f"Rate limited by Puter.js API. Try again after {retry_after} seconds.")
512
-
513
- if response.status_code in [401, 403]:
514
- error_text = response.text
515
- auth_data.invalidate()
516
- if attempt < cls.MAX_RETRIES - 1:
517
- signup_data = cls._create_temporary_account(session, proxy)
518
- auth_data.auth_token = signup_data.get("token")
519
-
520
- app_token_data = cls._get_app_token(session, auth_data.auth_token, proxy)
521
- auth_data.app_token = app_token_data.get("token")
522
-
523
- auth_data.created_at = time.time()
524
- auth_data.tokens_valid = True
525
-
526
- cls._shared_auth_data[model] = auth_data
527
-
528
- chat_headers["authorization"] = f"Bearer {auth_data.app_token}"
529
-
530
- continue
531
- else:
532
- raise Exception(f"Authentication failed after {cls.MAX_RETRIES} attempts: {error_text}")
533
-
534
- if response.status_code != 200:
535
- error_text = response.text
536
- if attempt < cls.MAX_RETRIES - 1:
537
- time.sleep(cls.RETRY_DELAY * (attempt + 1))
538
- continue
539
- else:
540
- raise Exception(f"Chat request failed. Status: {response.status_code}, Details: {error_text}")
541
-
542
- try:
543
- response_json = response.json()
544
- except Exception as e:
545
- error_text = response.text
546
- if attempt < cls.MAX_RETRIES - 1:
547
- time.sleep(cls.RETRY_DELAY)
548
- continue
549
- else:
550
- raise Exception(f"Failed to parse chat response as JSON: {error_text}")
551
-
552
- if response_json.get("success") is True:
553
- content = response_json.get("result", {}).get("message", {}).get("content", "")
554
-
555
- if content:
556
- conversation.message_history.append({
557
- "role": "assistant",
558
- "content": content
559
- })
560
-
561
- yield content
562
-
563
- if return_conversation:
564
- yield conversation
565
-
566
- return
567
- else:
568
- error_msg = response_json.get("error", {}).get("message", "Unknown error")
569
-
570
- if "rate" in error_msg.lower() or "limit" in error_msg.lower():
571
- auth_data.set_rate_limit()
572
- if attempt < cls.MAX_RETRIES - 1:
573
- time.sleep(cls.RETRY_DELAY)
574
- continue
575
- else:
576
- raise RateLimitError(f"Rate limited: {error_msg}")
577
-
578
- if "auth" in error_msg.lower() or "token" in error_msg.lower():
579
- auth_data.invalidate()
580
- if attempt < cls.MAX_RETRIES - 1:
581
- signup_data = cls._create_temporary_account(session, proxy)
582
- auth_data.auth_token = signup_data.get("token")
583
-
584
- app_token_data = cls._get_app_token(session, auth_data.auth_token, proxy)
585
- auth_data.app_token = app_token_data.get("token")
586
-
587
- auth_data.created_at = time.time()
588
- auth_data.tokens_valid = True
589
-
590
- chat_headers["authorization"] = f"Bearer {auth_data.app_token}"
591
-
592
- cls._shared_auth_data[model] = auth_data
593
-
594
- continue
595
-
596
- if attempt < cls.MAX_RETRIES - 1:
597
- time.sleep(cls.RETRY_DELAY)
598
- continue
599
- else:
600
- yield f"Error: {error_msg}"
601
- return
602
-
603
- except RateLimitError as e:
604
- auth_data.set_rate_limit(cls.RATE_LIMIT_DELAY)
605
- if attempt < cls.MAX_RETRIES - 1:
606
- time.sleep(min(cls.RATE_LIMIT_DELAY, 10))
607
- continue
608
- else:
609
- yield str(e)
610
- return
611
-
612
- except Exception as e:
613
- if "token" in str(e).lower() or "auth" in str(e).lower():
614
- auth_data.invalidate()
615
-
616
- if attempt < cls.MAX_RETRIES - 1:
617
- time.sleep(cls.RETRY_DELAY * (attempt + 1))
618
- continue
619
- else:
620
- yield f"Error: {str(e)}"
621
- return
622
-
623
- except Exception as e:
624
- if "token" in str(e).lower() or "auth" in str(e).lower():
625
- auth_data.invalidate()
626
-
627
- yield f"Error: {str(e)}"
628
- return
629
- if __name__ == "__main__":
630
- # Example usage
631
- puter = PuterJS()
632
- messages = [{"role": "user", "content": "Hello, how are you?"}]
633
- result = puter.create_completion(model="gpt-4o", messages=messages)
634
- for res in result:
1
+ import random
2
+ import re
3
+ import time
4
+ from typing import Dict, List, Optional, Any, Generator, Tuple, Union
5
+ import uuid
6
+ from curl_cffi.requests import Session
7
+ from curl_cffi import CurlError
8
+ from webscout.AIutel import Conversation as JsonConversation
9
+ from webscout import exceptions
10
+ from webscout.Provider.Blackboxai import to_data_uri
11
+
12
+ class RateLimitError(Exception):
13
+ pass
14
+
15
+ class ModelNotFoundError(Exception):
16
+ pass
17
+
18
+ Messages = List[Dict[str, Any]]
19
+ MediaListType = List[Tuple[Any, str]]
20
+ Result = Generator[Union[str, JsonConversation, Any], None, None]
21
+
22
+ class AuthData:
23
+ def __init__(self):
24
+ self.auth_token: Optional[str] = None
25
+ self.app_token: Optional[str] = None
26
+ self.created_at: float = time.time()
27
+ self.tokens_valid: bool = False
28
+ self.rate_limited_until: float = 0
29
+ def is_valid(self, expiration_time: int) -> bool:
30
+ return (self.auth_token and self.app_token and self.tokens_valid and time.time() - self.created_at < expiration_time)
31
+ def invalidate(self):
32
+ self.tokens_valid = False
33
+ def set_rate_limit(self, seconds: int = 60):
34
+ self.rate_limited_until = time.time() + seconds
35
+ def is_rate_limited(self) -> bool:
36
+ return time.time() < self.rate_limited_until
37
+
38
+ class Conversation(JsonConversation):
39
+ message_history: Messages = []
40
+ def __init__(self, model: str):
41
+ self.model = model
42
+ self.message_history = []
43
+ self._auth_data: Dict[str, AuthData] = {}
44
+ def get_auth_for_model(self, model: str, provider) -> AuthData:
45
+ if model not in self._auth_data:
46
+ self._auth_data[model] = AuthData()
47
+ return self._auth_data[model]
48
+ def get_dict(self) -> Dict[str, Any]:
49
+ return {"model": self.model, "message_history": self.message_history}
50
+ def __getstate__(self) -> Dict[str, Any]:
51
+ state = self.__dict__.copy()
52
+ return state
53
+ def __setstate__(self, state: Dict[str, Any]) -> None:
54
+ self.__dict__.update(state)
55
+
56
+ class PuterJS():
57
+ label = "Puter.js"
58
+ url = "https://docs.puter.com/playground"
59
+ api_endpoint = "https://api.puter.com/drivers/call"
60
+ working = True
61
+ needs_auth = False
62
+ supports_stream = False
63
+ supports_system_message = True
64
+ supports_message_history = True
65
+ default_model = 'gpt-4o'
66
+ default_vision_model = default_model
67
+ openai_models = [default_vision_model]
68
+ claude_models = []
69
+ mistral_models = []
70
+ xai_models = []
71
+ deepseek_models = []
72
+ gemini_models = []
73
+ openrouter_models = []
74
+ vision_models = [*openai_models]
75
+ models = vision_models
76
+ TOKEN_EXPIRATION = 30 * 60
77
+ MAX_RETRIES = 3
78
+ RETRY_DELAY = 5
79
+ RATE_LIMIT_DELAY = 60
80
+ Conversation = Conversation
81
+ AuthData = AuthData
82
+ _shared_auth_data = {}
83
+
84
+ @staticmethod
85
+ def get_driver_for_model(model: str) -> str:
86
+ if model in PuterJS.openai_models:
87
+ return "openai-completion"
88
+ elif model in PuterJS.claude_models:
89
+ return "claude"
90
+ elif model in PuterJS.mistral_models:
91
+ return "mistral"
92
+ elif model in PuterJS.xai_models:
93
+ return "xai"
94
+ elif model in PuterJS.deepseek_models:
95
+ return "deepseek"
96
+ elif model in PuterJS.gemini_models:
97
+ return "gemini"
98
+ elif model in PuterJS.openrouter_models:
99
+ return "openrouter"
100
+ else:
101
+ return "openai-completion"
102
+
103
+ @staticmethod
104
+ def format_messages_with_images(messages: Messages, media: MediaListType = None) -> Messages:
105
+ if not media:
106
+ return messages
107
+
108
+ formatted_messages = messages.copy()
109
+
110
+ for i in range(len(formatted_messages) - 1, -1, -1):
111
+ if formatted_messages[i]["role"] == "user":
112
+ user_msg = formatted_messages[i]
113
+
114
+ if isinstance(user_msg["content"], str):
115
+ text_content = user_msg["content"]
116
+ user_msg["content"] = [{"type": "text", "text": text_content}]
117
+ elif not isinstance(user_msg["content"], list):
118
+ user_msg["content"] = []
119
+
120
+ for image_data, image_name in media:
121
+ if isinstance(image_data, str) and (image_data.startswith("http://") or image_data.startswith("https://")):
122
+ user_msg["content"].append({
123
+ "type": "image_url",
124
+ "image_url": {"url": image_data}
125
+ })
126
+ else:
127
+ image_uri = to_data_uri(image_data)
128
+ user_msg["content"].append({
129
+ "type": "image_url",
130
+ "image_url": {"url": image_uri}
131
+ })
132
+
133
+ formatted_messages[i] = user_msg
134
+ break
135
+
136
+ return formatted_messages
137
+
138
+ @classmethod
139
+ def _create_temporary_account(cls, session: Session, proxy: str = None) -> Dict[str, str]:
140
+ signup_headers = {
141
+ "Content-Type": "application/json",
142
+ "host": "puter.com",
143
+ "connection": "keep-alive",
144
+ "sec-ch-ua-platform": "macOS",
145
+ "user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36",
146
+ "sec-ch-ua": '"Google Chrome";v="135", "Not-A.Brand";v="8", "Chromium";v="135"',
147
+ "sec-ch-ua-mobile": "?0",
148
+ "accept": "*/*",
149
+ "origin": "https://puter.com",
150
+ "sec-fetch-site": "same-site",
151
+ "sec-fetch-mode": "cors",
152
+ "sec-fetch-dest": "empty",
153
+ "referer": "https://puter.com/",
154
+ "accept-encoding": "gzip",
155
+ "accept-language": "en-US,en;q=0.9"
156
+ }
157
+
158
+ signup_data = {
159
+ "is_temp": True,
160
+ "client_id": str(uuid.uuid4())
161
+ }
162
+
163
+ for attempt in range(cls.MAX_RETRIES):
164
+ try:
165
+ response = session.post(
166
+ "https://puter.com/signup",
167
+ headers=signup_headers,
168
+ json=signup_data,
169
+ proxies={"https": proxy} if proxy else None,
170
+ timeout=30
171
+ )
172
+
173
+ if response.status_code == 429:
174
+ retry_after = int(response.headers.get('Retry-After', cls.RATE_LIMIT_DELAY))
175
+ if attempt < cls.MAX_RETRIES - 1:
176
+ time.sleep(retry_after)
177
+ continue
178
+ else:
179
+ raise RateLimitError(f"Rate limited by Puter.js API. Try again after {retry_after} seconds.")
180
+
181
+ if response.status_code != 200:
182
+ error_text = response.text
183
+ if attempt < cls.MAX_RETRIES - 1:
184
+ time.sleep(cls.RETRY_DELAY * (attempt + 1))
185
+ continue
186
+ else:
187
+ raise Exception(f"Failed to create temporary account. Status: {response.status_code}, Details: {error_text}")
188
+
189
+ try:
190
+ return response.json()
191
+ except Exception as e:
192
+ if attempt < cls.MAX_RETRIES - 1:
193
+ time.sleep(cls.RETRY_DELAY)
194
+ continue
195
+ else:
196
+ raise Exception(f"Failed to parse signup response as JSON: {e}")
197
+
198
+ except Exception as e:
199
+ if attempt < cls.MAX_RETRIES - 1:
200
+ time.sleep(cls.RETRY_DELAY * (2 ** attempt))
201
+ continue
202
+ else:
203
+ raise e
204
+
205
+ raise Exception("Failed to create temporary account after multiple retries")
206
+
207
+ @classmethod
208
+ def _get_app_token(cls, session: Session, auth_token: str, proxy: str = None) -> Dict[str, str]:
209
+ app_token_headers = {
210
+ "host": "api.puter.com",
211
+ "connection": "keep-alive",
212
+ "authorization": f"Bearer {auth_token}",
213
+ "user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36",
214
+ "accept": "*/*",
215
+ "origin": "https://puter.com",
216
+ "sec-fetch-site": "same-site",
217
+ "sec-fetch-mode": "cors",
218
+ "sec-fetch-dest": "empty",
219
+ "referer": "https://puter.com/",
220
+ "accept-encoding": "gzip",
221
+ "accept-language": "en-US,en;q=0.9",
222
+ "content-type": "application/json"
223
+ }
224
+
225
+ origins = ["http://docs.puter.com", "https://docs.puter.com", "https://puter.com"]
226
+ app_token_data = {"origin": random.choice(origins)}
227
+
228
+ for attempt in range(cls.MAX_RETRIES):
229
+ try:
230
+ response = session.post(
231
+ "https://api.puter.com/auth/get-user-app-token",
232
+ headers=app_token_headers,
233
+ json=app_token_data,
234
+ proxies={"https": proxy} if proxy else None,
235
+ timeout=30
236
+ )
237
+
238
+ if response.status_code == 429:
239
+ retry_after = int(response.headers.get('Retry-After', cls.RATE_LIMIT_DELAY))
240
+ if attempt < cls.MAX_RETRIES - 1:
241
+ time.sleep(retry_after)
242
+ continue
243
+ else:
244
+ raise RateLimitError(f"Rate limited by Puter.js API. Try again after {retry_after} seconds.")
245
+
246
+ if response.status_code != 200:
247
+ error_text = response.text
248
+ if attempt < cls.MAX_RETRIES - 1:
249
+ time.sleep(cls.RETRY_DELAY * (attempt + 1))
250
+ continue
251
+ else:
252
+ raise Exception(f"Failed to get app token. Status: {response.status_code}, Details: {error_text}")
253
+
254
+ try:
255
+ return response.json()
256
+ except Exception as e:
257
+ if attempt < cls.MAX_RETRIES - 1:
258
+ time.sleep(cls.RETRY_DELAY)
259
+ continue
260
+ else:
261
+ raise Exception(f"Failed to parse app token response as JSON: {e}")
262
+
263
+ except Exception as e:
264
+ if attempt < cls.MAX_RETRIES - 1:
265
+ time.sleep(cls.RETRY_DELAY * (2 ** attempt))
266
+ continue
267
+ else:
268
+ raise e
269
+
270
+ raise Exception("Failed to get app token after multiple retries")
271
+
272
+ @classmethod
273
+ def get_model(cls, model: str) -> str:
274
+ """Get the internal model name from the user-provided model name."""
275
+
276
+ if not model:
277
+ return cls.default_model
278
+
279
+ # Check if the model exists directly in our models list
280
+ if model in cls.models:
281
+ return model
282
+
283
+ # Check if there's an alias for this model
284
+ if model in cls.model_aliases:
285
+ alias = cls.model_aliases[model]
286
+ # If the alias is a list, randomly select one of the options
287
+ if isinstance(alias, list):
288
+ selected_model = random.choice(alias)
289
+ return selected_model
290
+ return alias
291
+
292
+ raise ModelNotFoundError(f"Model {model} not found")
293
+
294
+ @classmethod
295
+ def create_completion(
296
+ cls,
297
+ model: str,
298
+ messages: Messages,
299
+ proxy: str = None,
300
+ stream: bool = None, # Ignored in synchronous version
301
+ conversation: Optional[JsonConversation] = None,
302
+ return_conversation: bool = False,
303
+ media: MediaListType = None, # Add media parameter for images
304
+ **kwargs
305
+ ) -> Result:
306
+ model = cls.get_model(model)
307
+
308
+ # Check if we need to use a vision model
309
+ has_images = False
310
+ if media is not None and len(media) > 0:
311
+ has_images = True
312
+ # If images are present and model doesn't support vision, switch to default vision model
313
+ if model not in cls.vision_models:
314
+ model = cls.default_vision_model
315
+
316
+ # Check for image URLs in messages
317
+ if not has_images:
318
+ for msg in messages:
319
+ if msg["role"] == "user":
320
+ content = msg.get("content", "")
321
+ if isinstance(content, list):
322
+ for item in content:
323
+ if item.get("type") == "image_url":
324
+ has_images = True
325
+ if model not in cls.vision_models:
326
+ model = cls.default_vision_model
327
+ break
328
+ elif isinstance(content, str):
329
+ # Check for URLs in the text
330
+ urls = re.findall(r'https?://\S+\.(jpg|jpeg|png|gif|webp)', content, re.IGNORECASE)
331
+ if urls:
332
+ has_images = True
333
+ if model not in cls.vision_models:
334
+ model = cls.default_vision_model
335
+ break
336
+
337
+ # Check if the conversation is of the correct type
338
+ if conversation is not None and not isinstance(conversation, cls.Conversation):
339
+ # Convert generic JsonConversation to our specific Conversation class
340
+ new_conversation = cls.Conversation(model)
341
+ new_conversation.message_history = conversation.message_history.copy() if hasattr(conversation, 'message_history') else messages.copy()
342
+ conversation = new_conversation
343
+
344
+ # Initialize or update conversation
345
+ if conversation is None:
346
+ conversation = cls.Conversation(model)
347
+ # Format messages with images if needed
348
+ if has_images and media:
349
+ conversation.message_history = cls.format_messages_with_images(messages, media)
350
+ else:
351
+ conversation.message_history = messages.copy()
352
+ else:
353
+ # Update message history with new messages
354
+ if has_images and media:
355
+ formatted_messages = cls.format_messages_with_images(messages, media)
356
+ for msg in formatted_messages:
357
+ if msg not in conversation.message_history:
358
+ conversation.message_history.append(msg)
359
+ else:
360
+ for msg in messages:
361
+ if msg not in conversation.message_history:
362
+ conversation.message_history.append(msg)
363
+
364
+ # Get the authentication data for this specific model
365
+ auth_data = conversation.get_auth_for_model(model, cls)
366
+
367
+ # Check if we can use shared auth data
368
+ if model in cls._shared_auth_data and cls._shared_auth_data[model].is_valid(cls.TOKEN_EXPIRATION):
369
+ # Copy shared auth data to conversation
370
+ shared_auth = cls._shared_auth_data[model]
371
+ auth_data.auth_token = shared_auth.auth_token
372
+ auth_data.app_token = shared_auth.app_token
373
+ auth_data.created_at = shared_auth.created_at
374
+ auth_data.tokens_valid = shared_auth.tokens_valid
375
+
376
+ # Check if rate limited
377
+ if auth_data.is_rate_limited():
378
+ wait_time = auth_data.rate_limited_until - time.time()
379
+ if wait_time > 0:
380
+ yield f"Rate limited. Please try again in {int(wait_time)} seconds."
381
+ return
382
+
383
+ with Session() as session:
384
+ # Step 1: Create a temporary account (if needed)
385
+ if not auth_data.is_valid(cls.TOKEN_EXPIRATION):
386
+ try:
387
+ # Try to authenticate
388
+ signup_data = cls._create_temporary_account(session, proxy)
389
+ auth_data.auth_token = signup_data.get("token")
390
+
391
+ if not auth_data.auth_token:
392
+ yield f"Error: No auth token in response for model {model}"
393
+ return
394
+
395
+ # Get app token
396
+ app_token_data = cls._get_app_token(session, auth_data.auth_token, proxy)
397
+ auth_data.app_token = app_token_data.get("token")
398
+
399
+ if not auth_data.app_token:
400
+ yield f"Error: No app token in response for model {model}"
401
+ return
402
+
403
+ # Mark tokens as valid
404
+ auth_data.created_at = time.time()
405
+ auth_data.tokens_valid = True
406
+
407
+ # Update shared auth data
408
+ cls._shared_auth_data[model] = auth_data
409
+
410
+ except RateLimitError as e:
411
+ # Set rate limit and inform user
412
+ auth_data.set_rate_limit(cls.RATE_LIMIT_DELAY)
413
+ yield str(e)
414
+ return
415
+ except Exception as e:
416
+ yield f"Error during authentication for model {model}: {str(e)}"
417
+ return
418
+
419
+ # Step 3: Make the chat request with proper image handling
420
+ try:
421
+ chat_headers = {
422
+ "host": "api.puter.com",
423
+ "connection": "keep-alive",
424
+ "authorization": f"Bearer {auth_data.app_token}",
425
+ "user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36",
426
+ "content-type": "application/json;charset=UTF-8",
427
+ "accept": "*/*",
428
+ "origin": "http://docs.puter.com",
429
+ "sec-fetch-site": "cross-site",
430
+ "sec-fetch-mode": "cors",
431
+ "sec-fetch-dest": "empty",
432
+ "referer": "http://docs.puter.com/",
433
+ "accept-encoding": "gzip",
434
+ "accept-language": "en-US,en;q=0.9"
435
+ }
436
+
437
+ driver = cls.get_driver_for_model(model)
438
+
439
+ processed_messages = conversation.message_history
440
+
441
+ if has_images and not any(isinstance(msg.get("content"), list) for msg in processed_messages):
442
+ for i, msg in enumerate(processed_messages):
443
+ if msg["role"] == "user":
444
+ if media and len(media) > 0:
445
+ processed_messages = cls.format_messages_with_images([msg], media)
446
+ else:
447
+ content = msg.get("content", "")
448
+ if isinstance(content, str):
449
+ urls = re.findall(r'https?://\S+\.(jpg|jpeg|png|gif|webp)', content, re.IGNORECASE)
450
+ if urls:
451
+ text_parts = []
452
+ image_urls = []
453
+
454
+ words = content.split()
455
+ for word in words:
456
+ if re.match(r'https?://\S+\.(jpg|jpeg|png|gif|webp)', word, re.IGNORECASE):
457
+ image_urls.append(word)
458
+ else:
459
+ text_parts.append(word)
460
+
461
+ formatted_content = []
462
+ if text_parts:
463
+ formatted_content.append({
464
+ "type": "text",
465
+ "text": " ".join(text_parts)
466
+ })
467
+
468
+ for url in image_urls:
469
+ formatted_content.append({
470
+ "type": "image_url",
471
+ "image_url": {"url": url}
472
+ })
473
+
474
+ processed_messages[i]["content"] = formatted_content
475
+ break
476
+
477
+ chat_data = {
478
+ "interface": "puter-chat-completion",
479
+ "driver": driver,
480
+ "test_mode": False,
481
+ "method": "complete",
482
+ "args": {
483
+ "messages": processed_messages,
484
+ "model": model,
485
+ "stream": False,
486
+ "max_tokens": kwargs.get("max_tokens", 4096)
487
+ }
488
+ }
489
+
490
+ for key, value in kwargs.items():
491
+ if key not in ["messages", "model", "stream", "max_tokens"]:
492
+ chat_data["args"][key] = value
493
+
494
+ for attempt in range(cls.MAX_RETRIES):
495
+ try:
496
+ response = session.post(
497
+ cls.api_endpoint,
498
+ headers=chat_headers,
499
+ json=chat_data,
500
+ proxies={"https": proxy} if proxy else None,
501
+ timeout=120
502
+ )
503
+
504
+ if response.status_code == 429:
505
+ retry_after = int(response.headers.get('Retry-After', cls.RATE_LIMIT_DELAY))
506
+ auth_data.set_rate_limit(retry_after)
507
+ if attempt < cls.MAX_RETRIES - 1:
508
+ time.sleep(min(retry_after, 10))
509
+ continue
510
+ else:
511
+ raise RateLimitError(f"Rate limited by Puter.js API. Try again after {retry_after} seconds.")
512
+
513
+ if response.status_code in [401, 403]:
514
+ error_text = response.text
515
+ auth_data.invalidate()
516
+ if attempt < cls.MAX_RETRIES - 1:
517
+ signup_data = cls._create_temporary_account(session, proxy)
518
+ auth_data.auth_token = signup_data.get("token")
519
+
520
+ app_token_data = cls._get_app_token(session, auth_data.auth_token, proxy)
521
+ auth_data.app_token = app_token_data.get("token")
522
+
523
+ auth_data.created_at = time.time()
524
+ auth_data.tokens_valid = True
525
+
526
+ cls._shared_auth_data[model] = auth_data
527
+
528
+ chat_headers["authorization"] = f"Bearer {auth_data.app_token}"
529
+
530
+ continue
531
+ else:
532
+ raise Exception(f"Authentication failed after {cls.MAX_RETRIES} attempts: {error_text}")
533
+
534
+ if response.status_code != 200:
535
+ error_text = response.text
536
+ if attempt < cls.MAX_RETRIES - 1:
537
+ time.sleep(cls.RETRY_DELAY * (attempt + 1))
538
+ continue
539
+ else:
540
+ raise Exception(f"Chat request failed. Status: {response.status_code}, Details: {error_text}")
541
+
542
+ try:
543
+ response_json = response.json()
544
+ except Exception as e:
545
+ error_text = response.text
546
+ if attempt < cls.MAX_RETRIES - 1:
547
+ time.sleep(cls.RETRY_DELAY)
548
+ continue
549
+ else:
550
+ raise Exception(f"Failed to parse chat response as JSON: {error_text}")
551
+
552
+ if response_json.get("success") is True:
553
+ content = response_json.get("result", {}).get("message", {}).get("content", "")
554
+
555
+ if content:
556
+ conversation.message_history.append({
557
+ "role": "assistant",
558
+ "content": content
559
+ })
560
+
561
+ yield content
562
+
563
+ if return_conversation:
564
+ yield conversation
565
+
566
+ return
567
+ else:
568
+ error_msg = response_json.get("error", {}).get("message", "Unknown error")
569
+
570
+ if "rate" in error_msg.lower() or "limit" in error_msg.lower():
571
+ auth_data.set_rate_limit()
572
+ if attempt < cls.MAX_RETRIES - 1:
573
+ time.sleep(cls.RETRY_DELAY)
574
+ continue
575
+ else:
576
+ raise RateLimitError(f"Rate limited: {error_msg}")
577
+
578
+ if "auth" in error_msg.lower() or "token" in error_msg.lower():
579
+ auth_data.invalidate()
580
+ if attempt < cls.MAX_RETRIES - 1:
581
+ signup_data = cls._create_temporary_account(session, proxy)
582
+ auth_data.auth_token = signup_data.get("token")
583
+
584
+ app_token_data = cls._get_app_token(session, auth_data.auth_token, proxy)
585
+ auth_data.app_token = app_token_data.get("token")
586
+
587
+ auth_data.created_at = time.time()
588
+ auth_data.tokens_valid = True
589
+
590
+ chat_headers["authorization"] = f"Bearer {auth_data.app_token}"
591
+
592
+ cls._shared_auth_data[model] = auth_data
593
+
594
+ continue
595
+
596
+ if attempt < cls.MAX_RETRIES - 1:
597
+ time.sleep(cls.RETRY_DELAY)
598
+ continue
599
+ else:
600
+ yield f"Error: {error_msg}"
601
+ return
602
+
603
+ except RateLimitError as e:
604
+ auth_data.set_rate_limit(cls.RATE_LIMIT_DELAY)
605
+ if attempt < cls.MAX_RETRIES - 1:
606
+ time.sleep(min(cls.RATE_LIMIT_DELAY, 10))
607
+ continue
608
+ else:
609
+ yield str(e)
610
+ return
611
+
612
+ except Exception as e:
613
+ if "token" in str(e).lower() or "auth" in str(e).lower():
614
+ auth_data.invalidate()
615
+
616
+ if attempt < cls.MAX_RETRIES - 1:
617
+ time.sleep(cls.RETRY_DELAY * (attempt + 1))
618
+ continue
619
+ else:
620
+ yield f"Error: {str(e)}"
621
+ return
622
+
623
+ except Exception as e:
624
+ if "token" in str(e).lower() or "auth" in str(e).lower():
625
+ auth_data.invalidate()
626
+
627
+ yield f"Error: {str(e)}"
628
+ return
629
+ if __name__ == "__main__":
630
+ # Example usage
631
+ puter = PuterJS()
632
+ messages = [{"role": "user", "content": "Hello, how are you?"}]
633
+ result = puter.create_completion(model="gpt-4o", messages=messages)
634
+ for res in result:
635
635
  print(res)