webscout 8.3.6__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 (304) hide show
  1. webscout/AIauto.py +250 -250
  2. webscout/AIbase.py +379 -379
  3. webscout/AIutel.py +60 -58
  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 +33 -11
  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 -314
  61. webscout/Provider/AISEARCH/stellar_search.py +177 -177
  62. webscout/Provider/AISEARCH/webpilotai_search.py +255 -255
  63. webscout/Provider/Aitopia.py +314 -315
  64. webscout/Provider/Andi.py +3 -3
  65. webscout/Provider/Apriel.py +306 -0
  66. webscout/Provider/ChatGPTClone.py +236 -236
  67. webscout/Provider/ChatSandbox.py +343 -342
  68. webscout/Provider/Cloudflare.py +324 -324
  69. webscout/Provider/Cohere.py +208 -207
  70. webscout/Provider/Deepinfra.py +370 -369
  71. webscout/Provider/ExaAI.py +260 -260
  72. webscout/Provider/ExaChat.py +308 -387
  73. webscout/Provider/Flowith.py +221 -221
  74. webscout/Provider/GMI.py +293 -0
  75. webscout/Provider/Gemini.py +164 -162
  76. webscout/Provider/GeminiProxy.py +167 -166
  77. webscout/Provider/GithubChat.py +371 -370
  78. webscout/Provider/Groq.py +800 -800
  79. webscout/Provider/HeckAI.py +383 -379
  80. webscout/Provider/Jadve.py +282 -297
  81. webscout/Provider/K2Think.py +308 -0
  82. webscout/Provider/Koboldai.py +206 -384
  83. webscout/Provider/LambdaChat.py +423 -425
  84. webscout/Provider/Nemotron.py +244 -245
  85. webscout/Provider/Netwrck.py +248 -247
  86. webscout/Provider/OLLAMA.py +395 -394
  87. webscout/Provider/OPENAI/Cloudflare.py +394 -395
  88. webscout/Provider/OPENAI/FalconH1.py +452 -457
  89. webscout/Provider/OPENAI/FreeGemini.py +297 -299
  90. webscout/Provider/OPENAI/{monochat.py → K2Think.py} +432 -329
  91. webscout/Provider/OPENAI/NEMOTRON.py +241 -244
  92. webscout/Provider/OPENAI/PI.py +428 -427
  93. webscout/Provider/OPENAI/README.md +959 -959
  94. webscout/Provider/OPENAI/TogetherAI.py +345 -345
  95. webscout/Provider/OPENAI/TwoAI.py +466 -467
  96. webscout/Provider/OPENAI/__init__.py +33 -59
  97. webscout/Provider/OPENAI/ai4chat.py +313 -303
  98. webscout/Provider/OPENAI/base.py +249 -269
  99. webscout/Provider/OPENAI/chatglm.py +528 -0
  100. webscout/Provider/OPENAI/chatgpt.py +593 -588
  101. webscout/Provider/OPENAI/chatgptclone.py +521 -524
  102. webscout/Provider/OPENAI/chatsandbox.py +202 -177
  103. webscout/Provider/OPENAI/deepinfra.py +319 -315
  104. webscout/Provider/OPENAI/e2b.py +1665 -1665
  105. webscout/Provider/OPENAI/exaai.py +420 -420
  106. webscout/Provider/OPENAI/exachat.py +452 -452
  107. webscout/Provider/OPENAI/friendli.py +232 -232
  108. webscout/Provider/OPENAI/{refact.py → gmi.py} +324 -274
  109. webscout/Provider/OPENAI/groq.py +364 -364
  110. webscout/Provider/OPENAI/heckai.py +314 -311
  111. webscout/Provider/OPENAI/llmchatco.py +337 -337
  112. webscout/Provider/OPENAI/netwrck.py +355 -354
  113. webscout/Provider/OPENAI/oivscode.py +290 -290
  114. webscout/Provider/OPENAI/opkfc.py +518 -518
  115. webscout/Provider/OPENAI/pydantic_imports.py +1 -1
  116. webscout/Provider/OPENAI/scirachat.py +535 -529
  117. webscout/Provider/OPENAI/sonus.py +308 -308
  118. webscout/Provider/OPENAI/standardinput.py +442 -442
  119. webscout/Provider/OPENAI/textpollinations.py +340 -348
  120. webscout/Provider/OPENAI/toolbaz.py +419 -413
  121. webscout/Provider/OPENAI/typefully.py +362 -362
  122. webscout/Provider/OPENAI/utils.py +295 -295
  123. webscout/Provider/OPENAI/venice.py +436 -436
  124. webscout/Provider/OPENAI/wisecat.py +387 -387
  125. webscout/Provider/OPENAI/writecream.py +166 -166
  126. webscout/Provider/OPENAI/x0gpt.py +378 -378
  127. webscout/Provider/OPENAI/yep.py +389 -389
  128. webscout/Provider/OpenGPT.py +230 -230
  129. webscout/Provider/Openai.py +244 -496
  130. webscout/Provider/PI.py +405 -404
  131. webscout/Provider/Perplexitylabs.py +430 -431
  132. webscout/Provider/QwenLM.py +272 -254
  133. webscout/Provider/STT/__init__.py +32 -2
  134. webscout/Provider/{Llama3.py → Sambanova.py} +257 -258
  135. webscout/Provider/StandardInput.py +309 -309
  136. webscout/Provider/TTI/README.md +82 -82
  137. webscout/Provider/TTI/__init__.py +33 -12
  138. webscout/Provider/TTI/aiarta.py +413 -413
  139. webscout/Provider/TTI/base.py +136 -136
  140. webscout/Provider/TTI/bing.py +243 -243
  141. webscout/Provider/TTI/gpt1image.py +149 -149
  142. webscout/Provider/TTI/imagen.py +196 -196
  143. webscout/Provider/TTI/infip.py +211 -211
  144. webscout/Provider/TTI/magicstudio.py +232 -232
  145. webscout/Provider/TTI/monochat.py +219 -219
  146. webscout/Provider/TTI/piclumen.py +214 -214
  147. webscout/Provider/TTI/pixelmuse.py +232 -232
  148. webscout/Provider/TTI/pollinations.py +232 -232
  149. webscout/Provider/TTI/together.py +288 -288
  150. webscout/Provider/TTI/utils.py +12 -12
  151. webscout/Provider/TTI/venice.py +367 -367
  152. webscout/Provider/TTS/README.md +192 -192
  153. webscout/Provider/TTS/__init__.py +33 -10
  154. webscout/Provider/TTS/parler.py +110 -110
  155. webscout/Provider/TTS/streamElements.py +333 -333
  156. webscout/Provider/TTS/utils.py +280 -280
  157. webscout/Provider/TeachAnything.py +237 -236
  158. webscout/Provider/TextPollinationsAI.py +311 -318
  159. webscout/Provider/TogetherAI.py +356 -357
  160. webscout/Provider/TwoAI.py +313 -569
  161. webscout/Provider/TypliAI.py +312 -311
  162. webscout/Provider/UNFINISHED/ChatHub.py +208 -208
  163. webscout/Provider/UNFINISHED/ChutesAI.py +313 -313
  164. webscout/Provider/{GizAI.py → UNFINISHED/GizAI.py} +294 -294
  165. webscout/Provider/{Marcus.py → UNFINISHED/Marcus.py} +198 -198
  166. webscout/Provider/{Qodo.py → UNFINISHED/Qodo.py} +477 -477
  167. webscout/Provider/UNFINISHED/VercelAIGateway.py +338 -338
  168. webscout/Provider/{XenAI.py → UNFINISHED/XenAI.py} +324 -324
  169. webscout/Provider/UNFINISHED/Youchat.py +330 -330
  170. webscout/Provider/UNFINISHED/liner.py +334 -0
  171. webscout/Provider/UNFINISHED/liner_api_request.py +262 -262
  172. webscout/Provider/UNFINISHED/puterjs.py +634 -634
  173. webscout/Provider/UNFINISHED/samurai.py +223 -223
  174. webscout/Provider/UNFINISHED/test_lmarena.py +119 -119
  175. webscout/Provider/Venice.py +251 -250
  176. webscout/Provider/VercelAI.py +256 -255
  177. webscout/Provider/WiseCat.py +232 -231
  178. webscout/Provider/WrDoChat.py +367 -366
  179. webscout/Provider/__init__.py +33 -86
  180. webscout/Provider/ai4chat.py +174 -174
  181. webscout/Provider/akashgpt.py +331 -334
  182. webscout/Provider/cerebras.py +446 -340
  183. webscout/Provider/chatglm.py +394 -214
  184. webscout/Provider/cleeai.py +211 -212
  185. webscout/Provider/deepseek_assistant.py +1 -1
  186. webscout/Provider/elmo.py +282 -282
  187. webscout/Provider/geminiapi.py +208 -208
  188. webscout/Provider/granite.py +261 -261
  189. webscout/Provider/hermes.py +263 -265
  190. webscout/Provider/julius.py +223 -222
  191. webscout/Provider/learnfastai.py +309 -309
  192. webscout/Provider/llama3mitril.py +214 -214
  193. webscout/Provider/llmchat.py +243 -243
  194. webscout/Provider/llmchatco.py +290 -290
  195. webscout/Provider/meta.py +801 -801
  196. webscout/Provider/oivscode.py +309 -309
  197. webscout/Provider/scira_chat.py +384 -457
  198. webscout/Provider/searchchat.py +292 -291
  199. webscout/Provider/sonus.py +258 -258
  200. webscout/Provider/toolbaz.py +370 -364
  201. webscout/Provider/turboseek.py +274 -265
  202. webscout/Provider/typefully.py +208 -207
  203. webscout/Provider/x0gpt.py +1 -0
  204. webscout/Provider/yep.py +372 -371
  205. webscout/__init__.py +30 -31
  206. webscout/__main__.py +5 -5
  207. webscout/auth/api_key_manager.py +189 -189
  208. webscout/auth/config.py +175 -175
  209. webscout/auth/models.py +185 -185
  210. webscout/auth/routes.py +664 -664
  211. webscout/auth/simple_logger.py +236 -236
  212. webscout/cli.py +523 -523
  213. webscout/conversation.py +438 -438
  214. webscout/exceptions.py +361 -361
  215. webscout/litagent/Readme.md +298 -298
  216. webscout/litagent/__init__.py +28 -28
  217. webscout/litagent/agent.py +581 -581
  218. webscout/litagent/constants.py +59 -59
  219. webscout/litprinter/__init__.py +58 -58
  220. webscout/models.py +181 -181
  221. webscout/optimizers.py +419 -419
  222. webscout/prompt_manager.py +288 -288
  223. webscout/sanitize.py +1078 -1078
  224. webscout/scout/README.md +401 -401
  225. webscout/scout/__init__.py +8 -8
  226. webscout/scout/core/__init__.py +6 -6
  227. webscout/scout/core/crawler.py +297 -297
  228. webscout/scout/core/scout.py +706 -706
  229. webscout/scout/core/search_result.py +95 -95
  230. webscout/scout/core/text_analyzer.py +62 -62
  231. webscout/scout/core/text_utils.py +277 -277
  232. webscout/scout/core/web_analyzer.py +51 -51
  233. webscout/scout/element.py +599 -599
  234. webscout/scout/parsers/__init__.py +69 -69
  235. webscout/scout/parsers/html5lib_parser.py +172 -172
  236. webscout/scout/parsers/html_parser.py +236 -236
  237. webscout/scout/parsers/lxml_parser.py +178 -178
  238. webscout/scout/utils.py +37 -37
  239. webscout/swiftcli/Readme.md +323 -323
  240. webscout/swiftcli/__init__.py +95 -95
  241. webscout/swiftcli/core/__init__.py +7 -7
  242. webscout/swiftcli/core/cli.py +308 -308
  243. webscout/swiftcli/core/context.py +104 -104
  244. webscout/swiftcli/core/group.py +241 -241
  245. webscout/swiftcli/decorators/__init__.py +28 -28
  246. webscout/swiftcli/decorators/command.py +221 -221
  247. webscout/swiftcli/decorators/options.py +220 -220
  248. webscout/swiftcli/decorators/output.py +302 -302
  249. webscout/swiftcli/exceptions.py +21 -21
  250. webscout/swiftcli/plugins/__init__.py +9 -9
  251. webscout/swiftcli/plugins/base.py +135 -135
  252. webscout/swiftcli/plugins/manager.py +269 -269
  253. webscout/swiftcli/utils/__init__.py +59 -59
  254. webscout/swiftcli/utils/formatting.py +252 -252
  255. webscout/swiftcli/utils/parsing.py +267 -267
  256. webscout/update_checker.py +117 -117
  257. webscout/version.py +1 -1
  258. webscout/webscout_search.py +1183 -1183
  259. webscout/webscout_search_async.py +649 -649
  260. webscout/yep_search.py +346 -346
  261. webscout/zeroart/README.md +89 -89
  262. webscout/zeroart/__init__.py +134 -134
  263. webscout/zeroart/base.py +66 -66
  264. webscout/zeroart/effects.py +100 -100
  265. webscout/zeroart/fonts.py +1238 -1238
  266. {webscout-8.3.6.dist-info → webscout-2025.10.11.dist-info}/METADATA +937 -936
  267. webscout-2025.10.11.dist-info/RECORD +300 -0
  268. webscout/Provider/AISEARCH/DeepFind.py +0 -254
  269. webscout/Provider/AllenAI.py +0 -440
  270. webscout/Provider/Blackboxai.py +0 -793
  271. webscout/Provider/FreeGemini.py +0 -250
  272. webscout/Provider/GptOss.py +0 -207
  273. webscout/Provider/Hunyuan.py +0 -283
  274. webscout/Provider/Kimi.py +0 -445
  275. webscout/Provider/MCPCore.py +0 -322
  276. webscout/Provider/MiniMax.py +0 -207
  277. webscout/Provider/OPENAI/BLACKBOXAI.py +0 -1045
  278. webscout/Provider/OPENAI/MiniMax.py +0 -298
  279. webscout/Provider/OPENAI/Qwen3.py +0 -304
  280. webscout/Provider/OPENAI/autoproxy.py +0 -1067
  281. webscout/Provider/OPENAI/copilot.py +0 -321
  282. webscout/Provider/OPENAI/gptoss.py +0 -288
  283. webscout/Provider/OPENAI/kimi.py +0 -469
  284. webscout/Provider/OPENAI/mcpcore.py +0 -431
  285. webscout/Provider/OPENAI/multichat.py +0 -378
  286. webscout/Provider/OPENAI/qodo.py +0 -630
  287. webscout/Provider/OPENAI/xenai.py +0 -514
  288. webscout/Provider/Reka.py +0 -214
  289. webscout/Provider/UNFINISHED/fetch_together_models.py +0 -90
  290. webscout/Provider/asksteve.py +0 -220
  291. webscout/Provider/copilot.py +0 -441
  292. webscout/Provider/freeaichat.py +0 -294
  293. webscout/Provider/koala.py +0 -182
  294. webscout/Provider/lmarena.py +0 -198
  295. webscout/Provider/monochat.py +0 -275
  296. webscout/Provider/multichat.py +0 -375
  297. webscout/Provider/scnet.py +0 -244
  298. webscout/Provider/talkai.py +0 -194
  299. webscout/tempid.py +0 -128
  300. webscout-8.3.6.dist-info/RECORD +0 -327
  301. {webscout-8.3.6.dist-info → webscout-2025.10.11.dist-info}/WHEEL +0 -0
  302. {webscout-8.3.6.dist-info → webscout-2025.10.11.dist-info}/entry_points.txt +0 -0
  303. {webscout-8.3.6.dist-info → webscout-2025.10.11.dist-info}/licenses/LICENSE.md +0 -0
  304. {webscout-8.3.6.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)