webscout 8.3.7__py3-none-any.whl → 2025.10.13__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of webscout might be problematic. Click here for more details.

Files changed (306) hide show
  1. webscout/AIauto.py +250 -250
  2. webscout/AIbase.py +379 -379
  3. webscout/AIutel.py +60 -60
  4. webscout/Bard.py +1012 -1012
  5. webscout/Bing_search.py +417 -417
  6. webscout/DWEBS.py +529 -529
  7. webscout/Extra/Act.md +309 -309
  8. webscout/Extra/GitToolkit/__init__.py +10 -10
  9. webscout/Extra/GitToolkit/gitapi/README.md +110 -110
  10. webscout/Extra/GitToolkit/gitapi/__init__.py +11 -11
  11. webscout/Extra/GitToolkit/gitapi/repository.py +195 -195
  12. webscout/Extra/GitToolkit/gitapi/user.py +96 -96
  13. webscout/Extra/GitToolkit/gitapi/utils.py +61 -61
  14. webscout/Extra/YTToolkit/README.md +375 -375
  15. webscout/Extra/YTToolkit/YTdownloader.py +956 -956
  16. webscout/Extra/YTToolkit/__init__.py +2 -2
  17. webscout/Extra/YTToolkit/transcriber.py +475 -475
  18. webscout/Extra/YTToolkit/ytapi/README.md +44 -44
  19. webscout/Extra/YTToolkit/ytapi/__init__.py +6 -6
  20. webscout/Extra/YTToolkit/ytapi/channel.py +307 -307
  21. webscout/Extra/YTToolkit/ytapi/errors.py +13 -13
  22. webscout/Extra/YTToolkit/ytapi/extras.py +118 -118
  23. webscout/Extra/YTToolkit/ytapi/https.py +88 -88
  24. webscout/Extra/YTToolkit/ytapi/patterns.py +61 -61
  25. webscout/Extra/YTToolkit/ytapi/playlist.py +58 -58
  26. webscout/Extra/YTToolkit/ytapi/pool.py +7 -7
  27. webscout/Extra/YTToolkit/ytapi/query.py +39 -39
  28. webscout/Extra/YTToolkit/ytapi/stream.py +62 -62
  29. webscout/Extra/YTToolkit/ytapi/utils.py +62 -62
  30. webscout/Extra/YTToolkit/ytapi/video.py +232 -232
  31. webscout/Extra/autocoder/__init__.py +9 -9
  32. webscout/Extra/autocoder/autocoder.py +1105 -1105
  33. webscout/Extra/autocoder/autocoder_utiles.py +332 -332
  34. webscout/Extra/gguf.md +429 -429
  35. webscout/Extra/gguf.py +1213 -1213
  36. webscout/Extra/tempmail/README.md +487 -487
  37. webscout/Extra/tempmail/__init__.py +27 -27
  38. webscout/Extra/tempmail/async_utils.py +140 -140
  39. webscout/Extra/tempmail/base.py +160 -160
  40. webscout/Extra/tempmail/cli.py +186 -186
  41. webscout/Extra/tempmail/emailnator.py +84 -84
  42. webscout/Extra/tempmail/mail_tm.py +360 -360
  43. webscout/Extra/tempmail/temp_mail_io.py +291 -291
  44. webscout/Extra/weather.md +281 -281
  45. webscout/Extra/weather.py +193 -193
  46. webscout/Litlogger/README.md +10 -10
  47. webscout/Litlogger/__init__.py +15 -15
  48. webscout/Litlogger/formats.py +13 -13
  49. webscout/Litlogger/handlers.py +121 -121
  50. webscout/Litlogger/levels.py +13 -13
  51. webscout/Litlogger/logger.py +134 -134
  52. webscout/Provider/AISEARCH/Perplexity.py +332 -332
  53. webscout/Provider/AISEARCH/README.md +279 -279
  54. webscout/Provider/AISEARCH/__init__.py +16 -1
  55. webscout/Provider/AISEARCH/felo_search.py +206 -206
  56. webscout/Provider/AISEARCH/genspark_search.py +323 -323
  57. webscout/Provider/AISEARCH/hika_search.py +185 -185
  58. webscout/Provider/AISEARCH/iask_search.py +410 -410
  59. webscout/Provider/AISEARCH/monica_search.py +219 -219
  60. webscout/Provider/AISEARCH/scira_search.py +316 -316
  61. webscout/Provider/AISEARCH/stellar_search.py +177 -177
  62. webscout/Provider/AISEARCH/webpilotai_search.py +255 -255
  63. webscout/Provider/Aitopia.py +314 -314
  64. webscout/Provider/Andi.py +1 -1
  65. webscout/Provider/Apriel.py +306 -0
  66. webscout/Provider/ChatGPTClone.py +237 -236
  67. webscout/Provider/ChatSandbox.py +343 -343
  68. webscout/Provider/Cloudflare.py +324 -324
  69. webscout/Provider/Cohere.py +208 -208
  70. webscout/Provider/Deepinfra.py +370 -366
  71. webscout/Provider/ExaAI.py +260 -260
  72. webscout/Provider/ExaChat.py +308 -308
  73. webscout/Provider/Flowith.py +221 -221
  74. webscout/Provider/GMI.py +293 -0
  75. webscout/Provider/Gemini.py +164 -164
  76. webscout/Provider/GeminiProxy.py +167 -167
  77. webscout/Provider/GithubChat.py +371 -372
  78. webscout/Provider/Groq.py +800 -800
  79. webscout/Provider/HeckAI.py +383 -383
  80. webscout/Provider/Jadve.py +282 -282
  81. webscout/Provider/K2Think.py +307 -307
  82. webscout/Provider/Koboldai.py +205 -205
  83. webscout/Provider/LambdaChat.py +423 -423
  84. webscout/Provider/Nemotron.py +244 -244
  85. webscout/Provider/Netwrck.py +248 -248
  86. webscout/Provider/OLLAMA.py +395 -395
  87. webscout/Provider/OPENAI/Cloudflare.py +393 -393
  88. webscout/Provider/OPENAI/FalconH1.py +451 -451
  89. webscout/Provider/OPENAI/FreeGemini.py +296 -296
  90. webscout/Provider/OPENAI/K2Think.py +431 -431
  91. webscout/Provider/OPENAI/NEMOTRON.py +240 -240
  92. webscout/Provider/OPENAI/PI.py +427 -427
  93. webscout/Provider/OPENAI/README.md +959 -959
  94. webscout/Provider/OPENAI/TogetherAI.py +345 -345
  95. webscout/Provider/OPENAI/TwoAI.py +465 -465
  96. webscout/Provider/OPENAI/__init__.py +33 -18
  97. webscout/Provider/OPENAI/base.py +248 -248
  98. webscout/Provider/OPENAI/chatglm.py +528 -0
  99. webscout/Provider/OPENAI/chatgpt.py +592 -592
  100. webscout/Provider/OPENAI/chatgptclone.py +521 -521
  101. webscout/Provider/OPENAI/chatsandbox.py +202 -202
  102. webscout/Provider/OPENAI/deepinfra.py +318 -314
  103. webscout/Provider/OPENAI/e2b.py +1665 -1665
  104. webscout/Provider/OPENAI/exaai.py +420 -420
  105. webscout/Provider/OPENAI/exachat.py +452 -452
  106. webscout/Provider/OPENAI/friendli.py +232 -232
  107. webscout/Provider/OPENAI/{refact.py → gmi.py} +324 -274
  108. webscout/Provider/OPENAI/groq.py +364 -364
  109. webscout/Provider/OPENAI/heckai.py +314 -314
  110. webscout/Provider/OPENAI/llmchatco.py +337 -337
  111. webscout/Provider/OPENAI/netwrck.py +355 -355
  112. webscout/Provider/OPENAI/oivscode.py +290 -290
  113. webscout/Provider/OPENAI/opkfc.py +518 -518
  114. webscout/Provider/OPENAI/pydantic_imports.py +1 -1
  115. webscout/Provider/OPENAI/scirachat.py +535 -535
  116. webscout/Provider/OPENAI/sonus.py +308 -308
  117. webscout/Provider/OPENAI/standardinput.py +442 -442
  118. webscout/Provider/OPENAI/textpollinations.py +340 -340
  119. webscout/Provider/OPENAI/toolbaz.py +419 -416
  120. webscout/Provider/OPENAI/typefully.py +362 -362
  121. webscout/Provider/OPENAI/utils.py +295 -295
  122. webscout/Provider/OPENAI/venice.py +436 -436
  123. webscout/Provider/OPENAI/wisecat.py +387 -387
  124. webscout/Provider/OPENAI/writecream.py +166 -166
  125. webscout/Provider/OPENAI/x0gpt.py +378 -378
  126. webscout/Provider/OPENAI/yep.py +389 -389
  127. webscout/Provider/OpenGPT.py +230 -230
  128. webscout/Provider/Openai.py +243 -243
  129. webscout/Provider/PI.py +405 -405
  130. webscout/Provider/Perplexitylabs.py +430 -430
  131. webscout/Provider/QwenLM.py +272 -272
  132. webscout/Provider/STT/__init__.py +16 -1
  133. webscout/Provider/Sambanova.py +257 -257
  134. webscout/Provider/StandardInput.py +309 -309
  135. webscout/Provider/TTI/README.md +82 -82
  136. webscout/Provider/TTI/__init__.py +33 -18
  137. webscout/Provider/TTI/aiarta.py +413 -413
  138. webscout/Provider/TTI/base.py +136 -136
  139. webscout/Provider/TTI/bing.py +243 -243
  140. webscout/Provider/TTI/gpt1image.py +149 -149
  141. webscout/Provider/TTI/imagen.py +196 -196
  142. webscout/Provider/TTI/infip.py +211 -211
  143. webscout/Provider/TTI/magicstudio.py +232 -232
  144. webscout/Provider/TTI/monochat.py +219 -219
  145. webscout/Provider/TTI/piclumen.py +214 -214
  146. webscout/Provider/TTI/pixelmuse.py +232 -232
  147. webscout/Provider/TTI/pollinations.py +232 -232
  148. webscout/Provider/TTI/together.py +288 -288
  149. webscout/Provider/TTI/utils.py +12 -12
  150. webscout/Provider/TTI/venice.py +367 -367
  151. webscout/Provider/TTS/README.md +192 -192
  152. webscout/Provider/TTS/__init__.py +33 -18
  153. webscout/Provider/TTS/parler.py +110 -110
  154. webscout/Provider/TTS/streamElements.py +333 -333
  155. webscout/Provider/TTS/utils.py +280 -280
  156. webscout/Provider/TeachAnything.py +237 -237
  157. webscout/Provider/TextPollinationsAI.py +310 -310
  158. webscout/Provider/TogetherAI.py +356 -356
  159. webscout/Provider/TwoAI.py +312 -312
  160. webscout/Provider/TypliAI.py +311 -311
  161. webscout/Provider/UNFINISHED/ChatHub.py +208 -208
  162. webscout/Provider/UNFINISHED/ChutesAI.py +313 -313
  163. webscout/Provider/UNFINISHED/GizAI.py +294 -294
  164. webscout/Provider/UNFINISHED/Marcus.py +198 -198
  165. webscout/Provider/UNFINISHED/Qodo.py +477 -477
  166. webscout/Provider/UNFINISHED/VercelAIGateway.py +338 -338
  167. webscout/Provider/UNFINISHED/XenAI.py +324 -324
  168. webscout/Provider/UNFINISHED/Youchat.py +330 -330
  169. webscout/Provider/UNFINISHED/liner.py +334 -0
  170. webscout/Provider/UNFINISHED/liner_api_request.py +262 -262
  171. webscout/Provider/UNFINISHED/puterjs.py +634 -634
  172. webscout/Provider/UNFINISHED/samurai.py +223 -223
  173. webscout/Provider/UNFINISHED/test_lmarena.py +119 -119
  174. webscout/Provider/Venice.py +250 -250
  175. webscout/Provider/VercelAI.py +256 -256
  176. webscout/Provider/WiseCat.py +231 -231
  177. webscout/Provider/WrDoChat.py +366 -366
  178. webscout/Provider/__init__.py +33 -18
  179. webscout/Provider/ai4chat.py +174 -174
  180. webscout/Provider/akashgpt.py +331 -331
  181. webscout/Provider/cerebras.py +446 -446
  182. webscout/Provider/chatglm.py +394 -301
  183. webscout/Provider/cleeai.py +211 -211
  184. webscout/Provider/elmo.py +282 -282
  185. webscout/Provider/geminiapi.py +208 -208
  186. webscout/Provider/granite.py +261 -261
  187. webscout/Provider/hermes.py +263 -263
  188. webscout/Provider/julius.py +223 -223
  189. webscout/Provider/learnfastai.py +309 -309
  190. webscout/Provider/llama3mitril.py +214 -214
  191. webscout/Provider/llmchat.py +243 -243
  192. webscout/Provider/llmchatco.py +290 -290
  193. webscout/Provider/meta.py +801 -801
  194. webscout/Provider/oivscode.py +309 -309
  195. webscout/Provider/scira_chat.py +383 -383
  196. webscout/Provider/searchchat.py +292 -292
  197. webscout/Provider/sonus.py +258 -258
  198. webscout/Provider/toolbaz.py +370 -367
  199. webscout/Provider/turboseek.py +273 -273
  200. webscout/Provider/typefully.py +207 -207
  201. webscout/Provider/yep.py +372 -372
  202. webscout/__init__.py +27 -31
  203. webscout/__main__.py +5 -5
  204. webscout/auth/api_key_manager.py +189 -189
  205. webscout/auth/config.py +175 -175
  206. webscout/auth/models.py +185 -185
  207. webscout/auth/routes.py +663 -664
  208. webscout/auth/simple_logger.py +236 -236
  209. webscout/cli.py +523 -523
  210. webscout/conversation.py +438 -438
  211. webscout/exceptions.py +361 -361
  212. webscout/litagent/Readme.md +298 -298
  213. webscout/litagent/__init__.py +28 -28
  214. webscout/litagent/agent.py +581 -581
  215. webscout/litagent/constants.py +59 -59
  216. webscout/litprinter/__init__.py +58 -58
  217. webscout/models.py +181 -181
  218. webscout/optimizers.py +419 -419
  219. webscout/prompt_manager.py +288 -288
  220. webscout/sanitize.py +1078 -1078
  221. webscout/scout/README.md +401 -401
  222. webscout/scout/__init__.py +8 -8
  223. webscout/scout/core/__init__.py +6 -6
  224. webscout/scout/core/crawler.py +297 -297
  225. webscout/scout/core/scout.py +706 -706
  226. webscout/scout/core/search_result.py +95 -95
  227. webscout/scout/core/text_analyzer.py +62 -62
  228. webscout/scout/core/text_utils.py +277 -277
  229. webscout/scout/core/web_analyzer.py +51 -51
  230. webscout/scout/element.py +599 -599
  231. webscout/scout/parsers/__init__.py +69 -69
  232. webscout/scout/parsers/html5lib_parser.py +172 -172
  233. webscout/scout/parsers/html_parser.py +236 -236
  234. webscout/scout/parsers/lxml_parser.py +178 -178
  235. webscout/scout/utils.py +37 -37
  236. webscout/search/__init__.py +51 -0
  237. webscout/search/base.py +195 -0
  238. webscout/search/duckduckgo_main.py +54 -0
  239. webscout/search/engines/__init__.py +48 -0
  240. webscout/search/engines/bing.py +84 -0
  241. webscout/search/engines/bing_news.py +52 -0
  242. webscout/search/engines/brave.py +43 -0
  243. webscout/search/engines/duckduckgo/__init__.py +25 -0
  244. webscout/search/engines/duckduckgo/answers.py +78 -0
  245. webscout/search/engines/duckduckgo/base.py +187 -0
  246. webscout/search/engines/duckduckgo/images.py +97 -0
  247. webscout/search/engines/duckduckgo/maps.py +168 -0
  248. webscout/search/engines/duckduckgo/news.py +68 -0
  249. webscout/search/engines/duckduckgo/suggestions.py +21 -0
  250. webscout/search/engines/duckduckgo/text.py +211 -0
  251. webscout/search/engines/duckduckgo/translate.py +47 -0
  252. webscout/search/engines/duckduckgo/videos.py +63 -0
  253. webscout/search/engines/duckduckgo/weather.py +74 -0
  254. webscout/search/engines/mojeek.py +37 -0
  255. webscout/search/engines/wikipedia.py +56 -0
  256. webscout/search/engines/yahoo.py +65 -0
  257. webscout/search/engines/yahoo_news.py +64 -0
  258. webscout/search/engines/yandex.py +43 -0
  259. webscout/search/engines/yep/__init__.py +13 -0
  260. webscout/search/engines/yep/base.py +32 -0
  261. webscout/search/engines/yep/images.py +99 -0
  262. webscout/search/engines/yep/suggestions.py +35 -0
  263. webscout/search/engines/yep/text.py +114 -0
  264. webscout/search/http_client.py +156 -0
  265. webscout/search/results.py +137 -0
  266. webscout/search/yep_main.py +44 -0
  267. webscout/swiftcli/Readme.md +323 -323
  268. webscout/swiftcli/__init__.py +95 -95
  269. webscout/swiftcli/core/__init__.py +7 -7
  270. webscout/swiftcli/core/cli.py +308 -308
  271. webscout/swiftcli/core/context.py +104 -104
  272. webscout/swiftcli/core/group.py +241 -241
  273. webscout/swiftcli/decorators/__init__.py +28 -28
  274. webscout/swiftcli/decorators/command.py +221 -221
  275. webscout/swiftcli/decorators/options.py +220 -220
  276. webscout/swiftcli/decorators/output.py +302 -302
  277. webscout/swiftcli/exceptions.py +21 -21
  278. webscout/swiftcli/plugins/__init__.py +9 -9
  279. webscout/swiftcli/plugins/base.py +135 -135
  280. webscout/swiftcli/plugins/manager.py +269 -269
  281. webscout/swiftcli/utils/__init__.py +59 -59
  282. webscout/swiftcli/utils/formatting.py +252 -252
  283. webscout/swiftcli/utils/parsing.py +267 -267
  284. webscout/update_checker.py +117 -117
  285. webscout/version.py +1 -1
  286. webscout/version.py.bak +2 -0
  287. webscout/zeroart/README.md +89 -89
  288. webscout/zeroart/__init__.py +134 -134
  289. webscout/zeroart/base.py +66 -66
  290. webscout/zeroart/effects.py +100 -100
  291. webscout/zeroart/fonts.py +1238 -1238
  292. {webscout-8.3.7.dist-info → webscout-2025.10.13.dist-info}/METADATA +936 -937
  293. webscout-2025.10.13.dist-info/RECORD +329 -0
  294. webscout/Provider/AISEARCH/DeepFind.py +0 -254
  295. webscout/Provider/OPENAI/Qwen3.py +0 -303
  296. webscout/Provider/OPENAI/qodo.py +0 -630
  297. webscout/Provider/OPENAI/xenai.py +0 -514
  298. webscout/tempid.py +0 -134
  299. webscout/webscout_search.py +0 -1183
  300. webscout/webscout_search_async.py +0 -649
  301. webscout/yep_search.py +0 -346
  302. webscout-8.3.7.dist-info/RECORD +0 -301
  303. {webscout-8.3.7.dist-info → webscout-2025.10.13.dist-info}/WHEEL +0 -0
  304. {webscout-8.3.7.dist-info → webscout-2025.10.13.dist-info}/entry_points.txt +0 -0
  305. {webscout-8.3.7.dist-info → webscout-2025.10.13.dist-info}/licenses/LICENSE.md +0 -0
  306. {webscout-8.3.7.dist-info → webscout-2025.10.13.dist-info}/top_level.txt +0 -0
@@ -1,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)