webscout 7.1__py3-none-any.whl → 7.2__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 (144) hide show
  1. webscout/AIauto.py +191 -191
  2. webscout/AIbase.py +122 -122
  3. webscout/AIutel.py +440 -440
  4. webscout/Bard.py +343 -161
  5. webscout/DWEBS.py +489 -492
  6. webscout/Extra/YTToolkit/YTdownloader.py +995 -995
  7. webscout/Extra/YTToolkit/__init__.py +2 -2
  8. webscout/Extra/YTToolkit/transcriber.py +476 -479
  9. webscout/Extra/YTToolkit/ytapi/channel.py +307 -307
  10. webscout/Extra/YTToolkit/ytapi/playlist.py +58 -58
  11. webscout/Extra/YTToolkit/ytapi/pool.py +7 -7
  12. webscout/Extra/YTToolkit/ytapi/utils.py +62 -62
  13. webscout/Extra/YTToolkit/ytapi/video.py +103 -103
  14. webscout/Extra/autocoder/__init__.py +9 -9
  15. webscout/Extra/autocoder/autocoder_utiles.py +199 -199
  16. webscout/Extra/autocoder/rawdog.py +5 -7
  17. webscout/Extra/autollama.py +230 -230
  18. webscout/Extra/gguf.py +3 -3
  19. webscout/Extra/weather.py +171 -171
  20. webscout/LLM.py +442 -442
  21. webscout/Litlogger/__init__.py +67 -681
  22. webscout/Litlogger/core/__init__.py +6 -0
  23. webscout/Litlogger/core/level.py +20 -0
  24. webscout/Litlogger/core/logger.py +123 -0
  25. webscout/Litlogger/handlers/__init__.py +12 -0
  26. webscout/Litlogger/handlers/console.py +50 -0
  27. webscout/Litlogger/handlers/file.py +143 -0
  28. webscout/Litlogger/handlers/network.py +174 -0
  29. webscout/Litlogger/styles/__init__.py +7 -0
  30. webscout/Litlogger/styles/colors.py +231 -0
  31. webscout/Litlogger/styles/formats.py +377 -0
  32. webscout/Litlogger/styles/text.py +87 -0
  33. webscout/Litlogger/utils/__init__.py +6 -0
  34. webscout/Litlogger/utils/detectors.py +154 -0
  35. webscout/Litlogger/utils/formatters.py +200 -0
  36. webscout/Provider/AISEARCH/DeepFind.py +250 -250
  37. webscout/Provider/Blackboxai.py +3 -3
  38. webscout/Provider/ChatGPTGratis.py +226 -0
  39. webscout/Provider/Cloudflare.py +3 -4
  40. webscout/Provider/DeepSeek.py +218 -0
  41. webscout/Provider/Deepinfra.py +3 -3
  42. webscout/Provider/Free2GPT.py +131 -124
  43. webscout/Provider/Gemini.py +100 -115
  44. webscout/Provider/Glider.py +3 -3
  45. webscout/Provider/Groq.py +5 -1
  46. webscout/Provider/Jadve.py +3 -3
  47. webscout/Provider/Marcus.py +191 -192
  48. webscout/Provider/Netwrck.py +3 -3
  49. webscout/Provider/PI.py +2 -2
  50. webscout/Provider/PizzaGPT.py +2 -3
  51. webscout/Provider/QwenLM.py +311 -0
  52. webscout/Provider/TTI/AiForce/__init__.py +22 -22
  53. webscout/Provider/TTI/AiForce/async_aiforce.py +257 -257
  54. webscout/Provider/TTI/AiForce/sync_aiforce.py +242 -242
  55. webscout/Provider/TTI/Nexra/__init__.py +22 -22
  56. webscout/Provider/TTI/Nexra/async_nexra.py +286 -286
  57. webscout/Provider/TTI/Nexra/sync_nexra.py +258 -258
  58. webscout/Provider/TTI/PollinationsAI/__init__.py +23 -23
  59. webscout/Provider/TTI/PollinationsAI/async_pollinations.py +330 -330
  60. webscout/Provider/TTI/PollinationsAI/sync_pollinations.py +285 -285
  61. webscout/Provider/TTI/artbit/__init__.py +22 -22
  62. webscout/Provider/TTI/artbit/async_artbit.py +184 -184
  63. webscout/Provider/TTI/artbit/sync_artbit.py +176 -176
  64. webscout/Provider/TTI/blackbox/__init__.py +4 -4
  65. webscout/Provider/TTI/blackbox/async_blackbox.py +212 -212
  66. webscout/Provider/TTI/blackbox/sync_blackbox.py +199 -199
  67. webscout/Provider/TTI/deepinfra/__init__.py +4 -4
  68. webscout/Provider/TTI/deepinfra/async_deepinfra.py +227 -227
  69. webscout/Provider/TTI/deepinfra/sync_deepinfra.py +199 -199
  70. webscout/Provider/TTI/huggingface/__init__.py +22 -22
  71. webscout/Provider/TTI/huggingface/async_huggingface.py +199 -199
  72. webscout/Provider/TTI/huggingface/sync_huggingface.py +195 -195
  73. webscout/Provider/TTI/imgninza/__init__.py +4 -4
  74. webscout/Provider/TTI/imgninza/async_ninza.py +214 -214
  75. webscout/Provider/TTI/imgninza/sync_ninza.py +209 -209
  76. webscout/Provider/TTI/talkai/__init__.py +4 -4
  77. webscout/Provider/TTI/talkai/async_talkai.py +229 -229
  78. webscout/Provider/TTI/talkai/sync_talkai.py +207 -207
  79. webscout/Provider/TTS/deepgram.py +182 -182
  80. webscout/Provider/TTS/elevenlabs.py +136 -136
  81. webscout/Provider/TTS/gesserit.py +150 -150
  82. webscout/Provider/TTS/murfai.py +138 -138
  83. webscout/Provider/TTS/parler.py +133 -134
  84. webscout/Provider/TTS/streamElements.py +360 -360
  85. webscout/Provider/TTS/utils.py +280 -280
  86. webscout/Provider/TTS/voicepod.py +116 -116
  87. webscout/Provider/TextPollinationsAI.py +2 -3
  88. webscout/Provider/WiseCat.py +193 -0
  89. webscout/Provider/__init__.py +144 -134
  90. webscout/Provider/cerebras.py +242 -227
  91. webscout/Provider/chatglm.py +204 -204
  92. webscout/Provider/dgaf.py +2 -3
  93. webscout/Provider/gaurish.py +2 -3
  94. webscout/Provider/geminiapi.py +208 -208
  95. webscout/Provider/granite.py +223 -0
  96. webscout/Provider/hermes.py +218 -218
  97. webscout/Provider/llama3mitril.py +179 -179
  98. webscout/Provider/llamatutor.py +3 -3
  99. webscout/Provider/llmchat.py +2 -3
  100. webscout/Provider/meta.py +794 -794
  101. webscout/Provider/multichat.py +331 -331
  102. webscout/Provider/typegpt.py +359 -359
  103. webscout/Provider/yep.py +2 -2
  104. webscout/__main__.py +5 -5
  105. webscout/cli.py +319 -319
  106. webscout/conversation.py +241 -242
  107. webscout/exceptions.py +328 -328
  108. webscout/litagent/__init__.py +28 -28
  109. webscout/litagent/agent.py +2 -3
  110. webscout/litprinter/__init__.py +0 -58
  111. webscout/scout/__init__.py +8 -8
  112. webscout/scout/core.py +884 -884
  113. webscout/scout/element.py +459 -459
  114. webscout/scout/parsers/__init__.py +69 -69
  115. webscout/scout/parsers/html5lib_parser.py +172 -172
  116. webscout/scout/parsers/html_parser.py +236 -236
  117. webscout/scout/parsers/lxml_parser.py +178 -178
  118. webscout/scout/utils.py +38 -38
  119. webscout/swiftcli/__init__.py +811 -811
  120. webscout/update_checker.py +2 -12
  121. webscout/version.py +1 -1
  122. webscout/webscout_search.py +5 -4
  123. webscout/zeroart/__init__.py +54 -54
  124. webscout/zeroart/base.py +60 -60
  125. webscout/zeroart/effects.py +99 -99
  126. webscout/zeroart/fonts.py +816 -816
  127. {webscout-7.1.dist-info → webscout-7.2.dist-info}/METADATA +4 -3
  128. webscout-7.2.dist-info/RECORD +217 -0
  129. webstoken/__init__.py +30 -30
  130. webstoken/classifier.py +189 -189
  131. webstoken/keywords.py +216 -216
  132. webstoken/language.py +128 -128
  133. webstoken/ner.py +164 -164
  134. webstoken/normalizer.py +35 -35
  135. webstoken/processor.py +77 -77
  136. webstoken/sentiment.py +206 -206
  137. webstoken/stemmer.py +73 -73
  138. webstoken/tagger.py +60 -60
  139. webstoken/tokenizer.py +158 -158
  140. webscout-7.1.dist-info/RECORD +0 -198
  141. {webscout-7.1.dist-info → webscout-7.2.dist-info}/LICENSE.md +0 -0
  142. {webscout-7.1.dist-info → webscout-7.2.dist-info}/WHEEL +0 -0
  143. {webscout-7.1.dist-info → webscout-7.2.dist-info}/entry_points.txt +0 -0
  144. {webscout-7.1.dist-info → webscout-7.2.dist-info}/top_level.txt +0 -0
