webscout 7.4__py3-none-any.whl → 7.6__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 (137) hide show
  1. webscout/AIauto.py +5 -53
  2. webscout/AIutel.py +8 -318
  3. webscout/DWEBS.py +460 -489
  4. webscout/Extra/YTToolkit/YTdownloader.py +14 -53
  5. webscout/Extra/YTToolkit/transcriber.py +12 -13
  6. webscout/Extra/YTToolkit/ytapi/video.py +0 -1
  7. webscout/Extra/__init__.py +0 -1
  8. webscout/Extra/autocoder/autocoder_utiles.py +0 -4
  9. webscout/Extra/autocoder/rawdog.py +13 -41
  10. webscout/Extra/gguf.py +652 -428
  11. webscout/Extra/weather.py +178 -156
  12. webscout/Extra/weather_ascii.py +70 -17
  13. webscout/Litlogger/core/logger.py +1 -2
  14. webscout/Litlogger/handlers/file.py +1 -1
  15. webscout/Litlogger/styles/formats.py +0 -2
  16. webscout/Litlogger/utils/detectors.py +0 -1
  17. webscout/Provider/AISEARCH/DeepFind.py +0 -1
  18. webscout/Provider/AISEARCH/ISou.py +1 -1
  19. webscout/Provider/AISEARCH/felo_search.py +0 -1
  20. webscout/Provider/AllenAI.py +24 -9
  21. webscout/Provider/C4ai.py +432 -0
  22. webscout/Provider/ChatGPTGratis.py +24 -56
  23. webscout/Provider/Cloudflare.py +18 -21
  24. webscout/Provider/DeepSeek.py +27 -48
  25. webscout/Provider/Deepinfra.py +129 -53
  26. webscout/Provider/Gemini.py +1 -1
  27. webscout/Provider/GithubChat.py +362 -0
  28. webscout/Provider/Glider.py +25 -8
  29. webscout/Provider/HF_space/qwen_qwen2.py +2 -2
  30. webscout/Provider/HeckAI.py +38 -5
  31. webscout/Provider/HuggingFaceChat.py +462 -0
  32. webscout/Provider/Jadve.py +20 -5
  33. webscout/Provider/Marcus.py +7 -50
  34. webscout/Provider/Netwrck.py +43 -67
  35. webscout/Provider/PI.py +4 -2
  36. webscout/Provider/Perplexitylabs.py +26 -6
  37. webscout/Provider/Phind.py +29 -3
  38. webscout/Provider/PizzaGPT.py +10 -51
  39. webscout/Provider/TTI/AiForce/async_aiforce.py +4 -37
  40. webscout/Provider/TTI/AiForce/sync_aiforce.py +41 -38
  41. webscout/Provider/TTI/FreeAIPlayground/__init__.py +9 -9
  42. webscout/Provider/TTI/FreeAIPlayground/async_freeaiplayground.py +206 -206
  43. webscout/Provider/TTI/FreeAIPlayground/sync_freeaiplayground.py +192 -192
  44. webscout/Provider/TTI/MagicStudio/__init__.py +2 -0
  45. webscout/Provider/TTI/MagicStudio/async_magicstudio.py +111 -0
  46. webscout/Provider/TTI/MagicStudio/sync_magicstudio.py +109 -0
  47. webscout/Provider/TTI/PollinationsAI/async_pollinations.py +5 -24
  48. webscout/Provider/TTI/PollinationsAI/sync_pollinations.py +2 -22
  49. webscout/Provider/TTI/__init__.py +2 -3
  50. webscout/Provider/TTI/aiarta/__init__.py +2 -0
  51. webscout/Provider/TTI/aiarta/async_aiarta.py +482 -0
  52. webscout/Provider/TTI/aiarta/sync_aiarta.py +440 -0
  53. webscout/Provider/TTI/fastflux/__init__.py +22 -0
  54. webscout/Provider/TTI/fastflux/async_fastflux.py +257 -0
  55. webscout/Provider/TTI/fastflux/sync_fastflux.py +247 -0
  56. webscout/Provider/TTS/__init__.py +2 -2
  57. webscout/Provider/TTS/deepgram.py +12 -39
  58. webscout/Provider/TTS/elevenlabs.py +14 -40
  59. webscout/Provider/TTS/gesserit.py +11 -35
  60. webscout/Provider/TTS/murfai.py +13 -39
  61. webscout/Provider/TTS/parler.py +17 -40
  62. webscout/Provider/TTS/speechma.py +180 -0
  63. webscout/Provider/TTS/streamElements.py +17 -44
  64. webscout/Provider/TextPollinationsAI.py +39 -59
  65. webscout/Provider/Venice.py +217 -200
  66. webscout/Provider/WiseCat.py +27 -5
  67. webscout/Provider/Youchat.py +63 -36
  68. webscout/Provider/__init__.py +13 -8
  69. webscout/Provider/akashgpt.py +28 -10
  70. webscout/Provider/copilot.py +416 -0
  71. webscout/Provider/flowith.py +196 -0
  72. webscout/Provider/freeaichat.py +32 -45
  73. webscout/Provider/granite.py +17 -53
  74. webscout/Provider/koala.py +20 -5
  75. webscout/Provider/llamatutor.py +7 -47
  76. webscout/Provider/llmchat.py +36 -53
  77. webscout/Provider/multichat.py +92 -98
  78. webscout/Provider/talkai.py +1 -0
  79. webscout/Provider/turboseek.py +3 -0
  80. webscout/Provider/tutorai.py +2 -0
  81. webscout/Provider/typegpt.py +154 -64
  82. webscout/Provider/x0gpt.py +3 -1
  83. webscout/Provider/yep.py +102 -20
  84. webscout/__init__.py +3 -0
  85. webscout/cli.py +4 -40
  86. webscout/conversation.py +1 -10
  87. webscout/exceptions.py +19 -9
  88. webscout/litagent/__init__.py +2 -2
  89. webscout/litagent/agent.py +351 -20
  90. webscout/litagent/constants.py +34 -5
  91. webscout/litprinter/__init__.py +0 -3
  92. webscout/models.py +181 -0
  93. webscout/optimizers.py +1 -1
  94. webscout/prompt_manager.py +2 -8
  95. webscout/scout/core/scout.py +1 -4
  96. webscout/scout/core/search_result.py +1 -1
  97. webscout/scout/core/text_utils.py +1 -1
  98. webscout/scout/core.py +2 -5
  99. webscout/scout/element.py +1 -1
  100. webscout/scout/parsers/html_parser.py +1 -1
  101. webscout/scout/utils.py +0 -1
  102. webscout/swiftcli/__init__.py +1 -3
  103. webscout/tempid.py +1 -1
  104. webscout/update_checker.py +55 -95
  105. webscout/version.py +1 -1
  106. webscout/webscout_search_async.py +1 -2
  107. webscout/yep_search.py +297 -297
  108. webscout-7.6.dist-info/LICENSE.md +146 -0
  109. {webscout-7.4.dist-info → webscout-7.6.dist-info}/METADATA +104 -514
  110. {webscout-7.4.dist-info → webscout-7.6.dist-info}/RECORD +113 -120
  111. webscout/Extra/autollama.py +0 -231
  112. webscout/Local/__init__.py +0 -10
  113. webscout/Local/_version.py +0 -3
  114. webscout/Local/formats.py +0 -747
  115. webscout/Local/model.py +0 -1368
  116. webscout/Local/samplers.py +0 -125
  117. webscout/Local/thread.py +0 -539
  118. webscout/Local/ui.py +0 -401
  119. webscout/Local/utils.py +0 -388
  120. webscout/Provider/Amigo.py +0 -274
  121. webscout/Provider/Bing.py +0 -243
  122. webscout/Provider/DiscordRocks.py +0 -253
  123. webscout/Provider/TTI/blackbox/__init__.py +0 -4
  124. webscout/Provider/TTI/blackbox/async_blackbox.py +0 -212
  125. webscout/Provider/TTI/blackbox/sync_blackbox.py +0 -199
  126. webscout/Provider/TTI/deepinfra/__init__.py +0 -4
  127. webscout/Provider/TTI/deepinfra/async_deepinfra.py +0 -227
  128. webscout/Provider/TTI/deepinfra/sync_deepinfra.py +0 -199
  129. webscout/Provider/TTI/imgninza/__init__.py +0 -4
  130. webscout/Provider/TTI/imgninza/async_ninza.py +0 -214
  131. webscout/Provider/TTI/imgninza/sync_ninza.py +0 -209
  132. webscout/Provider/TTS/voicepod.py +0 -117
  133. webscout/Provider/dgaf.py +0 -214
  134. webscout-7.4.dist-info/LICENSE.md +0 -211
  135. {webscout-7.4.dist-info → webscout-7.6.dist-info}/WHEEL +0 -0
  136. {webscout-7.4.dist-info → webscout-7.6.dist-info}/entry_points.txt +0 -0
  137. {webscout-7.4.dist-info → webscout-7.6.dist-info}/top_level.txt +0 -0
