webscout 7.0__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 (147) 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 +136 -137
  38. webscout/Provider/ChatGPTGratis.py +226 -0
  39. webscout/Provider/Cloudflare.py +91 -78
  40. webscout/Provider/DeepSeek.py +218 -0
  41. webscout/Provider/Deepinfra.py +59 -35
  42. webscout/Provider/Free2GPT.py +131 -124
  43. webscout/Provider/Gemini.py +100 -115
  44. webscout/Provider/Glider.py +74 -59
  45. webscout/Provider/Groq.py +30 -18
  46. webscout/Provider/Jadve.py +108 -77
  47. webscout/Provider/Llama3.py +117 -94
  48. webscout/Provider/Marcus.py +191 -137
  49. webscout/Provider/Netwrck.py +62 -50
  50. webscout/Provider/PI.py +79 -124
  51. webscout/Provider/PizzaGPT.py +129 -83
  52. webscout/Provider/QwenLM.py +311 -0
  53. webscout/Provider/TTI/AiForce/__init__.py +22 -22
  54. webscout/Provider/TTI/AiForce/async_aiforce.py +257 -257
  55. webscout/Provider/TTI/AiForce/sync_aiforce.py +242 -242
  56. webscout/Provider/TTI/Nexra/__init__.py +22 -22
  57. webscout/Provider/TTI/Nexra/async_nexra.py +286 -286
  58. webscout/Provider/TTI/Nexra/sync_nexra.py +258 -258
  59. webscout/Provider/TTI/PollinationsAI/__init__.py +23 -23
  60. webscout/Provider/TTI/PollinationsAI/async_pollinations.py +330 -330
  61. webscout/Provider/TTI/PollinationsAI/sync_pollinations.py +285 -285
  62. webscout/Provider/TTI/artbit/__init__.py +22 -22
  63. webscout/Provider/TTI/artbit/async_artbit.py +184 -184
  64. webscout/Provider/TTI/artbit/sync_artbit.py +176 -176
  65. webscout/Provider/TTI/blackbox/__init__.py +4 -4
  66. webscout/Provider/TTI/blackbox/async_blackbox.py +212 -212
  67. webscout/Provider/TTI/blackbox/sync_blackbox.py +199 -199
  68. webscout/Provider/TTI/deepinfra/__init__.py +4 -4
  69. webscout/Provider/TTI/deepinfra/async_deepinfra.py +227 -227
  70. webscout/Provider/TTI/deepinfra/sync_deepinfra.py +199 -199
  71. webscout/Provider/TTI/huggingface/__init__.py +22 -22
  72. webscout/Provider/TTI/huggingface/async_huggingface.py +199 -199
  73. webscout/Provider/TTI/huggingface/sync_huggingface.py +195 -195
  74. webscout/Provider/TTI/imgninza/__init__.py +4 -4
  75. webscout/Provider/TTI/imgninza/async_ninza.py +214 -214
  76. webscout/Provider/TTI/imgninza/sync_ninza.py +209 -209
  77. webscout/Provider/TTI/talkai/__init__.py +4 -4
  78. webscout/Provider/TTI/talkai/async_talkai.py +229 -229
  79. webscout/Provider/TTI/talkai/sync_talkai.py +207 -207
  80. webscout/Provider/TTS/deepgram.py +182 -182
  81. webscout/Provider/TTS/elevenlabs.py +136 -136
  82. webscout/Provider/TTS/gesserit.py +150 -150
  83. webscout/Provider/TTS/murfai.py +138 -138
  84. webscout/Provider/TTS/parler.py +133 -134
  85. webscout/Provider/TTS/streamElements.py +360 -360
  86. webscout/Provider/TTS/utils.py +280 -280
  87. webscout/Provider/TTS/voicepod.py +116 -116
  88. webscout/Provider/TextPollinationsAI.py +74 -47
  89. webscout/Provider/WiseCat.py +193 -0
  90. webscout/Provider/__init__.py +144 -136
  91. webscout/Provider/cerebras.py +242 -227
  92. webscout/Provider/chatglm.py +204 -204
  93. webscout/Provider/dgaf.py +67 -39
  94. webscout/Provider/gaurish.py +105 -66
  95. webscout/Provider/geminiapi.py +208 -208
  96. webscout/Provider/granite.py +223 -0
  97. webscout/Provider/hermes.py +218 -218
  98. webscout/Provider/llama3mitril.py +179 -179
  99. webscout/Provider/llamatutor.py +72 -62
  100. webscout/Provider/llmchat.py +60 -35
  101. webscout/Provider/meta.py +794 -794
  102. webscout/Provider/multichat.py +331 -230
  103. webscout/Provider/typegpt.py +359 -356
  104. webscout/Provider/yep.py +5 -5
  105. webscout/__main__.py +5 -5
  106. webscout/cli.py +319 -319
  107. webscout/conversation.py +241 -242
  108. webscout/exceptions.py +328 -328
  109. webscout/litagent/__init__.py +28 -28
  110. webscout/litagent/agent.py +2 -3
  111. webscout/litprinter/__init__.py +0 -58
  112. webscout/scout/__init__.py +8 -8
  113. webscout/scout/core.py +884 -884
  114. webscout/scout/element.py +459 -459
  115. webscout/scout/parsers/__init__.py +69 -69
  116. webscout/scout/parsers/html5lib_parser.py +172 -172
  117. webscout/scout/parsers/html_parser.py +236 -236
  118. webscout/scout/parsers/lxml_parser.py +178 -178
  119. webscout/scout/utils.py +38 -38
  120. webscout/swiftcli/__init__.py +811 -811
  121. webscout/update_checker.py +2 -12
  122. webscout/version.py +1 -1
  123. webscout/webscout_search.py +1142 -1140
  124. webscout/webscout_search_async.py +635 -635
  125. webscout/zeroart/__init__.py +54 -54
  126. webscout/zeroart/base.py +60 -60
  127. webscout/zeroart/effects.py +99 -99
  128. webscout/zeroart/fonts.py +816 -816
  129. {webscout-7.0.dist-info → webscout-7.2.dist-info}/METADATA +21 -28
  130. webscout-7.2.dist-info/RECORD +217 -0
  131. webstoken/__init__.py +30 -30
  132. webstoken/classifier.py +189 -189
  133. webstoken/keywords.py +216 -216
  134. webstoken/language.py +128 -128
  135. webstoken/ner.py +164 -164
  136. webstoken/normalizer.py +35 -35
  137. webstoken/processor.py +77 -77
  138. webstoken/sentiment.py +206 -206
  139. webstoken/stemmer.py +73 -73
  140. webstoken/tagger.py +60 -60
  141. webstoken/tokenizer.py +158 -158
  142. webscout/Provider/RUBIKSAI.py +0 -272
  143. webscout-7.0.dist-info/RECORD +0 -199
  144. {webscout-7.0.dist-info → webscout-7.2.dist-info}/LICENSE.md +0 -0
  145. {webscout-7.0.dist-info → webscout-7.2.dist-info}/WHEEL +0 -0
  146. {webscout-7.0.dist-info → webscout-7.2.dist-info}/entry_points.txt +0 -0
  147. {webscout-7.0.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())