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

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

Potentially problematic release.


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

Files changed (273) hide show
  1. webscout/AIauto.py +250 -250
  2. webscout/AIbase.py +379 -379
  3. webscout/AIutel.py +60 -60
  4. webscout/Bard.py +1012 -1012
  5. webscout/Bing_search.py +417 -417
  6. webscout/DWEBS.py +529 -529
  7. webscout/Extra/Act.md +309 -309
  8. webscout/Extra/GitToolkit/__init__.py +10 -10
  9. webscout/Extra/GitToolkit/gitapi/README.md +110 -110
  10. webscout/Extra/GitToolkit/gitapi/__init__.py +11 -11
  11. webscout/Extra/GitToolkit/gitapi/repository.py +195 -195
  12. webscout/Extra/GitToolkit/gitapi/user.py +96 -96
  13. webscout/Extra/GitToolkit/gitapi/utils.py +61 -61
  14. webscout/Extra/YTToolkit/README.md +375 -375
  15. webscout/Extra/YTToolkit/YTdownloader.py +956 -956
  16. webscout/Extra/YTToolkit/__init__.py +2 -2
  17. webscout/Extra/YTToolkit/transcriber.py +475 -475
  18. webscout/Extra/YTToolkit/ytapi/README.md +44 -44
  19. webscout/Extra/YTToolkit/ytapi/__init__.py +6 -6
  20. webscout/Extra/YTToolkit/ytapi/channel.py +307 -307
  21. webscout/Extra/YTToolkit/ytapi/errors.py +13 -13
  22. webscout/Extra/YTToolkit/ytapi/extras.py +118 -118
  23. webscout/Extra/YTToolkit/ytapi/https.py +88 -88
  24. webscout/Extra/YTToolkit/ytapi/patterns.py +61 -61
  25. webscout/Extra/YTToolkit/ytapi/playlist.py +58 -58
  26. webscout/Extra/YTToolkit/ytapi/pool.py +7 -7
  27. webscout/Extra/YTToolkit/ytapi/query.py +39 -39
  28. webscout/Extra/YTToolkit/ytapi/stream.py +62 -62
  29. webscout/Extra/YTToolkit/ytapi/utils.py +62 -62
  30. webscout/Extra/YTToolkit/ytapi/video.py +232 -232
  31. webscout/Extra/autocoder/__init__.py +9 -9
  32. webscout/Extra/autocoder/autocoder.py +1105 -1105
  33. webscout/Extra/autocoder/autocoder_utiles.py +332 -332
  34. webscout/Extra/gguf.md +429 -429
  35. webscout/Extra/gguf.py +1213 -1213
  36. webscout/Extra/tempmail/README.md +487 -487
  37. webscout/Extra/tempmail/__init__.py +27 -27
  38. webscout/Extra/tempmail/async_utils.py +140 -140
  39. webscout/Extra/tempmail/base.py +160 -160
  40. webscout/Extra/tempmail/cli.py +186 -186
  41. webscout/Extra/tempmail/emailnator.py +84 -84
  42. webscout/Extra/tempmail/mail_tm.py +360 -360
  43. webscout/Extra/tempmail/temp_mail_io.py +291 -291
  44. webscout/Extra/weather.md +281 -281
  45. webscout/Extra/weather.py +193 -193
  46. webscout/Litlogger/README.md +10 -10
  47. webscout/Litlogger/__init__.py +15 -15
  48. webscout/Litlogger/formats.py +13 -13
  49. webscout/Litlogger/handlers.py +121 -121
  50. webscout/Litlogger/levels.py +13 -13
  51. webscout/Litlogger/logger.py +134 -134
  52. webscout/Provider/AISEARCH/Perplexity.py +332 -332
  53. webscout/Provider/AISEARCH/README.md +279 -279
  54. webscout/Provider/AISEARCH/__init__.py +16 -1
  55. webscout/Provider/AISEARCH/felo_search.py +206 -206
  56. webscout/Provider/AISEARCH/genspark_search.py +323 -323
  57. webscout/Provider/AISEARCH/hika_search.py +185 -185
  58. webscout/Provider/AISEARCH/iask_search.py +410 -410
  59. webscout/Provider/AISEARCH/monica_search.py +219 -219
  60. webscout/Provider/AISEARCH/scira_search.py +316 -316
  61. webscout/Provider/AISEARCH/stellar_search.py +177 -177
  62. webscout/Provider/AISEARCH/webpilotai_search.py +255 -255
  63. webscout/Provider/Aitopia.py +314 -314
  64. webscout/Provider/Apriel.py +306 -0
  65. webscout/Provider/ChatGPTClone.py +236 -236
  66. webscout/Provider/ChatSandbox.py +343 -343
  67. webscout/Provider/Cloudflare.py +324 -324
  68. webscout/Provider/Cohere.py +208 -208
  69. webscout/Provider/Deepinfra.py +370 -366
  70. webscout/Provider/ExaAI.py +260 -260
  71. webscout/Provider/ExaChat.py +308 -308
  72. webscout/Provider/Flowith.py +221 -221
  73. webscout/Provider/GMI.py +293 -0
  74. webscout/Provider/Gemini.py +164 -164
  75. webscout/Provider/GeminiProxy.py +167 -167
  76. webscout/Provider/GithubChat.py +371 -372
  77. webscout/Provider/Groq.py +800 -800
  78. webscout/Provider/HeckAI.py +383 -383
  79. webscout/Provider/Jadve.py +282 -282
  80. webscout/Provider/K2Think.py +307 -307
  81. webscout/Provider/Koboldai.py +205 -205
  82. webscout/Provider/LambdaChat.py +423 -423
  83. webscout/Provider/Nemotron.py +244 -244
  84. webscout/Provider/Netwrck.py +248 -248
  85. webscout/Provider/OLLAMA.py +395 -395
  86. webscout/Provider/OPENAI/Cloudflare.py +393 -393
  87. webscout/Provider/OPENAI/FalconH1.py +451 -451
  88. webscout/Provider/OPENAI/FreeGemini.py +296 -296
  89. webscout/Provider/OPENAI/K2Think.py +431 -431
  90. webscout/Provider/OPENAI/NEMOTRON.py +240 -240
  91. webscout/Provider/OPENAI/PI.py +427 -427
  92. webscout/Provider/OPENAI/README.md +959 -959
  93. webscout/Provider/OPENAI/TogetherAI.py +345 -345
  94. webscout/Provider/OPENAI/TwoAI.py +465 -465
  95. webscout/Provider/OPENAI/__init__.py +33 -18
  96. webscout/Provider/OPENAI/base.py +248 -248
  97. webscout/Provider/OPENAI/chatglm.py +528 -0
  98. webscout/Provider/OPENAI/chatgpt.py +592 -592
  99. webscout/Provider/OPENAI/chatgptclone.py +521 -521
  100. webscout/Provider/OPENAI/chatsandbox.py +202 -202
  101. webscout/Provider/OPENAI/deepinfra.py +318 -314
  102. webscout/Provider/OPENAI/e2b.py +1665 -1665
  103. webscout/Provider/OPENAI/exaai.py +420 -420
  104. webscout/Provider/OPENAI/exachat.py +452 -452
  105. webscout/Provider/OPENAI/friendli.py +232 -232
  106. webscout/Provider/OPENAI/{refact.py → gmi.py} +324 -274
  107. webscout/Provider/OPENAI/groq.py +364 -364
  108. webscout/Provider/OPENAI/heckai.py +314 -314
  109. webscout/Provider/OPENAI/llmchatco.py +337 -337
  110. webscout/Provider/OPENAI/netwrck.py +355 -355
  111. webscout/Provider/OPENAI/oivscode.py +290 -290
  112. webscout/Provider/OPENAI/opkfc.py +518 -518
  113. webscout/Provider/OPENAI/pydantic_imports.py +1 -1
  114. webscout/Provider/OPENAI/scirachat.py +535 -535
  115. webscout/Provider/OPENAI/sonus.py +308 -308
  116. webscout/Provider/OPENAI/standardinput.py +442 -442
  117. webscout/Provider/OPENAI/textpollinations.py +340 -340
  118. webscout/Provider/OPENAI/toolbaz.py +419 -416
  119. webscout/Provider/OPENAI/typefully.py +362 -362
  120. webscout/Provider/OPENAI/utils.py +295 -295
  121. webscout/Provider/OPENAI/venice.py +436 -436
  122. webscout/Provider/OPENAI/wisecat.py +387 -387
  123. webscout/Provider/OPENAI/writecream.py +166 -166
  124. webscout/Provider/OPENAI/x0gpt.py +378 -378
  125. webscout/Provider/OPENAI/yep.py +389 -389
  126. webscout/Provider/OpenGPT.py +230 -230
  127. webscout/Provider/Openai.py +243 -243
  128. webscout/Provider/PI.py +405 -405
  129. webscout/Provider/Perplexitylabs.py +430 -430
  130. webscout/Provider/QwenLM.py +272 -272
  131. webscout/Provider/STT/__init__.py +16 -1
  132. webscout/Provider/Sambanova.py +257 -257
  133. webscout/Provider/StandardInput.py +309 -309
  134. webscout/Provider/TTI/README.md +82 -82
  135. webscout/Provider/TTI/__init__.py +33 -18
  136. webscout/Provider/TTI/aiarta.py +413 -413
  137. webscout/Provider/TTI/base.py +136 -136
  138. webscout/Provider/TTI/bing.py +243 -243
  139. webscout/Provider/TTI/gpt1image.py +149 -149
  140. webscout/Provider/TTI/imagen.py +196 -196
  141. webscout/Provider/TTI/infip.py +211 -211
  142. webscout/Provider/TTI/magicstudio.py +232 -232
  143. webscout/Provider/TTI/monochat.py +219 -219
  144. webscout/Provider/TTI/piclumen.py +214 -214
  145. webscout/Provider/TTI/pixelmuse.py +232 -232
  146. webscout/Provider/TTI/pollinations.py +232 -232
  147. webscout/Provider/TTI/together.py +288 -288
  148. webscout/Provider/TTI/utils.py +12 -12
  149. webscout/Provider/TTI/venice.py +367 -367
  150. webscout/Provider/TTS/README.md +192 -192
  151. webscout/Provider/TTS/__init__.py +33 -18
  152. webscout/Provider/TTS/parler.py +110 -110
  153. webscout/Provider/TTS/streamElements.py +333 -333
  154. webscout/Provider/TTS/utils.py +280 -280
  155. webscout/Provider/TeachAnything.py +237 -237
  156. webscout/Provider/TextPollinationsAI.py +310 -310
  157. webscout/Provider/TogetherAI.py +356 -356
  158. webscout/Provider/TwoAI.py +312 -312
  159. webscout/Provider/TypliAI.py +311 -311
  160. webscout/Provider/UNFINISHED/ChatHub.py +208 -208
  161. webscout/Provider/UNFINISHED/ChutesAI.py +313 -313
  162. webscout/Provider/UNFINISHED/GizAI.py +294 -294
  163. webscout/Provider/UNFINISHED/Marcus.py +198 -198
  164. webscout/Provider/UNFINISHED/Qodo.py +477 -477
  165. webscout/Provider/UNFINISHED/VercelAIGateway.py +338 -338
  166. webscout/Provider/UNFINISHED/XenAI.py +324 -324
  167. webscout/Provider/UNFINISHED/Youchat.py +330 -330
  168. webscout/Provider/UNFINISHED/liner.py +334 -0
  169. webscout/Provider/UNFINISHED/liner_api_request.py +262 -262
  170. webscout/Provider/UNFINISHED/puterjs.py +634 -634
  171. webscout/Provider/UNFINISHED/samurai.py +223 -223
  172. webscout/Provider/UNFINISHED/test_lmarena.py +119 -119
  173. webscout/Provider/Venice.py +250 -250
  174. webscout/Provider/VercelAI.py +256 -256
  175. webscout/Provider/WiseCat.py +231 -231
  176. webscout/Provider/WrDoChat.py +366 -366
  177. webscout/Provider/__init__.py +33 -18
  178. webscout/Provider/ai4chat.py +174 -174
  179. webscout/Provider/akashgpt.py +331 -331
  180. webscout/Provider/cerebras.py +446 -446
  181. webscout/Provider/chatglm.py +394 -301
  182. webscout/Provider/cleeai.py +211 -211
  183. webscout/Provider/elmo.py +282 -282
  184. webscout/Provider/geminiapi.py +208 -208
  185. webscout/Provider/granite.py +261 -261
  186. webscout/Provider/hermes.py +263 -263
  187. webscout/Provider/julius.py +223 -223
  188. webscout/Provider/learnfastai.py +309 -309
  189. webscout/Provider/llama3mitril.py +214 -214
  190. webscout/Provider/llmchat.py +243 -243
  191. webscout/Provider/llmchatco.py +290 -290
  192. webscout/Provider/meta.py +801 -801
  193. webscout/Provider/oivscode.py +309 -309
  194. webscout/Provider/scira_chat.py +383 -383
  195. webscout/Provider/searchchat.py +292 -292
  196. webscout/Provider/sonus.py +258 -258
  197. webscout/Provider/toolbaz.py +370 -367
  198. webscout/Provider/turboseek.py +273 -273
  199. webscout/Provider/typefully.py +207 -207
  200. webscout/Provider/yep.py +372 -372
  201. webscout/__init__.py +30 -31
  202. webscout/__main__.py +5 -5
  203. webscout/auth/api_key_manager.py +189 -189
  204. webscout/auth/config.py +175 -175
  205. webscout/auth/models.py +185 -185
  206. webscout/auth/routes.py +664 -664
  207. webscout/auth/simple_logger.py +236 -236
  208. webscout/cli.py +523 -523
  209. webscout/conversation.py +438 -438
  210. webscout/exceptions.py +361 -361
  211. webscout/litagent/Readme.md +298 -298
  212. webscout/litagent/__init__.py +28 -28
  213. webscout/litagent/agent.py +581 -581
  214. webscout/litagent/constants.py +59 -59
  215. webscout/litprinter/__init__.py +58 -58
  216. webscout/models.py +181 -181
  217. webscout/optimizers.py +419 -419
  218. webscout/prompt_manager.py +288 -288
  219. webscout/sanitize.py +1078 -1078
  220. webscout/scout/README.md +401 -401
  221. webscout/scout/__init__.py +8 -8
  222. webscout/scout/core/__init__.py +6 -6
  223. webscout/scout/core/crawler.py +297 -297
  224. webscout/scout/core/scout.py +706 -706
  225. webscout/scout/core/search_result.py +95 -95
  226. webscout/scout/core/text_analyzer.py +62 -62
  227. webscout/scout/core/text_utils.py +277 -277
  228. webscout/scout/core/web_analyzer.py +51 -51
  229. webscout/scout/element.py +599 -599
  230. webscout/scout/parsers/__init__.py +69 -69
  231. webscout/scout/parsers/html5lib_parser.py +172 -172
  232. webscout/scout/parsers/html_parser.py +236 -236
  233. webscout/scout/parsers/lxml_parser.py +178 -178
  234. webscout/scout/utils.py +37 -37
  235. webscout/swiftcli/Readme.md +323 -323
  236. webscout/swiftcli/__init__.py +95 -95
  237. webscout/swiftcli/core/__init__.py +7 -7
  238. webscout/swiftcli/core/cli.py +308 -308
  239. webscout/swiftcli/core/context.py +104 -104
  240. webscout/swiftcli/core/group.py +241 -241
  241. webscout/swiftcli/decorators/__init__.py +28 -28
  242. webscout/swiftcli/decorators/command.py +221 -221
  243. webscout/swiftcli/decorators/options.py +220 -220
  244. webscout/swiftcli/decorators/output.py +302 -302
  245. webscout/swiftcli/exceptions.py +21 -21
  246. webscout/swiftcli/plugins/__init__.py +9 -9
  247. webscout/swiftcli/plugins/base.py +135 -135
  248. webscout/swiftcli/plugins/manager.py +269 -269
  249. webscout/swiftcli/utils/__init__.py +59 -59
  250. webscout/swiftcli/utils/formatting.py +252 -252
  251. webscout/swiftcli/utils/parsing.py +267 -267
  252. webscout/update_checker.py +117 -117
  253. webscout/version.py +1 -1
  254. webscout/webscout_search.py +1183 -1183
  255. webscout/webscout_search_async.py +649 -649
  256. webscout/yep_search.py +346 -346
  257. webscout/zeroart/README.md +89 -89
  258. webscout/zeroart/__init__.py +134 -134
  259. webscout/zeroart/base.py +66 -66
  260. webscout/zeroart/effects.py +100 -100
  261. webscout/zeroart/fonts.py +1238 -1238
  262. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/METADATA +937 -937
  263. webscout-2025.10.11.dist-info/RECORD +300 -0
  264. webscout/Provider/AISEARCH/DeepFind.py +0 -254
  265. webscout/Provider/OPENAI/Qwen3.py +0 -303
  266. webscout/Provider/OPENAI/qodo.py +0 -630
  267. webscout/Provider/OPENAI/xenai.py +0 -514
  268. webscout/tempid.py +0 -134
  269. webscout-8.3.7.dist-info/RECORD +0 -301
  270. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/WHEEL +0 -0
  271. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/entry_points.txt +0 -0
  272. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/licenses/LICENSE.md +0 -0
  273. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/top_level.txt +0 -0