@@ -8,15 +8,10 @@ from requests.exceptions import RequestException
8
8
  from pathlib import Path
9
9
 
10
10
  from webscout.AIbase import ImageProvider
11
- from webscout.Litlogger import Logger, LogFormat
11
+
12
12
  from webscout.litagent import LitAgent
13
13
 
14
- # Initialize our fire logger and agent 🔥
15
- logger = Logger(
16
- "AiForce",
17
- format=LogFormat.MODERN_EMOJI,
18
14
 
19
- )
20
15
  agent = LitAgent()
21
16
 
22
17
  class AiForceimager(ImageProvider):
@@ -43,8 +38,6 @@ class AiForceimager(ImageProvider):
43
38
  AVAILABLE_MODELS = [
44
39
  "stable-diffusion-xl-lightning",
45
40
  "stable-diffusion-xl-base",
46
- "Flux-1.1-Pro",
47
- "ideogram",
48
41
  "flux",
49
42
  "flux-realism",
50
43
  "flux-anime",
@@ -55,13 +48,12 @@ class AiForceimager(ImageProvider):
55
48
  "any-dark"
56
49
  ]
57
50
 
58
- def __init__(self, timeout: int = 60, proxies: dict = {}, logging: bool = True):
51
+ def __init__(self, timeout: int = 60, proxies: dict = {}):
59
52
  """Initialize your AiForce provider with custom settings! ⚙️
60
53
 
61
54
  Args:
62
55
  timeout (int): Request timeout in seconds (default: 60)
63
56
  proxies (dict): Proxy settings for requests (default: {})
64
- logging (bool): Enable fire logging (default: True)
65
57
  """
