webscout 7.4__py3-none-any.whl → 7.5__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 (42) hide show
  1. webscout/Provider/C4ai.py +414 -0
  2. webscout/Provider/Cloudflare.py +18 -21
  3. webscout/Provider/DeepSeek.py +3 -32
  4. webscout/Provider/Deepinfra.py +30 -21
  5. webscout/Provider/GithubChat.py +362 -0
  6. webscout/Provider/HeckAI.py +20 -3
  7. webscout/Provider/HuggingFaceChat.py +462 -0
  8. webscout/Provider/Marcus.py +7 -50
  9. webscout/Provider/Netwrck.py +6 -53
  10. webscout/Provider/Phind.py +29 -3
  11. webscout/Provider/TTI/aiarta/__init__.py +2 -0
  12. webscout/Provider/TTI/aiarta/async_aiarta.py +482 -0
  13. webscout/Provider/TTI/aiarta/sync_aiarta.py +409 -0
  14. webscout/Provider/Venice.py +200 -200
  15. webscout/Provider/Youchat.py +1 -1
  16. webscout/Provider/__init__.py +13 -2
  17. webscout/Provider/akashgpt.py +8 -5
  18. webscout/Provider/copilot.py +416 -0
  19. webscout/Provider/flowith.py +181 -0
  20. webscout/Provider/granite.py +17 -53
  21. webscout/Provider/llamatutor.py +6 -46
  22. webscout/Provider/llmchat.py +7 -46
  23. webscout/Provider/multichat.py +29 -91
  24. webscout/exceptions.py +19 -9
  25. webscout/update_checker.py +55 -93
  26. webscout/version.py +1 -1
  27. webscout-7.5.dist-info/LICENSE.md +146 -0
  28. {webscout-7.4.dist-info → webscout-7.5.dist-info}/METADATA +5 -126
  29. {webscout-7.4.dist-info → webscout-7.5.dist-info}/RECORD +32 -33
  30. webscout/Local/__init__.py +0 -10
  31. webscout/Local/_version.py +0 -3
  32. webscout/Local/formats.py +0 -747
  33. webscout/Local/model.py +0 -1368
  34. webscout/Local/samplers.py +0 -125
  35. webscout/Local/thread.py +0 -539
  36. webscout/Local/ui.py +0 -401
  37. webscout/Local/utils.py +0 -388
  38. webscout/Provider/dgaf.py +0 -214
  39. webscout-7.4.dist-info/LICENSE.md +0 -211
  40. {webscout-7.4.dist-info → webscout-7.5.dist-info}/WHEEL +0 -0
  41. {webscout-7.4.dist-info → webscout-7.5.dist-info}/entry_points.txt +0 -0
  42. {webscout-7.4.dist-info → webscout-7.5.dist-info}/top_level.txt +0 -0
