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