66
58
  self.api_endpoint = "https://api.airforce/imagine2"
67
59
  self.headers = {
@@ -76,16 +68,14 @@ class AiForceimager(ImageProvider):
76
68
  self.timeout = timeout
77
69
  self.prompt: str = "AI-generated image - webscout"
78
70
  self.image_extension: str = "png"
79
- self.logging = logging
80
- if self.logging:
81
- logger.info("AiForce provider initialized! 🚀")
71
+
82
72
 
83
73
  def generate(
84
74
  self,
85
75
  prompt: str,
86
76
  amount: int = 1,
87
77
  additives: bool = True,
88
- model: str = "Flux-1.1-Pro",
78
+ model: str = "flux-3d",
89
79
  width: int = 768,
90
80
  height: int = 768,
91
81
  seed: Optional[int] = None,
@@ -139,8 +129,6 @@ class AiForceimager(ImageProvider):
139
129
  )
140
130
 
141
131
  self.prompt = prompt
142
- if self.logging:
143
- logger.info(f"Generating {amount} images with {model}... 🎨")
144
132
  response = []
145
133
  for _ in range(amount):
146
134
  url = f"{self.api_endpoint}?model={model}&prompt={prompt}&size={width}:{height}"
@@ -152,21 +140,13 @@ class AiForceimager(ImageProvider):
152
140
  resp = self.session.get(url, timeout=self.timeout)
153
141
  resp.raise_for_status()
154
142
  response.append(resp.content)
155
- if self.logging:
156
- logger.success(f"Generated image {_ + 1}/{amount}! 🎨")
157
143
  break
158
144
  except RequestException as e:
159
145
  if attempt == max_retries - 1:
160
- if self.logging:
161
- logger.error(f"Failed to generate image after {max_retries} attempts: {e} 😢")
162
146
  raise
163
147
  else:
164
- if self.logging:
165
- logger.warning(f"Attempt {attempt + 1} failed. Retrying in {retry_delay} seconds... 🔄")
166
148
  time.sleep(retry_delay)
167
149
 
168
- if self.logging:
169
- logger.success("Images generated successfully! 🎉")
170
150
  return response
171
151
 
172
152
  def save(
@@ -203,12 +183,8 @@ class AiForceimager(ImageProvider):
203
183
  save_dir = dir if dir else os.getcwd()
204
184
  if not os.path.exists(save_dir):
205
185
  os.makedirs(save_dir)
206
- if self.logging:
207
- logger.info(f"Created directory: {save_dir} 📁")
208
186
 
209
187
  name = self.prompt if name is None else name
210
- if self.logging:
211
- logger.info(f"Saving {len(response)} images... 💾")
212
188
  filenames = []
213
189
  count = 0
214
190
 
@@ -225,18 +201,45 @@ class AiForceimager(ImageProvider):
225
201
 
226
202
  with open(absolute_path_to_file, "wb") as fh:
227
203
  fh.write(image)
228
- if self.logging:
229
- logger.success(f"Saved image to: {absolute_path_to_file} 💾")
230
204
 
231
- if self.logging:
232
- logger.success(f"Images saved successfully! Check {dir} 🎉")
233
205
  return filenames
234
206
 
235
207
  if __name__ == "__main__":
236
208
  bot = AiForceimager()
237
- try:
238
- resp = bot.generate("A shiny red sports car speeding down a scenic mountain road", 1)
239
- print(bot.save(resp))
240
- except Exception as e:
241
- if bot.logging:
242
- logger.error(f"An error occurred: {e} 😢")
209
+ test_prompt = "A shiny red sports car speeding down a scenic mountain road"
210
+
211
+ print(f"Testing all available models with prompt: '{test_prompt}'")
212
+ print("-" * 50)
213
+
214
+ # Create a directory for test images if it doesn't exist
215
+ test_dir = "model_test_images"
216
+ if not os.path.exists(test_dir):
217
+ os.makedirs(test_dir)
218
+
219
+ for model in bot.AVAILABLE_MODELS:
220
+ print(f"Testing model: {model}")
221
+ try:
222
+ # Generate an image with the current model
223
+ resp = bot.generate(
224
+ prompt=test_prompt,
225
+ amount=1,
226
+ model=model,
227
+ width=768,
228
+ height=768
229
+ )
230
+
231
+ # Save the image with model name as prefix
232
+ saved_paths = bot.save(
233
+ resp,
234
+ name=f"{model}_test",
235
+ dir=test_dir,
236
+ filenames_prefix=f"{model}_"
237
+ )
238
+
239
+ print(f"✓ Success! Saved image: {saved_paths[0]}")
240
+ except Exception as e:
241
+ print(f"✗ Failed with model {model}: {str(e)}")
242
+
243
+ print("-" * 30)
244
+
245
+ print("All model tests completed!")
@@ -1,9 +1,9 @@
1
- """
2
- FreeAI Provider Package
3
- Provides access to various AI models for image generation including DALL-E 3 and Flux models
4
- """
5
-
6
- from .sync_freeaiplayground import FreeAIImager
7
- from .async_freeaiplayground import AsyncFreeAIImager
8
-
9
- __all__ = ['FreeAIImager', 'AsyncFreeAIImager']
1
+ """
2
+ FreeAI Provider Package
3
+ Provides access to various AI models for image generation including DALL-E 3 and Flux models
4
+ """
5
+
6
+ from .sync_freeaiplayground import FreeAIImager
7
+ from .async_freeaiplayground import AsyncFreeAIImager
8
+
9
+ __all__ = ['FreeAIImager', 'AsyncFreeAIImager']
@@ -1,206 +1,206 @@
1
- import aiohttp
2
- import asyncio
3
- import os
4
- from typing import List, Union, AsyncGenerator
5
- from string import punctuation
6
- from random import choice
7
- import aiofiles
8
-
9
- from webscout.AIbase import AsyncImageProvider
10
- from webscout.litagent import LitAgent # Import our fire user agent generator 🔥
11
- from webscout.Litlogger import Logger # For that cyberpunk logging swag ⚡
12
-
13
- # Initialize our fire logger 🚀
14
- logger = Logger("AsyncFreeAIPlayground")
15
-
16
- class AsyncFreeAIImager(AsyncImageProvider):
17
- """
18
- Async FreeAI Image Provider - Your go-to for fire AI art! 🎨
19
- """
20
-
21
- AVAILABLE_MODELS = [
22
- "dall-e-3",
23
- "Flux Pro Ultra",
24
- "Flux Pro",
25
- "Flux Pro Ultra Raw",
26
- "Flux Schnell",
27
- "Flux Realism",
28
- "grok-2-aurora"
29
- ]
30
-
31
- def __init__(
32
- self,
33
- model: str = "dall-e-3", # Updated default model
34
- timeout: int = 60,
35
- proxies: dict = {},
36
- logging: bool = True
37
- ):
38
- """Initialize your async FreeAIPlayground provider with custom settings! ⚙️
39
-
40
- Args:
41
- model (str): Which model to use (default: dall-e-3)
42
- timeout (int): Request timeout in seconds (default: 60)
43
- proxies (dict): Proxy settings for requests (default: {})
44
- logging (bool): Enable fire logging (default: True)
45
- """
46
- self.image_gen_endpoint: str = "https://api.freeaichatplayground.com/v1/images/generations"
47
- self.headers = {
48
- "Accept": "application/json",
49
- "Accept-Language": "en-US,en;q=0.9",
50
- "Content-Type": "application/json",
51
- "User-Agent": LitAgent().random(), # Using our fire random agent! 🔥
52
- "Origin": "https://freeaichatplayground.com",
53
- "Referer": "https://freeaichatplayground.com/",
54
- }
55
- self.timeout = aiohttp.ClientTimeout(total=timeout)
56
- self.model = model
57
- self.proxies = proxies
58
- self.prompt: str = "AI-generated image - webscout"
59
- self.image_extension: str = "png"
60
- self.logging = logging
61
- if self.logging:
62
- logger.info("AsyncFreeAIPlayground initialized! Ready to create some fire art! 🚀")
63
-
64
- async def generate(
65
- self, prompt: str, amount: int = 1, additives: bool = True,
66
- size: str = "1024x1024", quality: str = "standard",
67
- style: str = "vivid", max_retries: int = 3, retry_delay: int = 5
68
- ) -> List[bytes]:
69
- """Generate some fire images from your prompt! 🎨
70
-
71
- Args:
72
- prompt (str): Your creative prompt
73
- amount (int): How many images to generate
74
- additives (bool): Add random characters to make prompts unique
75
- size (str): Image size (1024x1024, 1024x1792, 1792x1024)
76
- quality (str): Image quality (standard, hd)
77
- style (str): Image style (vivid, natural)
78
- max_retries (int): Max retry attempts if generation fails
79
- retry_delay (int): Delay between retries in seconds
80
-
81
- Returns:
82
- List[bytes]: Your generated images as bytes
83
- """
84
- assert bool(prompt), "Prompt cannot be null"
85
- assert isinstance(amount, int), f"Amount should be an integer only not {type(amount)}"
86
- assert amount > 0, "Amount should be greater than 0"
87
-
88
- ads = lambda: (
89
- ""
90
- if not additives
91
- else choice(punctuation)
92
- + choice(punctuation)
93
- + choice(punctuation)
94
- )
95
-
96
- if self.logging:
97
- logger.info(f"Generating {amount} images... 🎨")
98
-
99
- self.prompt = prompt
100
- response = []
101
-
102
- async with aiohttp.ClientSession(headers=self.headers, timeout=self.timeout) as session:
103
- for i in range(amount):
104
- payload = {
105
- "model": self.model,
106
- "prompt": prompt + ads(),
107
- "n": 1,
108
- "size": size,
109
- "quality": quality,
110
- "style": style
111
- }
112
-
113
- for attempt in range(max_retries):
114
- try:
115
- async with session.post(self.image_gen_endpoint, json=payload) as resp:
116
- resp.raise_for_status()
117
- data = await resp.json()
118
- image_url = data['data'][0]['url']
119
-
120
- # Get the image data from the URL
121
- async with session.get(image_url) as img_resp:
122
- img_resp.raise_for_status()
123
- image_bytes = await img_resp.read()
124
- response.append(image_bytes)
125
-
126
- if self.logging:
127
- logger.success(f"Generated image {len(response)}/{amount}! 🎨")
128
- break
129
- except Exception as e:
130
- if attempt == max_retries - 1:
131
- if self.logging:
132
- logger.error(f"Failed to generate image after {max_retries} attempts: {e} 😢")
133
- raise
134
- if self.logging:
135
- logger.warning(f"Attempt {attempt + 1} failed, retrying in {retry_delay}s... 🔄")
136
- await asyncio.sleep(retry_delay)
137
-
138
- if self.logging:
139
- logger.success("All images generated successfully! 🎉")
140
- return response
141
-
142
- async def save(
143
- self,
144
- response: Union[List[bytes], AsyncGenerator[bytes, None]],
145
- name: str = None,
146
- dir: str = os.getcwd(),
147
- filenames_prefix: str = "",
148
- ) -> List[str]:
149
- """Save your fire images! 💾
150
-
151
- Args:
152
- response (Union[List[bytes], AsyncGenerator[bytes, None]]): Image data
153
- name (str, optional): Base name for saved files
154
- dir (str, optional): Where to save the images
155
- filenames_prefix (str, optional): Prefix for filenames
156
-
157
- Returns:
158
- List[str]: List of saved filenames
159
- """
160
- if not os.path.exists(dir):
161
- os.makedirs(dir)
162
- if self.logging:
163
- logger.info(f"Created directory: {dir} 📁")
164
-
165
- name = self.prompt if name is None else name
166
- saved_paths = []
167
-
168
- async def save_single_image(image_bytes: bytes, index: int) -> str:
169
- filename = f"{filenames_prefix}{name}_{index}.{self.image_extension}"
170
- filepath = os.path.join(dir, filename)
171
-
172
- async with aiofiles.open(filepath, "wb") as f:
173
- await f.write(image_bytes)
174
-
175
- if self.logging:
176
- logger.success(f"Saved image to: {filepath} 💾")
177
- return filename
178
-
179
- if isinstance(response, list):
180
- image_list = response
181
- else:
182
- image_list = [chunk async for chunk in response]
183
-
184
- if self.logging:
185
- logger.info(f"Saving {len(image_list)} images... 💾")
186
-
187
- tasks = [save_single_image(img, i) for i, img in enumerate(image_list)]
188
- saved_paths = await asyncio.gather(*tasks)
189
-
190
- if self.logging:
191
- logger.success(f"All images saved successfully! Check {dir} 🎉")
192
- return saved_paths
193
-
194
-
195
- if __name__ == "__main__":
196
- async def main():
197
- bot = AsyncFreeAIImager()
198
- try:
199
- resp = await bot.generate("A shiny red sports car speeding down a scenic mountain road", 1)
200
- paths = await bot.save(resp)
201
- print(paths)
202
- except Exception as e:
203
- if bot.logging:
204
- logger.error(f"An error occurred: {e} 😢")
205
-
206
- asyncio.run(main())
1
+ import aiohttp
2
+ import asyncio
3
+ import os
4
+ from typing import List, Union, AsyncGenerator
5
+ from string import punctuation
6
+ from random import choice
7
+ import aiofiles
8
+
9
+ from webscout.AIbase import AsyncImageProvider
10
+ from webscout.litagent import LitAgent # Import our fire user agent generator 🔥
11
+ from webscout.Litlogger import Logger # For that cyberpunk logging swag ⚡
12
+
13
+ # Initialize our fire logger 🚀
14
+ logger = Logger("AsyncFreeAIPlayground")
15
+
16
+ class AsyncFreeAIImager(AsyncImageProvider):
17
+ """
18
+ Async FreeAI Image Provider - Your go-to for fire AI art! 🎨
19
+ """
20
+
21
+ AVAILABLE_MODELS = [
22
+ "dall-e-3",
23
+ "Flux Pro Ultra",
24
+ "Flux Pro",
25
+ "Flux Pro Ultra Raw",
26
+ "Flux Schnell",
27
+ "Flux Realism",
28
+ "grok-2-aurora"
29
+ ]
30
+
31
+ def __init__(
32
+ self,
33
+ model: str = "dall-e-3", # Updated default model
34
+ timeout: int = 60,
35
+ proxies: dict = {},
36
+ logging: bool = True
37
+ ):
38
+ """Initialize your async FreeAIPlayground provider with custom settings! ⚙️
39
+
40
+ Args:
41
+ model (str): Which model to use (default: dall-e-3)
42
+ timeout (int): Request timeout in seconds (default: 60)
43
+ proxies (dict): Proxy settings for requests (default: {})
44
+ logging (bool): Enable fire logging (default: True)
45
+ """
46
+ self.image_gen_endpoint: str = "https://api.freeaichatplayground.com/v1/images/generations"
47
+ self.headers = {
48
+ "Accept": "application/json",
49
+ "Accept-Language": "en-US,en;q=0.9",
50
+ "Content-Type": "application/json",
51
+ "User-Agent": LitAgent().random(), # Using our fire random agent! 🔥
52
+ "Origin": "https://freeaichatplayground.com",
53
+ "Referer": "https://freeaichatplayground.com/",
54
+ }
55
+ self.timeout = aiohttp.ClientTimeout(total=timeout)
56
+ self.model = model
57
+ self.proxies = proxies
58
+ self.prompt: str = "AI-generated image - webscout"
59
+ self.image_extension: str = "png"
60
+ self.logging = logging
61
+ if self.logging:
62
+ logger.info("AsyncFreeAIPlayground initialized! Ready to create some fire art! 🚀")
63
+
64
+ async def generate(
65
+ self, prompt: str, amount: int = 1, additives: bool = True,
66
+ size: str = "1024x1024", quality: str = "standard",
67
+ style: str = "vivid", max_retries: int = 3, retry_delay: int = 5
68
+ ) -> List[bytes]:
69
+ """Generate some fire images from your prompt! 🎨
70
+
71
+ Args:
72
+ prompt (str): Your creative prompt
73
+ amount (int): How many images to generate
74
+ additives (bool): Add random characters to make prompts unique
75
+ size (str): Image size (1024x1024, 1024x1792, 1792x1024)
76
+ quality (str): Image quality (standard, hd)
77
+ style (str): Image style (vivid, natural)
78
+ max_retries (int): Max retry attempts if generation fails
79
+ retry_delay (int): Delay between retries in seconds
80
+
81
+ Returns:
82
+ List[bytes]: Your generated images as bytes
83
+ """
84
+ assert bool(prompt), "Prompt cannot be null"
85
+ assert isinstance(amount, int), f"Amount should be an integer only not {type(amount)}"
86
+ assert amount > 0, "Amount should be greater than 0"
87
+
88
+ ads = lambda: (
89
+ ""
90
+ if not additives
91
+ else choice(punctuation)
92
+ + choice(punctuation)
93
+ + choice(punctuation)
94
+ )
95
+
96
+ if self.logging:
97
+ logger.info(f"Generating {amount} images... 🎨")
98
+
99
+ self.prompt = prompt
100
+ response = []
101
+
102
+ async with aiohttp.ClientSession(headers=self.headers, timeout=self.timeout) as session:
103
+ for i in range(amount):
104
+ payload = {
105
+ "model": self.model,
106
+ "prompt": prompt + ads(),
107
+ "n": 1,
108
+ "size": size,
109
+ "quality": quality,
110
+ "style": style
111
+ }
112
+
113
+ for attempt in range(max_retries):
114
+ try:
115
+ async with session.post(self.image_gen_endpoint, json=payload) as resp:
116
+ resp.raise_for_status()
117
+ data = await resp.json()
118
+ image_url = data['data'][0]['url']
119
+
120
+ # Get the image data from the URL
121
+ async with session.get(image_url) as img_resp:
122
+ img_resp.raise_for_status()
123
+ image_bytes = await img_resp.read()
124
+ response.append(image_bytes)
125
+
126
+ if self.logging:
127
+ logger.success(f"Generated image {len(response)}/{amount}! 🎨")
128
+ break
129
+ except Exception as e:
130
+ if attempt == max_retries - 1:
131
+ if self.logging:
132
+ logger.error(f"Failed to generate image after {max_retries} attempts: {e} 😢")
133
+ raise
134
+ if self.logging:
135
+ logger.warning(f"Attempt {attempt + 1} failed, retrying in {retry_delay}s... 🔄")
136
+ await asyncio.sleep(retry_delay)
137
+
138
+ if self.logging:
139
+ logger.success("All images generated successfully! 🎉")
140
+ return response
141
+
142
+ async def save(
143
+ self,
144
+ response: Union[List[bytes], AsyncGenerator[bytes, None]],
145
+ name: str = None,
146
+ dir: str = os.getcwd(),
147
+ filenames_prefix: str = "",
148
+ ) -> List[str]:
149
+ """Save your fire images! 💾
150
+
151
+ Args:
152
+ response (Union[List[bytes], AsyncGenerator[bytes, None]]): Image data
153
+ name (str, optional): Base name for saved files
154
+ dir (str, optional): Where to save the images
155
+ filenames_prefix (str, optional): Prefix for filenames
156
+
157
+ Returns:
158
+ List[str]: List of saved filenames
159
+ """
160
+ if not os.path.exists(dir):
161
+ os.makedirs(dir)
162
+ if self.logging:
163
+ logger.info(f"Created directory: {dir} 📁")
164
+
165
+ name = self.prompt if name is None else name
166
+ saved_paths = []
167
+
168
+ async def save_single_image(image_bytes: bytes, index: int) -> str:
169
+ filename = f"{filenames_prefix}{name}_{index}.{self.image_extension}"
170
+ filepath = os.path.join(dir, filename)
171
+
172
+ async with aiofiles.open(filepath, "wb") as f:
173
+ await f.write(image_bytes)
174
+
175
+ if self.logging:
176
+ logger.success(f"Saved image to: {filepath} 💾")
177
+ return filename
178
+
179
+ if isinstance(response, list):
180
+ image_list = response
181
+ else:
182
+ image_list = [chunk async for chunk in response]
183
+
184
+ if self.logging:
185
+ logger.info(f"Saving {len(image_list)} images... 💾")
186
+
187
+ tasks = [save_single_image(img, i) for i, img in enumerate(image_list)]
188
+ saved_paths = await asyncio.gather(*tasks)
189
+
190
+ if self.logging:
191
+ logger.success(f"All images saved successfully! Check {dir} 🎉")
192
+ return saved_paths
193
+
194
+
195
+ if __name__ == "__main__":
196
+ async def main():
197
+ bot = AsyncFreeAIImager()
198
+ try:
199
+ resp = await bot.generate("A shiny red sports car speeding down a scenic mountain road", 1)
200
+ paths = await bot.save(resp)
201
+ print(paths)
202
+ except Exception as e:
203
+ if bot.logging:
204
+ logger.error(f"An error occurred: {e} 😢")
205
+
206
+ asyncio.run(main())