@@ -0,0 +1,409 @@
1
+ """AIArtaImager Synchronous Provider - Generate stunning AI art with AI Arta! 🎨
2
+
3
+ Examples:
4
+ >>> from webscout import AIArtaImager
5
+ >>> provider = AIArtaImager()
6
+ >>>
7
+ >>> # Generate a single image
8
+ >>> images = provider.generate("A cool cyberpunk city at night")
9
+ >>> paths = provider.save(images, dir="my_images")
10
+ >>>
11
+ >>> # Generate multiple images with different settings
12
+ >>> images = provider.generate(
13
+ ... prompt="Epic dragon breathing fire",
14
+ ... amount=2,
15
+ ... model="flux"
16
+ ... )
17
+ >>> provider.save(images, dir="dragon_pics")
18
+ """
19
+
20
+ import requests
21
+ import json
22
+ import os
23
+ import time
24
+ from pathlib import Path
25
+ from typing import List, Optional, Union, Dict, Any
26
+ from requests.exceptions import RequestException
27
+
28
+ from webscout.AIbase import ImageProvider
29
+ from webscout.litagent import LitAgent
30
+
31
+ agent = LitAgent()
32
+
33
+ class AIArtaImager(ImageProvider):
34
+ """Your go-to provider for generating fire images with AI Arta! 🎨
35
+
36
+ Examples:
37
+ >>> provider = AIArtaImager()
38
+ >>> # Generate one image
39
+ >>> image = provider.generate("A futuristic city")
40
+ >>> provider.save(image, "city.png")
41
+ >>>
42
+ >>> # Generate multiple images with specific model
43
+ >>> images = provider.generate(
44
+ ... prompt="Space station",
45
+ ... amount=3,
46
+ ... model="flux_black_ink"
47
+ ... )
48
+ >>> provider.save(images, dir="space_pics")
49
+ """
50
+
51
+ # API endpoints
52
+ url = "https://img-gen-prod.ai-arta.com"
53
+ auth_url = "https://www.googleapis.com/identitytoolkit/v3/relyingparty/signupNewUser?key=AIzaSyB3-71wG0fIt0shj0ee4fvx1shcjJHGrrQ"
54
+ token_refresh_url = "https://securetoken.googleapis.com/v1/token?key=AIzaSyB3-71wG0fIt0shj0ee4fvx1shcjJHGrrQ"
55
+ image_generation_url = "https://img-gen-prod.ai-arta.com/api/v1/text2image"
56
+ status_check_url = "https://img-gen-prod.ai-arta.com/api/v1/text2image/{record_id}/status"
57
+
58
+ # Available models
59
+ model_aliases = {
60
+ "flux": "Flux",
61
+ "medieval": "Medieval",
62
+ "vincent_van_gogh": "Vincent Van Gogh",
63
+ "f_dev": "F Dev",
64
+ "low_poly": "Low Poly",
65
+ "dreamshaper_xl": "Dreamshaper-xl",
66
+ "anima_pencil_xl": "Anima-pencil-xl",
67
+ "biomech": "Biomech",
68
+ "trash_polka": "Trash Polka",
69
+ "no_style": "No Style",
70
+ "cheyenne_xl": "Cheyenne-xl",
71
+ "chicano": "Chicano",
72
+ "embroidery_tattoo": "Embroidery tattoo",
73
+ "red_and_black": "Red and Black",
74
+ "fantasy_art": "Fantasy Art",
75
+ "watercolor": "Watercolor",
76
+ "dotwork": "Dotwork",
77
+ "old_school_colored": "Old school colored",
78
+ "realistic_tattoo": "Realistic tattoo",
79
+ "japanese_2": "Japanese_2",
80
+ "realistic_stock_xl": "Realistic-stock-xl",
81
+ "f_pro": "F Pro",
82
+ "revanimated": "RevAnimated",
83
+ "katayama_mix_xl": "Katayama-mix-xl",
84
+ "sdxl_l": "SDXL L",
85
+ "cor_epica_xl": "Cor-epica-xl",
86
+ "anime_tattoo": "Anime tattoo",
87
+ "new_school": "New School",
88
+ "death_metal": "Death metal",
89
+ "old_school": "Old School",
90
+ "juggernaut_xl": "Juggernaut-xl",
91
+ "photographic": "Photographic",
92
+ "sdxl_1_0": "SDXL 1.0",
93
+ "graffiti": "Graffiti",
94
+ "mini_tattoo": "Mini tattoo",
95
+ "surrealism": "Surrealism",
96
+ "neo_traditional": "Neo-traditional",
97
+ "on_limbs_black": "On limbs black",
98
+ "yamers_realistic_xl": "Yamers-realistic-xl",
99
+ "pony_xl": "Pony-xl",
100
+ "playground_xl": "Playground-xl",
101
+ "anything_xl": "Anything-xl",
102
+ "flame_design": "Flame design",
103
+ "kawaii": "Kawaii",
104
+ "cinematic_art": "Cinematic Art",
105
+ "professional": "Professional",
106
+ "flux_black_ink": "Flux Black Ink"
107
+ }
108
+ models = list(model_aliases.keys())
109
+
110
+ def __init__(self, timeout: int = 60, proxies: dict = None, logging: bool = True):
111
+ """Initialize your AIArtaImager provider with custom settings
112
+
113
+ Examples:
114
+ >>> provider = AIArtaImager(timeout=120)
115
+ >>> provider = AIArtaImager(proxies={"http": "http://proxy:8080"})
116
+
117
+ Args:
118
+ timeout (int): HTTP request timeout in seconds (default: 60)
119
+ proxies (dict, optional): Proxy configuration for requests
120
+ logging (bool): Enable/disable logging (default: True)
121
+ """
122
+ self.headers = {
123
+ "Accept": "application/json",
124
+ "Accept-Language": "en-US,en;q=0.5",
125
+ "User-Agent": agent.random()
126
+ }
127
+ self.session = requests.Session()
128
+ self.session.headers.update(self.headers)
129
+ if proxies:
130
+ self.session.proxies.update(proxies)
131
+ self.timeout = timeout
132
+ self.prompt: str = "AI-generated image - webscout"
133
+ self.image_extension: str = "png"
134
+
135
+
136
+ def get_auth_file(self) -> Path:
137
+ """Get path to authentication file"""
138
+ path = Path(os.path.join(os.path.expanduser("~"), ".ai_arta_cookies"))
139
+ path.mkdir(exist_ok=True)
140
+ filename = f"auth_{self.__class__.__name__}.json"
141
+ return path / filename
142
+
143
+ def create_token(self, path: Path) -> Dict[str, Any]:
144
+ """Create a new authentication token"""
145
+ # Step 1: Generate Authentication Token
146
+ auth_payload = {"clientType": "CLIENT_TYPE_ANDROID"}
147
+ proxies = self.session.proxies if self.session.proxies else None
148
+
149
+ auth_response = self.session.post(self.auth_url, json=auth_payload, timeout=self.timeout, proxies=proxies)
150
+ auth_data = auth_response.json()
151
+ auth_token = auth_data.get("idToken")
152
+
153
+ if not auth_token:
154
+
155
+ raise Exception("Failed to obtain authentication token.")
156
+
157
+ with open(path, 'w') as f:
158
+ json.dump(auth_data, f)
159
+
160
+ return auth_data
161
+
162
+ def refresh_token(self, refresh_token: str) -> tuple[str, str]:
163
+ """Refresh authentication token"""
164
+ payload = {
165
+ "grant_type": "refresh_token",
166
+ "refresh_token": refresh_token,
167
+ }
168
+
169
+ response = self.session.post(self.token_refresh_url, data=payload, timeout=self.timeout)
170
+ response_data = response.json()
171
+
172
+ return response_data.get("id_token"), response_data.get("refresh_token")
173
+
174
+ def read_and_refresh_token(self) -> Dict[str, Any]:
175
+ """Read token from file and refresh if needed"""
176
+ path = self.get_auth_file()
177
+
178
+ if path.is_file():
179
+ with open(path, 'r') as f:
180
+ auth_data = json.load(f)
181
+
182
+ diff = time.time() - os.path.getmtime(path)
183
+ expires_in = int(auth_data.get("expiresIn"))
184
+
185
+ if diff < expires_in:
186
+ if diff > expires_in / 2:
187
+ auth_data["idToken"], auth_data["refreshToken"] = self.refresh_token(
188
+ auth_data.get("refreshToken")
189
+ )
190
+ with open(path, 'w') as f:
191
+ json.dump(auth_data, f)
192
+ return auth_data
193
+
194
+ # Create new token if file doesn't exist or token expired
195
+ return self.create_token(path)
196
+
197
+ def get_model(self, model_name: str) -> str:
198
+ """Get actual model name from alias"""
199
+ if model_name.lower() in self.model_aliases:
200
+ return self.model_aliases[model_name.lower()]
201
+ return model_name
202
+
203
+ def generate(
204
+ self,
205
+ prompt: str,
206
+ amount: int = 1,
207
+ model: str = "Flux",
208
+ negative_prompt: str = "blurry, deformed hands, ugly",
209
+ guidance_scale: int = 7,
210
+ num_inference_steps: int = 30,
211
+ aspect_ratio: str = "1:1",
212
+ max_retries: int = 3,
213
+ retry_delay: int = 5,
214
+ **kwargs
215
+ ) -> List[bytes]:
216
+ """Generate some fire images from your prompt! 🎨
217
+
218
+ Examples:
219
+ >>> provider = AIArtaImager()
220
+ >>> # Basic usage
221
+ >>> images = provider.generate("Cool art")
222
+ >>> # Advanced usage
223
+ >>> images = provider.generate(
224
+ ... prompt="Epic dragon",
225
+ ... amount=2,
226
+ ... model="fantasy_art",
227
+ ... negative_prompt="ugly, deformed"
228
+ ... )
229
+
230
+ Args:
231
+ prompt (str): Your image description
232
+ amount (int): How many images you want (default: 1)
233
+ model (str): Model to use - check model_aliases (default: "flux")
234
+ negative_prompt (str): What you don't want in the image
235
+ guidance_scale (int): Controls how closely the model follows your prompt
236
+ num_inference_steps (int): More steps = better quality but slower
237
+ aspect_ratio (str): Image aspect ratio (default: "1:1")
238
+ max_retries (int): Max retry attempts if something fails
239
+ retry_delay (int): Seconds to wait between retries
240
+ **kwargs: Additional parameters for future compatibility
241
+
242
+ Returns:
243
+ List[bytes]: Your generated images
244
+
245
+ Raises:
246
+ ValueError: If the inputs ain't valid
247
+ RequestException: If the API calls fail after retries
248
+ """
249
+ if not prompt:
250
+ raise ValueError("Yo fam, the prompt can't be empty! 🤔")
251
+ if not isinstance(amount, int) or amount < 1:
252
+ raise ValueError("Amount needs to be a positive number! 📈")
253
+
254
+ model_name = self.get_model(model)
255
+ self.prompt = prompt
256
+ response = []
257
+
258
+ # Step 1: Get Authentication Token
259
+ auth_data = self.read_and_refresh_token()
260
+
261
+ # Headers for generation requests
262
+ gen_headers = {
263
+ "Authorization": auth_data.get("idToken"),
264
+ }
265
+
266
+ for i in range(amount):
267
+ # Step 2: Generate Image
268
+ image_payload = {
269
+ "prompt": prompt,
270
+ "negative_prompt": negative_prompt,
271
+ "style": model_name,
272
+ "images_num": "1", # Generate 1 at a time
273
+ "cfg_scale": str(guidance_scale),
274
+ "steps": str(num_inference_steps),
275
+ "aspect_ratio": aspect_ratio,
276
+ }
277
+
278
+ for attempt in range(max_retries):
279
+ try:
280
+
281
+ # Submit generation request
282
+ image_response = self.session.post(
283
+ self.image_generation_url,
284
+ data=image_payload,
285
+ headers=gen_headers,
286
+ timeout=self.timeout
287
+ )
288
+ image_response.raise_for_status()
289
+ image_data = image_response.json()
290
+ record_id = image_data.get("record_id")
291
+
292
+ if not record_id:
293
+ raise RequestException(f"Failed to initiate image generation: {image_data}")
294
+
295
+ # Step 3: Check Generation Status
296
+ status_url = self.status_check_url.format(record_id=record_id)
297
+
298
+ counter = 0
299
+ dots = [".", "..", "...", "...."]
300
+
301
+ while True:
302
+ status_response = self.session.get(
303
+ status_url,
304
+ headers=gen_headers,
305
+ timeout=self.timeout
306
+ )
307
+ status_data = status_response.json()
308
+ status = status_data.get("status")
309
+
310
+ if status == "DONE":
311
+ image_urls = [image["url"] for image in status_data.get("response", [])]
312
+
313
+ if not image_urls:
314
+ raise RequestException("No image URLs in response")
315
+
316
+ # Download the generated image
317
+ image_response = self.session.get(image_urls[0], timeout=self.timeout)
318
+ image_response.raise_for_status()
319
+ response.append(image_response.content)
320
+ break
321
+
322
+ elif status in ("IN_QUEUE", "IN_PROGRESS"):
323
+ # status_text = "Waiting" if status == "IN_QUEUE" else "Generating"
324
+ time.sleep(3)
325
+ counter += 1
326
+
327
+ else:
328
+ raise RequestException(f"Image generation failed with status: {status}")
329
+
330
+ # If we got here, we successfully generated an image
331
+ break
332
+
333
+ except RequestException as e:
334
+ if attempt == max_retries - 1:
335
+ raise
336
+ else:
337
+ time.sleep(retry_delay)
338
+
339
+ return response
340
+
341
+ def save(
342
+ self,
343
+ response: List[bytes],
344
+ name: Optional[str] = None,
345
+ dir: Optional[Union[str, Path]] = None,
346
+ filenames_prefix: str = "",
347
+ ) -> List[str]:
348
+ """Save your fire generated images! 💾
349
+
350
+ Examples:
351
+ >>> provider = AIArtaImager()
352
+ >>> images = provider.generate("Cool art")
353
+ >>> # Save with default settings
354
+ >>> paths = provider.save(images)
355
+ >>> # Save with custom name and directory
356
+ >>> paths = provider.save(
357
+ ... images,
358
+ ... name="my_art",
359
+ ... dir="my_images",
360
+ ... filenames_prefix="test_"
361
+ ... )
362
+
363
+ Args:
364
+ response (List[bytes]): Your generated images
365
+ name (Optional[str]): Custom name for your images
366
+ dir (Optional[Union[str, Path]]): Where to save the images (default: current directory)
367
+ filenames_prefix (str): Prefix for your image files
368
+
369
+ Returns:
370
+ List[str]: Paths to your saved images
371
+ """
372
+ save_dir = dir if dir else os.getcwd()
373
+ if not os.path.exists(save_dir):
374
+ os.makedirs(save_dir)
375
+
376
+ name = self.prompt if name is None else name
377
+
378
+ # Clean up name for filename use
379
+ safe_name = "".join(c if c.isalnum() or c in "_-" else "_" for c in name)
380
+ safe_name = safe_name[:50] # Truncate if too long
381
+
382
+ filenames = []
383
+ count = 0
384
+
385
+ for image in response:
386
+ def complete_path():
387
+ count_value = "" if count == 0 else f"_{count}"
388
+ return os.path.join(save_dir, filenames_prefix + safe_name + count_value + "." + self.image_extension)
389
+
390
+ while os.path.isfile(complete_path()):
391
+ count += 1
392
+
393
+ filepath = complete_path()
394
+ filenames.append(os.path.basename(filepath))
395
+
396
+ with open(filepath, "wb") as fh:
397
+ fh.write(image)
398
+ return filenames
399
+
400
+
401
+ if __name__ == "__main__":
402
+ # Example usage
403
+ provider = AIArtaImager()
404
+ try:
405
+ images = provider.generate("A beautiful sunset over mountains", amount=1)
406
+ paths = provider.save(images, dir="generated_images")
407
+ print(f"Images saved to: {paths}")
408
+ except Exception as e:
409
+ print(f"An error occurred: {e}")