@@ -1,286 +1,286 @@
1
- import aiohttp
2
- import asyncio
3
- import json
4
- import os
5
- import time
6
- from typing import List, Optional, Union, AsyncGenerator
7
- from pathlib import Path
8
- from aiohttp import ClientError
9
-
10
- from webscout.AIbase import AsyncImageProvider
11
- from webscout.Litlogger import LitLogger, LogFormat, ColorScheme
12
- from webscout.litagent import LitAgent
13
-
14
- # Initialize our fire logger and agent 🔥
15
- logger = LitLogger(
16
- "AsyncNexra",
17
- format=LogFormat.MODERN_EMOJI,
18
- color_scheme=ColorScheme.CYBERPUNK
19
- )
20
- agent = LitAgent()
21
-
22
- class AsyncNexraImager(AsyncImageProvider):
23
- """Your go-to async provider for generating fire images with Nexra! ⚡
24
-
25
- Examples:
26
- >>> # Basic usage
27
- >>> provider = AsyncNexraImager()
28
- >>> async def example():
29
- ... images = await provider.generate("Cool art")
30
- ... paths = await provider.save(images)
31
- >>>
32
- >>> # Advanced usage
33
- >>> provider = AsyncNexraImager(timeout=120)
34
- >>> async def example():
35
- ... images = await provider.generate(
36
- ... prompt="Epic dragon",
37
- ... model="midjourney",
38
- ... additional_params={
39
- ... "data": {
40
- ... "steps": 30,
41
- ... "cfg_scale": 8
42
- ... }
43
- ... }
44
- ... )
45
- ... paths = await provider.save(images, name="dragon", dir="my_art")
46
- """
47
-
48
- AVAILABLE_MODELS = {
49
- "standard": [
50
- "emi",
51
- "stablediffusion-1.5",
52
- "stablediffusion-2.1",
53
- "sdxl-lora",
54
- "dalle",
55
- "dalle2",
56
- "dalle-mini",
57
- "flux",
58
- "midjourney"
59
- ],
60
- "prodia": [
61
- "dreamshaperXL10_alpha2.safetensors [c8afe2ef]",
62
- "dynavisionXL_0411.safetensors [c39cc051]",
63
- "juggernautXL_v45.safetensors [e75f5471]",
64
- "realismEngineSDXL_v10.safetensors [af771c3f]",
65
- "sd_xl_base_1.0.safetensors [be9edd61]",
66
- "animagineXLV3_v30.safetensors [75f2f05b]",
67
- "sd_xl_base_1.0_inpainting_0.1.safetensors [5679a81a]",
68
- "turbovisionXL_v431.safetensors [78890989]",
69
- "devlishphotorealism_sdxl15.safetensors [77cba69f]",
70
- "realvisxlV40.safetensors [f7fdcb51]"
71
- ]
72
- }
73
-
74
- def __init__(self, timeout: int = 60, proxies: dict = {}, logging: bool = True):
75
- """Initialize your async Nexra provider with custom settings! ⚙️
76
-
77
- Args:
78
- timeout (int): Request timeout in seconds (default: 60)
79
- proxies (dict): Proxy settings for requests (default: {})
80
- logging (bool): Enable fire logging (default: True)
81
- """
82
- self.url = "https://nexra.aryahcr.cc/api/image/complements"
83
- self.headers = {
84
- "Content-Type": "application/json",
85
- "Accept": "application/json",
86
- "User-Agent": agent.random()
87
- }
88
- self.timeout = timeout
89
- self.proxies = proxies
90
- self.prompt: str = "AI-generated image - webscout"
91
- self.image_extension: str = "png"
92
- self.logging = logging
93
- if self.logging:
94
- logger.info("AsyncNexra provider initialized! 🚀")
95
-
96
- async def generate(
97
- self,
98
- prompt: str,
99
- model: str = "midjourney",
100
- amount: int = 1,
101
- max_retries: int = 3,
102
- retry_delay: int = 5,
103
- additional_params: Optional[dict] = None
104
- ) -> List[bytes]:
105
- """Generate some fire images from your prompt asynchronously! ⚡
106
-
107
- Examples:
108
- >>> provider = AsyncNexraImager()
109
- >>> async def example():
110
- ... # Basic usage
111
- ... images = await provider.generate("Cool art")
112
- ... # Advanced usage
113
- ... images = await provider.generate(
114
- ... prompt="Epic dragon",
115
- ... model="midjourney",
116
- ... amount=3,
117
- ... additional_params={"data": {"steps": 30}}
118
- ... )
119
-
120
- Args:
121
- prompt (str): Your image description
122
- model (str): Model to use (default: "midjourney")
123
- amount (int): How many images you want (default: 1)
124
- max_retries (int): Max retry attempts if something fails (default: 3)
125
- retry_delay (int): Seconds to wait between retries (default: 5)
126
- additional_params (dict, optional): Extra params for the API
127
-
128
- Returns:
129
- List[bytes]: Your generated images
130
-
131
- Raises:
132
- ValueError: If the inputs ain't valid
133
- ClientError: If the API calls fail after retries
134
- json.JSONDecodeError: If the API response is invalid
135
- """
136
- assert bool(prompt), "Prompt cannot be null"
137
- assert isinstance(amount, int) and amount > 0, "Amount should be a positive integer"
138
-
139
- all_models = self.AVAILABLE_MODELS["standard"] + self.AVAILABLE_MODELS["prodia"]
140
- assert model in all_models, f"Model should be one of {all_models}"
141
-
142
- self.prompt = prompt
143
- response = []
144
-
145
- payload = {
146
- "prompt": prompt,
147
- "model": "prodia" if model in self.AVAILABLE_MODELS["prodia"] else model,
148
- }
149
-
150
- if model in self.AVAILABLE_MODELS["prodia"]:
151
- payload["data"] = {
152
- "model": model,
153
- "steps": 25,
154
- "cfg_scale": 7,
155
- "sampler": "DPM++ 2M Karras",
156
- "negative_prompt": ""
157
- }
158
- if additional_params:
159
- payload.update(additional_params)
160
-
161
- async with aiohttp.ClientSession(headers=self.headers) as session:
162
- for attempt in range(max_retries):
163
- try:
164
- if self.logging:
165
- logger.info(f"Generating {amount} images with {model}... 🎨")
166
- async with session.post(
167
- self.url,
168
- json=payload,
169
- timeout=self.timeout,
170
- proxy=self.proxies.get('http')
171
- ) as resp:
172
- resp.raise_for_status()
173
- text = await resp.text()
174
-
175
- # Remove leading underscores and then parse JSON
176
- response_data = json.loads(text.lstrip("_"))
177
-
178
- if response_data.get("status") and "images" in response_data:
179
- for image_url in response_data["images"]:
180
- async with session.get(image_url) as img_resp:
181
- img_resp.raise_for_status()
182
- response.append(await img_resp.read())
183
- if self.logging:
184
- logger.success(f"Generated image {len(response)}/{amount}! 🎨")
185
- break
186
- else:
187
- raise Exception("Failed to generate image: " + str(response_data))
188
- except json.JSONDecodeError as json_err:
189
- if self.logging:
190
- logger.error(f"JSON Decode Error: {json_err} 😢")
191
- logger.debug(f"Raw response: {text}")
192
- if attempt == max_retries - 1:
193
- raise
194
- except ClientError as e:
195
- if self.logging:
196
- logger.error(f"Failed to generate images: {e} 😢")
197
- if attempt == max_retries - 1:
198
- raise
199
- if self.logging:
200
- logger.warning(f"Retrying in {retry_delay} seconds... 🔄")
201
- await asyncio.sleep(retry_delay)
202
-
203
- if self.logging:
204
- logger.success("Images generated successfully! 🎉")
205
- return response
206
-
207
- async def save(
208
- self,
209
- response: Union[AsyncGenerator[bytes, None], List[bytes]],
210
- name: Optional[str] = None,
211
- dir: Optional[Union[str, Path]] = None,
212
- filenames_prefix: str = "",
213
- ) -> List[str]:
214
- """Save your fire generated images asynchronously! 💾
215
-
216
- Examples:
217
- >>> provider = AsyncNexraImager()
218
- >>> async def example():
219
- ... images = await provider.generate("Cool art")
220
- ... # Save with default settings
221
- ... paths = await provider.save(images)
222
- ... # Save with custom name and directory
223
- ... paths = await provider.save(
224
- ... images,
225
- ... name="my_art",
226
- ... dir="my_images",
227
- ... filenames_prefix="test_"
228
- ... )
229
-
230
- Args:
231
- response (Union[AsyncGenerator[bytes, None], List[bytes]]): Your generated images
232
- name (Optional[str]): Custom name for your images
233
- dir (Optional[Union[str, Path]]): Where to save the images (default: current directory)
234
- filenames_prefix (str): Prefix for your image files
235
-
236
- Returns:
237
- List[str]: Paths to your saved images
238
- """
239
- save_dir = dir if dir else os.getcwd()
240
- if not os.path.exists(save_dir):
241
- os.makedirs(save_dir)
242
- if self.logging:
243
- logger.info(f"Created directory: {save_dir} 📁")
244
-
245
- name = self.prompt if name is None else name
246
- saved_paths = []
247
- timestamp = int(time.time())
248
-
249
- async def save_single_image(image_bytes: bytes, index: int) -> str:
250
- filename = f"{filenames_prefix}{name}_{index}.{self.image_extension}"
251
- filepath = os.path.join(save_dir, filename)
252
-
253
- # Write file using asyncio
254
- async with asyncio.Lock():
255
- with open(filepath, "wb") as f:
256
- f.write(image_bytes)
257
-
258
- if self.logging:
259
- logger.success(f"Saved image to: {filepath} 💾")
260
- return filepath
261
-
262
- # Handle both List[bytes] and AsyncGenerator
263
- if isinstance(response, list):
264
- image_list = response
265
- else:
266
- image_list = [chunk async for chunk in response]
267
-
268
- if self.logging:
269
- logger.info(f"Saving {len(image_list)} images... 💾")
270
- tasks = [save_single_image(img, i) for i, img in enumerate(image_list)]
271
- saved_paths = await asyncio.gather(*tasks)
272
- if self.logging:
273
- logger.success(f"Images saved successfully! Check {dir} 🎉")
274
- return saved_paths
275
-
276
- if __name__ == "__main__":
277
- async def main():
278
- bot = AsyncNexraImager()
279
- try:
280
- resp = await bot.generate("A shiny red sports car speeding down a scenic mountain road", "midjourney")
281
- paths = await bot.save(resp)
282
- print(paths)
283
- except Exception as e:
284
- logger.error(f"An error occurred: {e} 😢")
285
-
286
- asyncio.run(main())
1
+ import aiohttp
2
+ import asyncio
3
+ import json
4
+ import os
5
+ import time
6
+ from typing import List, Optional, Union, AsyncGenerator
7
+ from pathlib import Path
8
+ from aiohttp import ClientError
9
+
10
+ from webscout.AIbase import AsyncImageProvider
11
+ from webscout.Litlogger import Logger, LogFormat
12
+ from webscout.litagent import LitAgent
13
+
14
+ # Initialize our fire logger and agent 🔥
15
+ logger = Logger(
16
+ "AsyncNexra",
17
+ format=LogFormat.MODERN_EMOJI,
18
+
19
+ )
20
+ agent = LitAgent()
21
+
22
+ class AsyncNexraImager(AsyncImageProvider):
23
+ """Your go-to async provider for generating fire images with Nexra! ⚡
24
+
25
+ Examples:
26
+ >>> # Basic usage
27
+ >>> provider = AsyncNexraImager()
28
+ >>> async def example():
29
+ ... images = await provider.generate("Cool art")
30
+ ... paths = await provider.save(images)
31
+ >>>
32
+ >>> # Advanced usage
33
+ >>> provider = AsyncNexraImager(timeout=120)
34
+ >>> async def example():
35
+ ... images = await provider.generate(
36
+ ... prompt="Epic dragon",
37
+ ... model="midjourney",
38
+ ... additional_params={
39
+ ... "data": {
40
+ ... "steps": 30,
41
+ ... "cfg_scale": 8
42
+ ... }
43
+ ... }
44
+ ... )
45
+ ... paths = await provider.save(images, name="dragon", dir="my_art")
46
+ """
47
+
48
+ AVAILABLE_MODELS = {
49
+ "standard": [
50
+ "emi",
51
+ "stablediffusion-1.5",
52
+ "stablediffusion-2.1",
53
+ "sdxl-lora",
54
+ "dalle",
55
+ "dalle2",
56
+ "dalle-mini",
57
+ "flux",
58
+ "midjourney"
59
+ ],
60
+ "prodia": [
61
+ "dreamshaperXL10_alpha2.safetensors [c8afe2ef]",
62
+ "dynavisionXL_0411.safetensors [c39cc051]",
63
+ "juggernautXL_v45.safetensors [e75f5471]",
64
+ "realismEngineSDXL_v10.safetensors [af771c3f]",
65
+ "sd_xl_base_1.0.safetensors [be9edd61]",
66
+ "animagineXLV3_v30.safetensors [75f2f05b]",
67
+ "sd_xl_base_1.0_inpainting_0.1.safetensors [5679a81a]",
68
+ "turbovisionXL_v431.safetensors [78890989]",
69
+ "devlishphotorealism_sdxl15.safetensors [77cba69f]",
70
+ "realvisxlV40.safetensors [f7fdcb51]"
71
+ ]
72
+ }
73
+
74
+ def __init__(self, timeout: int = 60, proxies: dict = {}, logging: bool = True):
75
+ """Initialize your async Nexra provider with custom settings! ⚙️
76
+
77
+ Args:
78
+ timeout (int): Request timeout in seconds (default: 60)
79
+ proxies (dict): Proxy settings for requests (default: {})
80
+ logging (bool): Enable fire logging (default: True)
81
+ """
82
+ self.url = "https://nexra.aryahcr.cc/api/image/complements"
83
+ self.headers = {
84
+ "Content-Type": "application/json",
85
+ "Accept": "application/json",
86
+ "User-Agent": agent.random()
87
+ }
88
+ self.timeout = timeout
89
+ self.proxies = proxies
90
+ self.prompt: str = "AI-generated image - webscout"
91
+ self.image_extension: str = "png"
92
+ self.logging = logging
93
+ if self.logging:
94
+ logger.info("AsyncNexra provider initialized! 🚀")
95
+
96
+ async def generate(
97
+ self,
98
+ prompt: str,
99
+ model: str = "midjourney",
100
+ amount: int = 1,
101
+ max_retries: int = 3,
102
+ retry_delay: int = 5,
103
+ additional_params: Optional[dict] = None
104
+ ) -> List[bytes]:
105
+ """Generate some fire images from your prompt asynchronously! ⚡
106
+
107
+ Examples:
108
+ >>> provider = AsyncNexraImager()
109
+ >>> async def example():
110
+ ... # Basic usage
111
+ ... images = await provider.generate("Cool art")
112
+ ... # Advanced usage
113
+ ... images = await provider.generate(
114
+ ... prompt="Epic dragon",
115
+ ... model="midjourney",
116
+ ... amount=3,
117
+ ... additional_params={"data": {"steps": 30}}
118
+ ... )
119
+
120
+ Args:
121
+ prompt (str): Your image description
122
+ model (str): Model to use (default: "midjourney")
123
+ amount (int): How many images you want (default: 1)
124
+ max_retries (int): Max retry attempts if something fails (default: 3)
125
+ retry_delay (int): Seconds to wait between retries (default: 5)
126
+ additional_params (dict, optional): Extra params for the API
127
+
128
+ Returns:
129
+ List[bytes]: Your generated images
130
+
131
+ Raises:
132
+ ValueError: If the inputs ain't valid
133
+ ClientError: If the API calls fail after retries
134
+ json.JSONDecodeError: If the API response is invalid
135
+ """
136
+ assert bool(prompt), "Prompt cannot be null"
137
+ assert isinstance(amount, int) and amount > 0, "Amount should be a positive integer"
138
+
139
+ all_models = self.AVAILABLE_MODELS["standard"] + self.AVAILABLE_MODELS["prodia"]
140
+ assert model in all_models, f"Model should be one of {all_models}"
141
+
142
+ self.prompt = prompt
143
+ response = []
144
+
145
+ payload = {
146
+ "prompt": prompt,
147
+ "model": "prodia" if model in self.AVAILABLE_MODELS["prodia"] else model,
148
+ }
149
+
150
+ if model in self.AVAILABLE_MODELS["prodia"]:
151
+ payload["data"] = {
152
+ "model": model,
153
+ "steps": 25,
154
+ "cfg_scale": 7,
155
+ "sampler": "DPM++ 2M Karras",
156
+ "negative_prompt": ""
157
+ }
158
+ if additional_params:
159
+ payload.update(additional_params)
160
+
161
+ async with aiohttp.ClientSession(headers=self.headers) as session:
162
+ for attempt in range(max_retries):
163
+ try:
164
+ if self.logging:
165
+ logger.info(f"Generating {amount} images with {model}... 🎨")
166
+ async with session.post(
167
+ self.url,
168
+ json=payload,
169
+ timeout=self.timeout,
170
+ proxy=self.proxies.get('http')
171
+ ) as resp:
172
+ resp.raise_for_status()
173
+ text = await resp.text()
174
+
175
+ # Remove leading underscores and then parse JSON
176
+ response_data = json.loads(text.lstrip("_"))
177
+
178
+ if response_data.get("status") and "images" in response_data:
179
+ for image_url in response_data["images"]:
180
+ async with session.get(image_url) as img_resp:
181
+ img_resp.raise_for_status()
182
+ response.append(await img_resp.read())
183
+ if self.logging:
184
+ logger.success(f"Generated image {len(response)}/{amount}! 🎨")
185
+ break
186
+ else:
187
+ raise Exception("Failed to generate image: " + str(response_data))
188
+ except json.JSONDecodeError as json_err:
189
+ if self.logging:
190
+ logger.error(f"JSON Decode Error: {json_err} 😢")
191
+ logger.debug(f"Raw response: {text}")
192
+ if attempt == max_retries - 1:
193
+ raise
194
+ except ClientError as e:
195
+ if self.logging:
196
+ logger.error(f"Failed to generate images: {e} 😢")
197
+ if attempt == max_retries - 1:
198
+ raise
199
+ if self.logging:
200
+ logger.warning(f"Retrying in {retry_delay} seconds... 🔄")
201
+ await asyncio.sleep(retry_delay)
202
+
203
+ if self.logging:
204
+ logger.success("Images generated successfully! 🎉")
205
+ return response
206
+
207
+ async def save(
208
+ self,
209
+ response: Union[AsyncGenerator[bytes, None], List[bytes]],
210
+ name: Optional[str] = None,
211
+ dir: Optional[Union[str, Path]] = None,
212
+ filenames_prefix: str = "",
213
+ ) -> List[str]:
214
+ """Save your fire generated images asynchronously! 💾
215
+
216
+ Examples:
217
+ >>> provider = AsyncNexraImager()
218
+ >>> async def example():
219
+ ... images = await provider.generate("Cool art")
220
+ ... # Save with default settings
221
+ ... paths = await provider.save(images)
222
+ ... # Save with custom name and directory
223
+ ... paths = await provider.save(
224
+ ... images,
225
+ ... name="my_art",
226
+ ... dir="my_images",
227
+ ... filenames_prefix="test_"
228
+ ... )
229
+
230
+ Args:
231
+ response (Union[AsyncGenerator[bytes, None], List[bytes]]): Your generated images
232
+ name (Optional[str]): Custom name for your images
233
+ dir (Optional[Union[str, Path]]): Where to save the images (default: current directory)
234
+ filenames_prefix (str): Prefix for your image files
235
+
236
+ Returns:
237
+ List[str]: Paths to your saved images
238
+ """
239
+ save_dir = dir if dir else os.getcwd()
240
+ if not os.path.exists(save_dir):
241
+ os.makedirs(save_dir)
242
+ if self.logging:
243
+ logger.info(f"Created directory: {save_dir} 📁")
244
+
245
+ name = self.prompt if name is None else name
246
+ saved_paths = []
247
+ timestamp = int(time.time())
248
+
249
+ async def save_single_image(image_bytes: bytes, index: int) -> str:
250
+ filename = f"{filenames_prefix}{name}_{index}.{self.image_extension}"
251
+ filepath = os.path.join(save_dir, filename)
252
+
253
+ # Write file using asyncio
254
+ async with asyncio.Lock():
255
+ with open(filepath, "wb") as f:
256
+ f.write(image_bytes)
257
+
258
+ if self.logging:
259
+ logger.success(f"Saved image to: {filepath} 💾")
260
+ return filepath
261
+
262
+ # Handle both List[bytes] and AsyncGenerator
263
+ if isinstance(response, list):
264
+ image_list = response
265
+ else:
266
+ image_list = [chunk async for chunk in response]
267
+
268
+ if self.logging:
269
+ logger.info(f"Saving {len(image_list)} images... 💾")
270
+ tasks = [save_single_image(img, i) for i, img in enumerate(image_list)]
271
+ saved_paths = await asyncio.gather(*tasks)
272
+ if self.logging:
273
+ logger.success(f"Images saved successfully! Check {dir} 🎉")
274
+ return saved_paths
275
+
276
+ if __name__ == "__main__":
277
+ async def main():
278
+ bot = AsyncNexraImager()
279
+ try:
280
+ resp = await bot.generate("A shiny red sports car speeding down a scenic mountain road", "midjourney")
281
+ paths = await bot.save(resp)
282
+ print(paths)
283
+ except Exception as e:
284
+ logger.error(f"An error occurred: {e} 😢")
285
+
286
+ asyncio.run(main())