@@ -1,368 +1,371 @@
1
- import re
2
- from curl_cffi.requests import Session
3
- from curl_cffi import CurlError
4
- import uuid
5
- import base64
6
- import json
7
- import random
8
- import string
9
- import time
10
- from datetime import datetime
11
- from typing import Any, Dict, Optional, Generator, Union, List
12
-
13
- from webscout import exceptions
14
- from webscout.AIutel import Optimizers
15
- from webscout.AIutel import Conversation
16
- from webscout.AIutel import AwesomePrompts, sanitize_stream # Import sanitize_stream
17
- from webscout.AIbase import Provider
18
-
19
- class Toolbaz(Provider):
20
- """
21
- A class to interact with the Toolbaz API. Supports streaming responses.
22
- """
23
-
24
- required_auth = False
25
- AVAILABLE_MODELS = [
26
- "gemini-2.5-flash",
27
- "gemini-2.5-pro",
28
- "gemini-2.0-flash-thinking",
29
- "gemini-2.0-flash",
30
-
31
- "claude-sonnet-4",
32
-
33
- "gpt-5",
34
- "gpt-oss-120b",
35
- "o3-mini",
36
- "gpt-4o-latest",
37
-
38
- "toolbaz_v4",
39
- "toolbaz_v3.5_pro",
40
-
41
- "deepseek-r1",
42
- "deepseek-v3.1",
43
- "deepseek-v3",
44
-
45
- "Llama-4-Maverick",
46
- "Llama-3.3-70B",
47
-
48
- "mixtral_8x22b",
49
- "L3-70B-Euryale-v2.1",
50
- "midnight-rose",
51
- "unfiltered_x"
52
- ]
53
-
54
- def __init__(
55
- self,
56
- is_conversation: bool = True,
57
- max_tokens: int = 600, # Note: max_tokens is not directly used by the API
58
- timeout: int = 30,
59
- intro: str = None,
60
- filepath: str = None,
61
- update_file: bool = True,
62
- proxies: dict = {},
63
- history_offset: int = 10250,
64
- act: str = None,
65
- model: str = "gemini-2.0-flash",
66
- system_prompt: str = "You are a helpful AI assistant." # Note: system_prompt is not directly used by the API
67
- ):
68
- """
69
- Initializes the Toolbaz API with given parameters.
70
- """
71
- if model not in self.AVAILABLE_MODELS:
72
- raise ValueError(f"Invalid model: {model}. Choose from: {self.AVAILABLE_MODELS}")
73
-
74
- # Initialize curl_cffi Session
75
- self.session = Session()
76
- self.is_conversation = is_conversation
77
- self.max_tokens_to_sample = max_tokens
78
- self.timeout = timeout
79
- self.last_response = {}
80
- self.system_prompt = system_prompt
81
- self.model = model
82
- self.proxies = proxies # Store proxies for later use in requests
83
-
84
- # Set up headers for the curl_cffi session
85
- self.session.headers.update({
86
- "user-agent": "Mozilla/5.0 (Linux; Android 10)", # Keep specific user-agent
87
- "accept": "*/*",
88
- "accept-language": "en-US",
89
- "cache-control": "no-cache",
90
- "content-type": "application/x-www-form-urlencoded; charset=UTF-8",
91
- "origin": "https://toolbaz.com",
92
- "pragma": "no-cache",
93
- "referer": "https://toolbaz.com/",
94
- "sec-fetch-mode": "cors"
95
- # Add sec-ch-ua headers if needed for impersonation consistency
96
- })
97
- # Assign proxies directly to the session
98
- self.session.proxies = proxies
99
-
100
- # Initialize conversation history
101
- self.__available_optimizers = (
102
- method
103
- for method in dir(Optimizers)
104
- if callable(getattr(Optimizers, method)) and not method.startswith("__")
105
- )
106
-
107
- Conversation.intro = (
108
- AwesomePrompts().get_act(
109
- act, raise_not_found=True, default=None, case_insensitive=True
110
- )
111
- if act
112
- else intro or Conversation.intro
113
- )
114
-
115
- self.conversation = Conversation(
116
- is_conversation, self.max_tokens_to_sample, filepath, update_file
117
- )
118
- self.conversation.history_offset = history_offset
119
-
120
-
121
- def random_string(self, length):
122
- return ''.join(random.choices(string.ascii_letters + string.digits, k=length))
123
-
124
- def generate_token(self):
125
- payload = {
126
- "bR6wF": {
127
- "nV5kP": "Mozilla/5.0 (Linux; Android 10)",
128
- "lQ9jX": "en-US",
129
- "sD2zR": "431x958",
130
- "tY4hL": time.tzname[0] if time.tzname else "UTC",
131
- "pL8mC": "Linux armv81",
132
- "cQ3vD": datetime.now().year,
133
- "hK7jN": datetime.now().hour
134
- },
135
- "uT4bX": {
136
- "mM9wZ": [],
137
- "kP8jY": []
138
- },
139
- "tuTcS": int(time.time()),
140
- "tDfxy": None,
141
- "RtyJt": str(uuid.uuid4())
142
- }
143
- return "d8TW0v" + base64.b64encode(json.dumps(payload).encode()).decode()
144
-
145
- def get_auth(self):
146
- try:
147
- session_id = self.random_string(36)
148
- token = self.generate_token()
149
- data = {
150
- "session_id": session_id,
151
- "token": token
152
- }
153
- # Use curl_cffi session post WITHOUT impersonate for token request
154
- resp = self.session.post(
155
- "https://data.toolbaz.com/token.php",
156
- data=data
157
- # Removed impersonate="chrome110" for this specific request
158
- )
159
- resp.raise_for_status() # Check for HTTP errors
160
- result = resp.json()
161
- if result.get("success"):
162
- return {"token": result["token"], "session_id": session_id}
163
- # Raise error if success is not true
164
- raise exceptions.FailedToGenerateResponseError(f"Authentication failed: API response indicates failure. Response: {result}")
165
- except CurlError as e: # Catch CurlError specifically
166
- # Raise a specific error indicating CurlError during auth
167
- raise exceptions.FailedToGenerateResponseError(f"Authentication failed due to network error (CurlError): {e}") from e
168
- except json.JSONDecodeError as e:
169
- # Raise error for JSON decoding issues
170
- raise exceptions.FailedToGenerateResponseError(f"Authentication failed: Could not decode JSON response. Error: {e}. Response text: {getattr(resp, 'text', 'N/A')}") from e
171
- except Exception as e: # Catch other potential errors (like HTTPError from raise_for_status)
172
- # Raise a specific error indicating a general failure during auth
173
- err_text = getattr(e, 'response', None) and getattr(e.response, 'text', '')
174
- raise exceptions.FailedToGenerateResponseError(f"Authentication failed due to an unexpected error ({type(e).__name__}): {e} - {err_text}") from e
175
-
176
- def ask(
177
- self,
178
- prompt: str,
179
- stream: bool = False,
180
- raw: bool = False, # Kept for compatibility, but output is always dict/string
181
- optimizer: Optional[str] = None,
182
- conversationally: bool = False,
183
- ) -> Union[Dict[str, Any], Generator]:
184
- """Sends a prompt to the Toolbaz API and returns the response."""
185
- if optimizer and optimizer not in self.__available_optimizers:
186
- raise exceptions.FailedToGenerateResponseError(f"Optimizer is not one of {self.__available_optimizers}")
187
-
188
- conversation_prompt = self.conversation.gen_complete_prompt(prompt)
189
- if optimizer:
190
- conversation_prompt = getattr(Optimizers, optimizer)(
191
- conversation_prompt if conversationally else prompt
192
- )
193
-
194
- # get_auth now raises exceptions on failure
195
- auth = self.get_auth()
196
- # No need to check if auth is None, as an exception would have been raised
197
-
198
- data = {
199
- "text": conversation_prompt,
200
- "capcha": auth["token"],
201
- "model": self.model,
202
- "session_id": auth["session_id"]
203
- }
204
-
205
- def for_stream():
206
- try:
207
- # Use curl_cffi session post with impersonate for the main request
208
- resp = self.session.post(
209
- "https://data.toolbaz.com/writing.php",
210
- data=data,
211
- stream=True,
212
- timeout=self.timeout,
213
- impersonate="chrome110" # Keep impersonate here
214
- )
215
- resp.raise_for_status()
216
-
217
- streaming_text = ""
218
-
219
- # Use sanitize_stream with skip_regexes to remove [model:...] tags
220
- # It will decode bytes and yield processed string chunks
221
- processed_stream = sanitize_stream(
222
- data=resp.iter_content(chunk_size=None), # Pass byte iterator
223
- intro_value=None, # No simple prefix
224
- to_json=False, # Content is text
225
- skip_regexes=[r"\[model:.*?\]"], # Skip [model:...] tags
226
- yield_raw_on_error=True, # Yield even if regex processing fails
227
- raw=raw
228
- )
229
-
230
- for content_chunk in processed_stream:
231
- # content_chunk is the string with tags removed
232
- if isinstance(content_chunk, bytes):
233
- content_chunk = content_chunk.decode('utf-8', errors='ignore')
234
- if content_chunk is None:
235
- continue
236
- if raw:
237
- yield content_chunk
238
- else:
239
- if content_chunk and isinstance(content_chunk, str):
240
- streaming_text += content_chunk
241
- yield {"text": content_chunk}
242
-
243
- self.last_response = {"text": streaming_text}
244
- self.conversation.update_chat_history(prompt, streaming_text)
245
-
246
- except CurlError as e: # Catch CurlError
247
- raise exceptions.FailedToGenerateResponseError(f"Network error (CurlError): {str(e)}") from e
248
- except Exception as e: # Catch other exceptions
249
- raise exceptions.FailedToGenerateResponseError(f"Unexpected error during stream: {str(e)}") from e
250
-
251
- def for_non_stream():
252
- try:
253
- # Use curl_cffi session post with impersonate for the main request
254
- resp = self.session.post(
255
- "https://data.toolbaz.com/writing.php",
256
- data=data,
257
- timeout=self.timeout,
258
- impersonate="chrome110" # Keep impersonate here
259
- )
260
- resp.raise_for_status()
261
-
262
- # Use response.text which is already decoded
263
- text = resp.text
264
- # Remove [model: ...] tags
265
- text = re.sub(r"\[model:.*?\]", "", text)
266
-
267
- self.last_response = {"text": text}
268
- self.conversation.update_chat_history(prompt, text)
269
-
270
- return self.last_response
271
-
272
- except CurlError as e: # Catch CurlError
273
- raise exceptions.FailedToGenerateResponseError(f"Network error (CurlError): {str(e)}") from e
274
- except Exception as e: # Catch other exceptions
275
- raise exceptions.FailedToGenerateResponseError(f"Unexpected error: {str(e)}") from e
276
-
277
- return for_stream() if stream else for_non_stream()
278
-
279
- def chat(
280
- self,
281
- prompt: str,
282
- stream: bool = False,
283
- optimizer: Optional[str] = None,
284
- conversationally: bool = False,
285
- raw: bool = False, # Added raw parameter
286
- ) -> Union[str, Generator[str, None, None]]:
287
- """Generates a response from the Toolbaz API."""
288
- def for_stream_chat():
289
- # ask() yields dicts when raw=False
290
- for response in self.ask(
291
- prompt,
292
- stream=True,
293
- raw=raw,
294
- optimizer=optimizer,
295
- conversationally=conversationally
296
- ):
297
- if raw:
298
- yield response
299
- else:
300
- yield self.get_message(response)
301
-
302
- def for_non_stream_chat():
303
- # ask() returns a dict when stream=False
304
- response_dict = self.ask(
305
- prompt,
306
- stream=False,
307
- raw=raw,
308
- optimizer=optimizer,
309
- conversationally=conversationally,
310
- )
311
- if raw:
312
- return response_dict
313
- else:
314
- return self.get_message(response_dict)
315
-
316
- return for_stream_chat() if stream else for_non_stream_chat()
317
-
318
- def get_message(self, response: Dict[str, Any]) -> str:
319
- """Extract the message from the response.
320
-
321
- Args:
322
- response: Response dictionary
323
-
324
- Returns:
325
- str: Message extracted
326
- """
327
- assert isinstance(response, dict), "Response should be of dict data-type only"
328
- return response.get("text", "")
329
-
330
- # Example usage
331
- if __name__ == "__main__":
332
- # Ensure curl_cffi is installed
333
- from rich import print # Use rich print if available
334
- print("-" * 80)
335
- print(f"{'Model':<50} {'Status':<10} {'Response'}")
336
- print("-" * 80)
337
- # Test the provider with different models
338
- for model in Toolbaz.AVAILABLE_MODELS:
339
- try:
340
- test_ai = Toolbaz(model=model, timeout=60)
341
- # Test stream first
342
- response_stream = test_ai.chat("Say 'Hello' in one word", stream=True)
343
- response_text = ""
344
- # print(f"\r{model:<50} {'Streaming...':<10}", end="", flush=True)
345
- for chunk in response_stream:
346
- response_text += chunk
347
- # Optional: print chunks for visual feedback
348
- # print(chunk, end="", flush=True)
349
-
350
- if response_text and len(response_text.strip()) > 0:
351
- status = ""
352
- # Clean and truncate response
353
- clean_text = response_text.strip()
354
- display_text = clean_text[:50] + "..." if len(clean_text) > 50 else clean_text
355
- else:
356
- status = "✗ (Stream)"
357
- display_text = "Empty or invalid stream response"
358
- print(f"\r{model:<50} {status:<10} {display_text}")
359
-
360
- # Optional: Add non-stream test if needed
361
- # print(f"\r{model:<50} {'Non-Stream...':<10}", end="", flush=True)
362
- # response_non_stream = test_ai.chat("Say 'Hi' again", stream=False)
363
- # if not response_non_stream or len(response_non_stream.strip()) == 0:
364
- # print(f"\r{model:<50} {'✗ (Non-Stream)':<10} Empty non-stream response")
365
-
366
- except Exception as e:
367
- # Print full error for debugging
1
+ import re
2
+ from curl_cffi.requests import Session
3
+ from curl_cffi import CurlError
4
+ import uuid
5
+ import base64
6
+ import json
7
+ import random
8
+ import string
9
+ import time
10
+ from datetime import datetime
11
+ from typing import Any, Dict, Optional, Generator, Union, List
12
+
13
+ from webscout import exceptions
14
+ from webscout.AIutel import Optimizers
15
+ from webscout.AIutel import Conversation
16
+ from webscout.AIutel import AwesomePrompts, sanitize_stream # Import sanitize_stream
17
+ from webscout.AIbase import Provider
18
+
19
+ class Toolbaz(Provider):
20
+ """
21
+ A class to interact with the Toolbaz API. Supports streaming responses.
22
+ """
23
+
24
+ required_auth = False
25
+ AVAILABLE_MODELS = [
26
+ "gemini-2.5-flash",
27
+ "gemini-2.5-pro",
28
+ "gemini-2.0-flash-thinking",
29
+ "gemini-2.0-flash",
30
+
31
+ "claude-sonnet-4",
32
+
33
+ "gpt-5",
34
+ "gpt-oss-120b",
35
+ "o3-mini",
36
+ "gpt-4o-latest",
37
+
38
+ "grok-4-fast",
39
+
40
+ "toolbaz-v4.5-fast",
41
+ "toolbaz_v4",
42
+ "toolbaz_v3.5_pro",
43
+
44
+ "deepseek-r1",
45
+ "deepseek-v3.1",
46
+ "deepseek-v3",
47
+
48
+ "Llama-4-Maverick",
49
+ "Llama-3.3-70B",
50
+
51
+ "mixtral_8x22b",
52
+ "L3-70B-Euryale-v2.1",
53
+ "midnight-rose",
54
+ "unfiltered_x"
55
+ ]
56
+
57
+ def __init__(
58
+ self,
59
+ is_conversation: bool = True,
60
+ max_tokens: int = 600, # Note: max_tokens is not directly used by the API
61
+ timeout: int = 30,
62
+ intro: str = None,
63
+ filepath: str = None,
64
+ update_file: bool = True,
65
+ proxies: dict = {},
66
+ history_offset: int = 10250,
67
+ act: str = None,
68
+ model: str = "gemini-2.0-flash",
69
+ system_prompt: str = "You are a helpful AI assistant." # Note: system_prompt is not directly used by the API
70
+ ):
71
+ """
72
+ Initializes the Toolbaz API with given parameters.
73
+ """
74
+ if model not in self.AVAILABLE_MODELS:
75
+ raise ValueError(f"Invalid model: {model}. Choose from: {self.AVAILABLE_MODELS}")
76
+
77
+ # Initialize curl_cffi Session
78
+ self.session = Session()
79
+ self.is_conversation = is_conversation
80
+ self.max_tokens_to_sample = max_tokens
81
+ self.timeout = timeout
82
+ self.last_response = {}
83
+ self.system_prompt = system_prompt
84
+ self.model = model
85
+ self.proxies = proxies # Store proxies for later use in requests
86
+
87
+ # Set up headers for the curl_cffi session
88
+ self.session.headers.update({
89
+ "user-agent": "Mozilla/5.0 (Linux; Android 10)", # Keep specific user-agent
90
+ "accept": "*/*",
91
+ "accept-language": "en-US",
92
+ "cache-control": "no-cache",
93
+ "content-type": "application/x-www-form-urlencoded; charset=UTF-8",
94
+ "origin": "https://toolbaz.com",
95
+ "pragma": "no-cache",
96
+ "referer": "https://toolbaz.com/",
97
+ "sec-fetch-mode": "cors"
98
+ # Add sec-ch-ua headers if needed for impersonation consistency
99
+ })
100
+ # Assign proxies directly to the session
101
+ self.session.proxies = proxies
102
+
103
+ # Initialize conversation history
104
+ self.__available_optimizers = (
105
+ method
106
+ for method in dir(Optimizers)
107
+ if callable(getattr(Optimizers, method)) and not method.startswith("__")
108
+ )
109
+
110
+ Conversation.intro = (
111
+ AwesomePrompts().get_act(
112
+ act, raise_not_found=True, default=None, case_insensitive=True
113
+ )
114
+ if act
115
+ else intro or Conversation.intro
116
+ )
117
+
118
+ self.conversation = Conversation(
119
+ is_conversation, self.max_tokens_to_sample, filepath, update_file
120
+ )
121
+ self.conversation.history_offset = history_offset
122
+
123
+
124
+ def random_string(self, length):
125
+ return ''.join(random.choices(string.ascii_letters + string.digits, k=length))
126
+
127
+ def generate_token(self):
128
+ payload = {
129
+ "bR6wF": {
130
+ "nV5kP": "Mozilla/5.0 (Linux; Android 10)",
131
+ "lQ9jX": "en-US",
132
+ "sD2zR": "431x958",
133
+ "tY4hL": time.tzname[0] if time.tzname else "UTC",
134
+ "pL8mC": "Linux armv81",
135
+ "cQ3vD": datetime.now().year,
136
+ "hK7jN": datetime.now().hour
137
+ },
138
+ "uT4bX": {
139
+ "mM9wZ": [],
140
+ "kP8jY": []
141
+ },
142
+ "tuTcS": int(time.time()),
143
+ "tDfxy": None,
144
+ "RtyJt": str(uuid.uuid4())
145
+ }
146
+ return "d8TW0v" + base64.b64encode(json.dumps(payload).encode()).decode()
147
+
148
+ def get_auth(self):
149
+ try:
150
+ session_id = self.random_string(36)
151
+ token = self.generate_token()
152
+ data = {
153
+ "session_id": session_id,
154
+ "token": token
155
+ }
156
+ # Use curl_cffi session post WITHOUT impersonate for token request
157
+ resp = self.session.post(
158
+ "https://data.toolbaz.com/token.php",
159
+ data=data
160
+ # Removed impersonate="chrome110" for this specific request
161
+ )
162
+ resp.raise_for_status() # Check for HTTP errors
163
+ result = resp.json()
164
+ if result.get("success"):
165
+ return {"token": result["token"], "session_id": session_id}
166
+ # Raise error if success is not true
167
+ raise exceptions.FailedToGenerateResponseError(f"Authentication failed: API response indicates failure. Response: {result}")
168
+ except CurlError as e: # Catch CurlError specifically
169
+ # Raise a specific error indicating CurlError during auth
170
+ raise exceptions.FailedToGenerateResponseError(f"Authentication failed due to network error (CurlError): {e}") from e
171
+ except json.JSONDecodeError as e:
172
+ # Raise error for JSON decoding issues
173
+ raise exceptions.FailedToGenerateResponseError(f"Authentication failed: Could not decode JSON response. Error: {e}. Response text: {getattr(resp, 'text', 'N/A')}") from e
174
+ except Exception as e: # Catch other potential errors (like HTTPError from raise_for_status)
175
+ # Raise a specific error indicating a general failure during auth
176
+ err_text = getattr(e, 'response', None) and getattr(e.response, 'text', '')
177
+ raise exceptions.FailedToGenerateResponseError(f"Authentication failed due to an unexpected error ({type(e).__name__}): {e} - {err_text}") from e
178
+
179
+ def ask(
180
+ self,
181
+ prompt: str,
182
+ stream: bool = False,
183
+ raw: bool = False, # Kept for compatibility, but output is always dict/string
184
+ optimizer: Optional[str] = None,
185
+ conversationally: bool = False,
186
+ ) -> Union[Dict[str, Any], Generator]:
187
+ """Sends a prompt to the Toolbaz API and returns the response."""
188
+ if optimizer and optimizer not in self.__available_optimizers:
189
+ raise exceptions.FailedToGenerateResponseError(f"Optimizer is not one of {self.__available_optimizers}")
190
+
191
+ conversation_prompt = self.conversation.gen_complete_prompt(prompt)
192
+ if optimizer:
193
+ conversation_prompt = getattr(Optimizers, optimizer)(
194
+ conversation_prompt if conversationally else prompt
195
+ )
196
+
197
+ # get_auth now raises exceptions on failure
198
+ auth = self.get_auth()
199
+ # No need to check if auth is None, as an exception would have been raised
200
+
201
+ data = {
202
+ "text": conversation_prompt,
203
+ "capcha": auth["token"],
204
+ "model": self.model,
205
+ "session_id": auth["session_id"]
206
+ }
207
+
208
+ def for_stream():
209
+ try:
210
+ # Use curl_cffi session post with impersonate for the main request
211
+ resp = self.session.post(
212
+ "https://data.toolbaz.com/writing.php",
213
+ data=data,
214
+ stream=True,
215
+ timeout=self.timeout,
216
+ impersonate="chrome110" # Keep impersonate here
217
+ )
218
+ resp.raise_for_status()
219
+
220
+ streaming_text = ""
221
+
222
+ # Use sanitize_stream with skip_regexes to remove [model:...] tags
223
+ # It will decode bytes and yield processed string chunks
224
+ processed_stream = sanitize_stream(
225
+ data=resp.iter_content(chunk_size=None), # Pass byte iterator
226
+ intro_value=None, # No simple prefix
227
+ to_json=False, # Content is text
228
+ skip_regexes=[r"\[model:.*?\]"], # Skip [model:...] tags
229
+ yield_raw_on_error=True, # Yield even if regex processing fails
230
+ raw=raw
231
+ )
232
+
233
+ for content_chunk in processed_stream:
234
+ # content_chunk is the string with tags removed
235
+ if isinstance(content_chunk, bytes):
236
+ content_chunk = content_chunk.decode('utf-8', errors='ignore')
237
+ if content_chunk is None:
238
+ continue
239
+ if raw:
240
+ yield content_chunk
241
+ else:
242
+ if content_chunk and isinstance(content_chunk, str):
243
+ streaming_text += content_chunk
244
+ yield {"text": content_chunk}
245
+
246
+ self.last_response = {"text": streaming_text}
247
+ self.conversation.update_chat_history(prompt, streaming_text)
248
+
249
+ except CurlError as e: # Catch CurlError
250
+ raise exceptions.FailedToGenerateResponseError(f"Network error (CurlError): {str(e)}") from e
251
+ except Exception as e: # Catch other exceptions
252
+ raise exceptions.FailedToGenerateResponseError(f"Unexpected error during stream: {str(e)}") from e
253
+
254
+ def for_non_stream():
255
+ try:
256
+ # Use curl_cffi session post with impersonate for the main request
257
+ resp = self.session.post(
258
+ "https://data.toolbaz.com/writing.php",
259
+ data=data,
260
+ timeout=self.timeout,
261
+ impersonate="chrome110" # Keep impersonate here
262
+ )
263
+ resp.raise_for_status()
264
+
265
+ # Use response.text which is already decoded
266
+ text = resp.text
267
+ # Remove [model: ...] tags
268
+ text = re.sub(r"\[model:.*?\]", "", text)
269
+
270
+ self.last_response = {"text": text}
271
+ self.conversation.update_chat_history(prompt, text)
272
+
273
+ return self.last_response
274
+
275
+ except CurlError as e: # Catch CurlError
276
+ raise exceptions.FailedToGenerateResponseError(f"Network error (CurlError): {str(e)}") from e
277
+ except Exception as e: # Catch other exceptions
278
+ raise exceptions.FailedToGenerateResponseError(f"Unexpected error: {str(e)}") from e
279
+
280
+ return for_stream() if stream else for_non_stream()
281
+
282
+ def chat(
283
+ self,
284
+ prompt: str,
285
+ stream: bool = False,
286
+ optimizer: Optional[str] = None,
287
+ conversationally: bool = False,
288
+ raw: bool = False, # Added raw parameter
289
+ ) -> Union[str, Generator[str, None, None]]:
290
+ """Generates a response from the Toolbaz API."""
291
+ def for_stream_chat():
292
+ # ask() yields dicts when raw=False
293
+ for response in self.ask(
294
+ prompt,
295
+ stream=True,
296
+ raw=raw,
297
+ optimizer=optimizer,
298
+ conversationally=conversationally
299
+ ):
300
+ if raw:
301
+ yield response
302
+ else:
303
+ yield self.get_message(response)
304
+
305
+ def for_non_stream_chat():
306
+ # ask() returns a dict when stream=False
307
+ response_dict = self.ask(
308
+ prompt,
309
+ stream=False,
310
+ raw=raw,
311
+ optimizer=optimizer,
312
+ conversationally=conversationally,
313
+ )
314
+ if raw:
315
+ return response_dict
316
+ else:
317
+ return self.get_message(response_dict)
318
+
319
+ return for_stream_chat() if stream else for_non_stream_chat()
320
+
321
+ def get_message(self, response: Dict[str, Any]) -> str:
322
+ """Extract the message from the response.
323
+
324
+ Args:
325
+ response: Response dictionary
326
+
327
+ Returns:
328
+ str: Message extracted
329
+ """
330
+ assert isinstance(response, dict), "Response should be of dict data-type only"
331
+ return response.get("text", "")
332
+
333
+ # Example usage
334
+ if __name__ == "__main__":
335
+ # Ensure curl_cffi is installed
336
+ from rich import print # Use rich print if available
337
+ print("-" * 80)
338
+ print(f"{'Model':<50} {'Status':<10} {'Response'}")
339
+ print("-" * 80)
340
+ # Test the provider with different models
341
+ for model in Toolbaz.AVAILABLE_MODELS:
342
+ try:
343
+ test_ai = Toolbaz(model=model, timeout=60)
344
+ # Test stream first
345
+ response_stream = test_ai.chat("Say 'Hello' in one word", stream=True)
346
+ response_text = ""
347
+ # print(f"\r{model:<50} {'Streaming...':<10}", end="", flush=True)
348
+ for chunk in response_stream:
349
+ response_text += chunk
350
+ # Optional: print chunks for visual feedback
351
+ # print(chunk, end="", flush=True)
352
+
353
+ if response_text and len(response_text.strip()) > 0:
354
+ status = ""
355
+ # Clean and truncate response
356
+ clean_text = response_text.strip()
357
+ display_text = clean_text[:50] + "..." if len(clean_text) > 50 else clean_text
358
+ else:
359
+ status = "✗ (Stream)"
360
+ display_text = "Empty or invalid stream response"
361
+ print(f"\r{model:<50} {status:<10} {display_text}")
362
+
363
+ # Optional: Add non-stream test if needed
364
+ # print(f"\r{model:<50} {'Non-Stream...':<10}", end="", flush=True)
365
+ # response_non_stream = test_ai.chat("Say 'Hi' again", stream=False)
366
+ # if not response_non_stream or len(response_non_stream.strip()) == 0:
367
+ # print(f"\r{model:<50} {'✗ (Non-Stream)':<10} Empty non-stream response")
368
+
369
+ except Exception as e:
370
+ # Print full error for debugging
368
371
  print(f"\r{model:<50} {'✗':<10} Error: {str(e)}")