webscout 8.3.7__py3-none-any.whl → 2025.10.11__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 (273) hide show
  1. webscout/AIauto.py +250 -250
  2. webscout/AIbase.py +379 -379
  3. webscout/AIutel.py +60 -60
  4. webscout/Bard.py +1012 -1012
  5. webscout/Bing_search.py +417 -417
  6. webscout/DWEBS.py +529 -529
  7. webscout/Extra/Act.md +309 -309
  8. webscout/Extra/GitToolkit/__init__.py +10 -10
  9. webscout/Extra/GitToolkit/gitapi/README.md +110 -110
  10. webscout/Extra/GitToolkit/gitapi/__init__.py +11 -11
  11. webscout/Extra/GitToolkit/gitapi/repository.py +195 -195
  12. webscout/Extra/GitToolkit/gitapi/user.py +96 -96
  13. webscout/Extra/GitToolkit/gitapi/utils.py +61 -61
  14. webscout/Extra/YTToolkit/README.md +375 -375
  15. webscout/Extra/YTToolkit/YTdownloader.py +956 -956
  16. webscout/Extra/YTToolkit/__init__.py +2 -2
  17. webscout/Extra/YTToolkit/transcriber.py +475 -475
  18. webscout/Extra/YTToolkit/ytapi/README.md +44 -44
  19. webscout/Extra/YTToolkit/ytapi/__init__.py +6 -6
  20. webscout/Extra/YTToolkit/ytapi/channel.py +307 -307
  21. webscout/Extra/YTToolkit/ytapi/errors.py +13 -13
  22. webscout/Extra/YTToolkit/ytapi/extras.py +118 -118
  23. webscout/Extra/YTToolkit/ytapi/https.py +88 -88
  24. webscout/Extra/YTToolkit/ytapi/patterns.py +61 -61
  25. webscout/Extra/YTToolkit/ytapi/playlist.py +58 -58
  26. webscout/Extra/YTToolkit/ytapi/pool.py +7 -7
  27. webscout/Extra/YTToolkit/ytapi/query.py +39 -39
  28. webscout/Extra/YTToolkit/ytapi/stream.py +62 -62
  29. webscout/Extra/YTToolkit/ytapi/utils.py +62 -62
  30. webscout/Extra/YTToolkit/ytapi/video.py +232 -232
  31. webscout/Extra/autocoder/__init__.py +9 -9
  32. webscout/Extra/autocoder/autocoder.py +1105 -1105
  33. webscout/Extra/autocoder/autocoder_utiles.py +332 -332
  34. webscout/Extra/gguf.md +429 -429
  35. webscout/Extra/gguf.py +1213 -1213
  36. webscout/Extra/tempmail/README.md +487 -487
  37. webscout/Extra/tempmail/__init__.py +27 -27
  38. webscout/Extra/tempmail/async_utils.py +140 -140
  39. webscout/Extra/tempmail/base.py +160 -160
  40. webscout/Extra/tempmail/cli.py +186 -186
  41. webscout/Extra/tempmail/emailnator.py +84 -84
  42. webscout/Extra/tempmail/mail_tm.py +360 -360
  43. webscout/Extra/tempmail/temp_mail_io.py +291 -291
  44. webscout/Extra/weather.md +281 -281
  45. webscout/Extra/weather.py +193 -193
  46. webscout/Litlogger/README.md +10 -10
  47. webscout/Litlogger/__init__.py +15 -15
  48. webscout/Litlogger/formats.py +13 -13
  49. webscout/Litlogger/handlers.py +121 -121
  50. webscout/Litlogger/levels.py +13 -13
  51. webscout/Litlogger/logger.py +134 -134
  52. webscout/Provider/AISEARCH/Perplexity.py +332 -332
  53. webscout/Provider/AISEARCH/README.md +279 -279
  54. webscout/Provider/AISEARCH/__init__.py +16 -1
  55. webscout/Provider/AISEARCH/felo_search.py +206 -206
  56. webscout/Provider/AISEARCH/genspark_search.py +323 -323
  57. webscout/Provider/AISEARCH/hika_search.py +185 -185
  58. webscout/Provider/AISEARCH/iask_search.py +410 -410
  59. webscout/Provider/AISEARCH/monica_search.py +219 -219
  60. webscout/Provider/AISEARCH/scira_search.py +316 -316
  61. webscout/Provider/AISEARCH/stellar_search.py +177 -177
  62. webscout/Provider/AISEARCH/webpilotai_search.py +255 -255
  63. webscout/Provider/Aitopia.py +314 -314
  64. webscout/Provider/Apriel.py +306 -0
  65. webscout/Provider/ChatGPTClone.py +236 -236
  66. webscout/Provider/ChatSandbox.py +343 -343
  67. webscout/Provider/Cloudflare.py +324 -324
  68. webscout/Provider/Cohere.py +208 -208
  69. webscout/Provider/Deepinfra.py +370 -366
  70. webscout/Provider/ExaAI.py +260 -260
  71. webscout/Provider/ExaChat.py +308 -308
  72. webscout/Provider/Flowith.py +221 -221
  73. webscout/Provider/GMI.py +293 -0
  74. webscout/Provider/Gemini.py +164 -164
  75. webscout/Provider/GeminiProxy.py +167 -167
  76. webscout/Provider/GithubChat.py +371 -372
  77. webscout/Provider/Groq.py +800 -800
  78. webscout/Provider/HeckAI.py +383 -383
  79. webscout/Provider/Jadve.py +282 -282
  80. webscout/Provider/K2Think.py +307 -307
  81. webscout/Provider/Koboldai.py +205 -205
  82. webscout/Provider/LambdaChat.py +423 -423
  83. webscout/Provider/Nemotron.py +244 -244
  84. webscout/Provider/Netwrck.py +248 -248
  85. webscout/Provider/OLLAMA.py +395 -395
  86. webscout/Provider/OPENAI/Cloudflare.py +393 -393
  87. webscout/Provider/OPENAI/FalconH1.py +451 -451
  88. webscout/Provider/OPENAI/FreeGemini.py +296 -296
  89. webscout/Provider/OPENAI/K2Think.py +431 -431
  90. webscout/Provider/OPENAI/NEMOTRON.py +240 -240
  91. webscout/Provider/OPENAI/PI.py +427 -427
  92. webscout/Provider/OPENAI/README.md +959 -959
  93. webscout/Provider/OPENAI/TogetherAI.py +345 -345
  94. webscout/Provider/OPENAI/TwoAI.py +465 -465
  95. webscout/Provider/OPENAI/__init__.py +33 -18
  96. webscout/Provider/OPENAI/base.py +248 -248
  97. webscout/Provider/OPENAI/chatglm.py +528 -0
  98. webscout/Provider/OPENAI/chatgpt.py +592 -592
  99. webscout/Provider/OPENAI/chatgptclone.py +521 -521
  100. webscout/Provider/OPENAI/chatsandbox.py +202 -202
  101. webscout/Provider/OPENAI/deepinfra.py +318 -314
  102. webscout/Provider/OPENAI/e2b.py +1665 -1665
  103. webscout/Provider/OPENAI/exaai.py +420 -420
  104. webscout/Provider/OPENAI/exachat.py +452 -452
  105. webscout/Provider/OPENAI/friendli.py +232 -232
  106. webscout/Provider/OPENAI/{refact.py → gmi.py} +324 -274
  107. webscout/Provider/OPENAI/groq.py +364 -364
  108. webscout/Provider/OPENAI/heckai.py +314 -314
  109. webscout/Provider/OPENAI/llmchatco.py +337 -337
  110. webscout/Provider/OPENAI/netwrck.py +355 -355
  111. webscout/Provider/OPENAI/oivscode.py +290 -290
  112. webscout/Provider/OPENAI/opkfc.py +518 -518
  113. webscout/Provider/OPENAI/pydantic_imports.py +1 -1
  114. webscout/Provider/OPENAI/scirachat.py +535 -535
  115. webscout/Provider/OPENAI/sonus.py +308 -308
  116. webscout/Provider/OPENAI/standardinput.py +442 -442
  117. webscout/Provider/OPENAI/textpollinations.py +340 -340
  118. webscout/Provider/OPENAI/toolbaz.py +419 -416
  119. webscout/Provider/OPENAI/typefully.py +362 -362
  120. webscout/Provider/OPENAI/utils.py +295 -295
  121. webscout/Provider/OPENAI/venice.py +436 -436
  122. webscout/Provider/OPENAI/wisecat.py +387 -387
  123. webscout/Provider/OPENAI/writecream.py +166 -166
  124. webscout/Provider/OPENAI/x0gpt.py +378 -378
  125. webscout/Provider/OPENAI/yep.py +389 -389
  126. webscout/Provider/OpenGPT.py +230 -230
  127. webscout/Provider/Openai.py +243 -243
  128. webscout/Provider/PI.py +405 -405
  129. webscout/Provider/Perplexitylabs.py +430 -430
  130. webscout/Provider/QwenLM.py +272 -272
  131. webscout/Provider/STT/__init__.py +16 -1
  132. webscout/Provider/Sambanova.py +257 -257
  133. webscout/Provider/StandardInput.py +309 -309
  134. webscout/Provider/TTI/README.md +82 -82
  135. webscout/Provider/TTI/__init__.py +33 -18
  136. webscout/Provider/TTI/aiarta.py +413 -413
  137. webscout/Provider/TTI/base.py +136 -136
  138. webscout/Provider/TTI/bing.py +243 -243
  139. webscout/Provider/TTI/gpt1image.py +149 -149
  140. webscout/Provider/TTI/imagen.py +196 -196
  141. webscout/Provider/TTI/infip.py +211 -211
  142. webscout/Provider/TTI/magicstudio.py +232 -232
  143. webscout/Provider/TTI/monochat.py +219 -219
  144. webscout/Provider/TTI/piclumen.py +214 -214
  145. webscout/Provider/TTI/pixelmuse.py +232 -232
  146. webscout/Provider/TTI/pollinations.py +232 -232
  147. webscout/Provider/TTI/together.py +288 -288
  148. webscout/Provider/TTI/utils.py +12 -12
  149. webscout/Provider/TTI/venice.py +367 -367
  150. webscout/Provider/TTS/README.md +192 -192
  151. webscout/Provider/TTS/__init__.py +33 -18
  152. webscout/Provider/TTS/parler.py +110 -110
  153. webscout/Provider/TTS/streamElements.py +333 -333
  154. webscout/Provider/TTS/utils.py +280 -280
  155. webscout/Provider/TeachAnything.py +237 -237
  156. webscout/Provider/TextPollinationsAI.py +310 -310
  157. webscout/Provider/TogetherAI.py +356 -356
  158. webscout/Provider/TwoAI.py +312 -312
  159. webscout/Provider/TypliAI.py +311 -311
  160. webscout/Provider/UNFINISHED/ChatHub.py +208 -208
  161. webscout/Provider/UNFINISHED/ChutesAI.py +313 -313
  162. webscout/Provider/UNFINISHED/GizAI.py +294 -294
  163. webscout/Provider/UNFINISHED/Marcus.py +198 -198
  164. webscout/Provider/UNFINISHED/Qodo.py +477 -477
  165. webscout/Provider/UNFINISHED/VercelAIGateway.py +338 -338
  166. webscout/Provider/UNFINISHED/XenAI.py +324 -324
  167. webscout/Provider/UNFINISHED/Youchat.py +330 -330
  168. webscout/Provider/UNFINISHED/liner.py +334 -0
  169. webscout/Provider/UNFINISHED/liner_api_request.py +262 -262
  170. webscout/Provider/UNFINISHED/puterjs.py +634 -634
  171. webscout/Provider/UNFINISHED/samurai.py +223 -223
  172. webscout/Provider/UNFINISHED/test_lmarena.py +119 -119
  173. webscout/Provider/Venice.py +250 -250
  174. webscout/Provider/VercelAI.py +256 -256
  175. webscout/Provider/WiseCat.py +231 -231
  176. webscout/Provider/WrDoChat.py +366 -366
  177. webscout/Provider/__init__.py +33 -18
  178. webscout/Provider/ai4chat.py +174 -174
  179. webscout/Provider/akashgpt.py +331 -331
  180. webscout/Provider/cerebras.py +446 -446
  181. webscout/Provider/chatglm.py +394 -301
  182. webscout/Provider/cleeai.py +211 -211
  183. webscout/Provider/elmo.py +282 -282
  184. webscout/Provider/geminiapi.py +208 -208
  185. webscout/Provider/granite.py +261 -261
  186. webscout/Provider/hermes.py +263 -263
  187. webscout/Provider/julius.py +223 -223
  188. webscout/Provider/learnfastai.py +309 -309
  189. webscout/Provider/llama3mitril.py +214 -214
  190. webscout/Provider/llmchat.py +243 -243
  191. webscout/Provider/llmchatco.py +290 -290
  192. webscout/Provider/meta.py +801 -801
  193. webscout/Provider/oivscode.py +309 -309
  194. webscout/Provider/scira_chat.py +383 -383
  195. webscout/Provider/searchchat.py +292 -292
  196. webscout/Provider/sonus.py +258 -258
  197. webscout/Provider/toolbaz.py +370 -367
  198. webscout/Provider/turboseek.py +273 -273
  199. webscout/Provider/typefully.py +207 -207
  200. webscout/Provider/yep.py +372 -372
  201. webscout/__init__.py +30 -31
  202. webscout/__main__.py +5 -5
  203. webscout/auth/api_key_manager.py +189 -189
  204. webscout/auth/config.py +175 -175
  205. webscout/auth/models.py +185 -185
  206. webscout/auth/routes.py +664 -664
  207. webscout/auth/simple_logger.py +236 -236
  208. webscout/cli.py +523 -523
  209. webscout/conversation.py +438 -438
  210. webscout/exceptions.py +361 -361
  211. webscout/litagent/Readme.md +298 -298
  212. webscout/litagent/__init__.py +28 -28
  213. webscout/litagent/agent.py +581 -581
  214. webscout/litagent/constants.py +59 -59
  215. webscout/litprinter/__init__.py +58 -58
  216. webscout/models.py +181 -181
  217. webscout/optimizers.py +419 -419
  218. webscout/prompt_manager.py +288 -288
  219. webscout/sanitize.py +1078 -1078
  220. webscout/scout/README.md +401 -401
  221. webscout/scout/__init__.py +8 -8
  222. webscout/scout/core/__init__.py +6 -6
  223. webscout/scout/core/crawler.py +297 -297
  224. webscout/scout/core/scout.py +706 -706
  225. webscout/scout/core/search_result.py +95 -95
  226. webscout/scout/core/text_analyzer.py +62 -62
  227. webscout/scout/core/text_utils.py +277 -277
  228. webscout/scout/core/web_analyzer.py +51 -51
  229. webscout/scout/element.py +599 -599
  230. webscout/scout/parsers/__init__.py +69 -69
  231. webscout/scout/parsers/html5lib_parser.py +172 -172
  232. webscout/scout/parsers/html_parser.py +236 -236
  233. webscout/scout/parsers/lxml_parser.py +178 -178
  234. webscout/scout/utils.py +37 -37
  235. webscout/swiftcli/Readme.md +323 -323
  236. webscout/swiftcli/__init__.py +95 -95
  237. webscout/swiftcli/core/__init__.py +7 -7
  238. webscout/swiftcli/core/cli.py +308 -308
  239. webscout/swiftcli/core/context.py +104 -104
  240. webscout/swiftcli/core/group.py +241 -241
  241. webscout/swiftcli/decorators/__init__.py +28 -28
  242. webscout/swiftcli/decorators/command.py +221 -221
  243. webscout/swiftcli/decorators/options.py +220 -220
  244. webscout/swiftcli/decorators/output.py +302 -302
  245. webscout/swiftcli/exceptions.py +21 -21
  246. webscout/swiftcli/plugins/__init__.py +9 -9
  247. webscout/swiftcli/plugins/base.py +135 -135
  248. webscout/swiftcli/plugins/manager.py +269 -269
  249. webscout/swiftcli/utils/__init__.py +59 -59
  250. webscout/swiftcli/utils/formatting.py +252 -252
  251. webscout/swiftcli/utils/parsing.py +267 -267
  252. webscout/update_checker.py +117 -117
  253. webscout/version.py +1 -1
  254. webscout/webscout_search.py +1183 -1183
  255. webscout/webscout_search_async.py +649 -649
  256. webscout/yep_search.py +346 -346
  257. webscout/zeroart/README.md +89 -89
  258. webscout/zeroart/__init__.py +134 -134
  259. webscout/zeroart/base.py +66 -66
  260. webscout/zeroart/effects.py +100 -100
  261. webscout/zeroart/fonts.py +1238 -1238
  262. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/METADATA +937 -937
  263. webscout-2025.10.11.dist-info/RECORD +300 -0
  264. webscout/Provider/AISEARCH/DeepFind.py +0 -254
  265. webscout/Provider/OPENAI/Qwen3.py +0 -303
  266. webscout/Provider/OPENAI/qodo.py +0 -630
  267. webscout/Provider/OPENAI/xenai.py +0 -514
  268. webscout/tempid.py +0 -134
  269. webscout-8.3.7.dist-info/RECORD +0 -301
  270. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/WHEEL +0 -0
  271. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/entry_points.txt +0 -0
  272. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/licenses/LICENSE.md +0 -0
  273. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/top_level.txt +0 -0
@@ -1,372 +1,371 @@
1
- from curl_cffi import CurlError
2
- from curl_cffi.requests import Session
3
- import json
4
- import time
5
- from typing import Any, Dict, List, Optional, Union, Generator
6
-
7
- from flask import request
8
-
9
- from webscout.AIutel import Conversation
10
- from webscout.AIutel import Optimizers
11
- from webscout.AIutel import AwesomePrompts, sanitize_stream # Import sanitize_stream
12
- from webscout.AIbase import Provider
13
- from webscout import exceptions
14
- from webscout.litagent import LitAgent
15
-
16
- class GithubChat(Provider):
17
- """
18
- A class to interact with the GitHub Copilot Chat API.
19
- Uses cookies for authentication and supports streaming responses.
20
- """
21
- required_auth = True
22
- # Available models
23
- AVAILABLE_MODELS = [
24
- "gpt-4o",
25
- "gpt-5",
26
- "o3-mini",
27
- "o1",
28
- "claude-3.5-sonnet",
29
- "claude-3.7-sonnet",
30
- "claude-3.7-sonnet-thought",
31
- "claude-sonnet-4",
32
- "gemini-2.0-flash-001",
33
- "gemini-2.5-pro",
34
- "gpt-4.1",
35
- "o4-mini"
36
-
37
- ]
38
-
39
- def __init__(
40
- self,
41
- is_conversation: bool = True,
42
- max_tokens: int = 2000,
43
- timeout: int = 60,
44
- intro: str = None,
45
- filepath: str = None,
46
- update_file: bool = True,
47
- proxies: dict = {},
48
- history_offset: int = 10250,
49
- act: str = None,
50
- model: str = "gpt-4o",
51
- cookie_path: str = "cookies.json"
52
- ):
53
- """Initialize the GithubChat client."""
54
- if model not in self.AVAILABLE_MODELS:
55
- raise ValueError(f"Invalid model: {model}. Choose from: {', '.join(self.AVAILABLE_MODELS)}")
56
-
57
- self.url = "https://github.com/copilot"
58
- self.api_url = "https://api.individual.githubcopilot.com"
59
- self.cookie_path = cookie_path
60
- self.session = Session() # Use curl_cffi Session
61
- self.session.proxies.update(proxies)
62
-
63
- # Load cookies for authentication
64
- self.cookies = self.load_cookies()
65
-
66
- # Set up headers for all requests
67
- self.headers = {
68
- "Content-Type": "application/json",
69
- "User-Agent": LitAgent().random(),
70
- "Accept": "*/*",
71
- "Accept-Encoding": "gzip, deflate, br",
72
- "Accept-Language": "en-US,en;q=0.5",
73
- "Origin": "https://github.com",
74
- "Referer": "https://github.com/copilot",
75
- "GitHub-Verified-Fetch": "true",
76
- "X-Requested-With": "XMLHttpRequest",
77
- "Connection": "keep-alive",
78
- "Sec-Fetch-Dest": "empty",
79
- "Sec-Fetch-Mode": "cors",
80
- "Sec-Fetch-Site": "same-origin",
81
- }
82
-
83
- # Apply cookies to session
84
- if self.cookies:
85
- self.session.cookies.update(self.cookies)
86
-
87
- # Set default model
88
- self.model = model
89
-
90
- # Provider settings
91
- self.is_conversation = is_conversation
92
- self.max_tokens_to_sample = max_tokens
93
- self.timeout = timeout
94
- self.last_response = {}
95
-
96
- # Available optimizers
97
- self.__available_optimizers = (
98
- method
99
- for method in dir(Optimizers)
100
- if callable(getattr(Optimizers, method)) and not method.startswith("__")
101
- )
102
-
103
- # Set up conversation
104
- Conversation.intro = (
105
- AwesomePrompts().get_act(
106
- act, raise_not_found=True, default=None, case_insensitive=True
107
- )
108
- if act
109
- else intro or Conversation.intro
110
- )
111
-
112
- self.conversation = Conversation(
113
- is_conversation, self.max_tokens_to_sample, filepath, update_file
114
- )
115
- self.conversation.history_offset = history_offset
116
-
117
- # Store conversation data
118
- self._conversation_id = None
119
- self._access_token = None
120
-
121
- def load_cookies(self):
122
- """Load cookies from a JSON file"""
123
- try:
124
- with open(self.cookie_path, 'r') as f:
125
- cookies_data = json.load(f)
126
-
127
- # Convert the cookie list to a dictionary format for requests
128
- cookies = {}
129
- for cookie in cookies_data:
130
- # Only include cookies that are not expired and have a name and value
131
- if 'name' in cookie and 'value':
132
- # Check if the cookie hasn't expired
133
- if 'expirationDate' not in cookie or cookie['expirationDate'] > time.time():
134
- cookies[cookie['name']] = cookie['value']
135
-
136
- return cookies
137
- except Exception:
138
- return {}
139
-
140
- def get_access_token(self):
141
- """Get GitHub Copilot access token."""
142
- if self._access_token:
143
- return self._access_token
144
-
145
- url = "https://github.com/github-copilot/chat/token"
146
-
147
- try:
148
- response = self.session.post(url, headers=self.headers)
149
-
150
- if response.status_code == 401:
151
- raise exceptions.AuthenticationError("Authentication failed. Please check your cookies.")
152
-
153
- if response.status_code != 200:
154
- raise exceptions.FailedToGenerateResponseError(f"Failed to get access token: {response.status_code}")
155
-
156
- data = response.json()
157
- self._access_token = data.get("token")
158
-
159
- if not self._access_token:
160
- raise exceptions.FailedToGenerateResponseError("Failed to extract access token from response")
161
-
162
- return self._access_token
163
-
164
- except:
165
- pass
166
-
167
- @staticmethod
168
- def _github_extractor(chunk: Union[str, Dict[str, Any]]) -> Optional[str]:
169
- """Extracts content from GitHub Copilot stream JSON objects."""
170
- if isinstance(chunk, dict) and chunk.get("type") == "content":
171
- return chunk.get("body")
172
- return None
173
-
174
- def create_conversation(self):
175
- """Create a new conversation with GitHub Copilot."""
176
- if self._conversation_id:
177
- return self._conversation_id
178
-
179
- access_token = self.get_access_token()
180
- url = f"{self.api_url}/github/chat/threads"
181
-
182
- headers = self.headers.copy()
183
- headers["Authorization"] = f"GitHub-Bearer {access_token}"
184
-
185
- try:
186
- response = self.session.post(
187
- url, headers=headers,
188
- impersonate="chrome120" # Add impersonate
189
- )
190
-
191
- if response.status_code == 401:
192
- # Token might be expired, try refreshing
193
- self._access_token = None
194
- access_token = self.get_access_token()
195
- headers["Authorization"] = f"GitHub-Bearer {access_token}"
196
- response = self.session.post(url, headers=headers)
197
-
198
- # Check status after potential retry
199
- response.raise_for_status() # Raise HTTPError for bad responses (4xx or 5xx)
200
-
201
- if response.status_code not in [200, 201]:
202
- raise exceptions.FailedToGenerateResponseError(f"Failed to create conversation: {response.status_code}")
203
-
204
- data = response.json()
205
- self._conversation_id = data.get("thread_id")
206
-
207
- if not self._conversation_id:
208
- raise exceptions.FailedToGenerateResponseError("Failed to extract conversation ID from response")
209
-
210
- return self._conversation_id
211
- except (CurlError, exceptions.FailedToGenerateResponseError, Exception) as e: # Catch CurlError and others
212
- raise exceptions.FailedToGenerateResponseError(f"Failed to create conversation: {str(e)}")
213
-
214
- def ask(
215
- self,
216
- prompt: str,
217
- stream: bool = False,
218
- raw: bool = False,
219
- optimizer: str = None,
220
- conversationally: bool = False,
221
- ) -> Union[Dict[str, Any], Generator]:
222
- """Send a message to the GitHub Copilot Chat API"""
223
-
224
- # Apply optimizers if specified
225
- conversation_prompt = self.conversation.gen_complete_prompt(prompt)
226
- if optimizer:
227
- if optimizer in self.__available_optimizers:
228
- conversation_prompt = getattr(Optimizers, optimizer)(
229
- conversation_prompt if conversationally else prompt
230
- )
231
- else:
232
- raise Exception(f"Optimizer is not one of {self.__available_optimizers}")
233
-
234
- # Make sure we have a conversation ID
235
- try:
236
- conversation_id = self.create_conversation()
237
- except exceptions.FailedToGenerateResponseError as e:
238
- raise exceptions.FailedToGenerateResponseError(f"Failed to create conversation: {e}")
239
-
240
- access_token = self.get_access_token()
241
-
242
- url = f"{self.api_url}/github/chat/threads/{conversation_id}/messages"
243
-
244
- # Update headers for this specific request
245
- headers = self.headers.copy()
246
- headers["Authorization"] = f"GitHub-Bearer {access_token}"
247
-
248
- # Prepare the request payload
249
- request_data = {
250
- "content": conversation_prompt,
251
- "intent": "conversation",
252
- "references": [],
253
- "context": [],
254
- "currentURL": f"https://github.com/copilot/c/{conversation_id}",
255
- "streaming": True,
256
- "confirmations": [],
257
- "customInstructions": [],
258
- "model": self.model,
259
- "mode": "immersive"
260
- }
261
-
262
- streaming_text = "" # Initialize for history update
263
- def for_stream():
264
- nonlocal streaming_text # Allow modification of outer scope variable
265
- try:
266
- response = self.session.post(
267
- url,
268
- json=request_data,
269
- headers=headers, # Use updated headers with Authorization
270
- stream=True,
271
- timeout=self.timeout
272
- )
273
-
274
- if response.status_code == 401:
275
- # Token might be expired, try refreshing
276
- self._access_token = None
277
- access_token = self.get_access_token()
278
- headers["Authorization"] = f"GitHub-Bearer {access_token}"
279
- response = self.session.post(
280
- url,
281
- json=request_data, # Use original payload
282
- headers=headers,
283
- stream=True,
284
- timeout=self.timeout
285
- )
286
-
287
- # If still not successful, raise exception
288
- response.raise_for_status() # Raise HTTPError for bad responses (4xx or 5xx)
289
-
290
- # Process the streaming response
291
- # Use sanitize_stream
292
- processed_stream = sanitize_stream(
293
- data=response.iter_content(chunk_size=None), # Pass byte iterator
294
- intro_value="data:",
295
- to_json=True, # Stream sends JSON
296
- skip_markers=["[DONE]"],
297
- content_extractor=self._github_extractor, # Use the specific extractor
298
- yield_raw_on_error=False # Skip non-JSON lines or lines where extractor fails
299
- )
300
-
301
- for content_chunk in processed_stream:
302
- # content_chunk is the string extracted by _github_extractor
303
- if content_chunk and isinstance(content_chunk, str):
304
- streaming_text += content_chunk
305
- resp = {"text": content_chunk}
306
- yield resp if not raw else content_chunk
307
-
308
- except Exception as e:
309
- if isinstance(e, CurlError): # Check for CurlError
310
- if hasattr(e, 'response') and e.response is not None:
311
- status_code = e.response.status_code
312
- if status_code == 401:
313
- raise exceptions.AuthenticationError("Authentication failed. Please check your cookies.")
314
-
315
- # If anything else fails
316
- raise exceptions.FailedToGenerateResponseError(f"Request failed: {str(e)}")
317
- finally:
318
- # Update history after stream finishes or fails (if text was generated)
319
- if streaming_text:
320
- self.last_response = {"text": streaming_text}
321
- self.conversation.update_chat_history(prompt, streaming_text)
322
-
323
- def for_non_stream():
324
- response_text = ""
325
- for response in for_stream():
326
- if "text" in response:
327
- response_text += response["text"]
328
- # self.last_response and history are updated in for_stream's finally block
329
- return self.last_response
330
-
331
- return for_stream() if stream else for_non_stream()
332
-
333
- def chat(
334
- self,
335
- prompt: str,
336
- stream: bool = False,
337
- optimizer: str = None,
338
- conversationally: bool = False,
339
- ) -> Union[str, Generator]:
340
- """Generate a response to a prompt"""
341
- def for_stream():
342
- for response in self.ask(
343
- prompt, True, optimizer=optimizer, conversationally=conversationally
344
- ):
345
- yield self.get_message(response)
346
-
347
- def for_non_stream():
348
- return self.get_message(
349
- self.ask(
350
- prompt, False, optimizer=optimizer, conversationally=conversationally
351
- )
352
- )
353
-
354
- return for_stream() if stream else for_non_stream()
355
-
356
- def get_message(self, response: dict) -> str:
357
- """Extract message text from response"""
358
- assert isinstance(response, dict), "Response should be of dict data-type only"
359
- return response.get("text", "")
360
-
361
- if __name__ == "__main__":
362
- # Simple test code
363
- from rich import print
364
-
365
- try:
366
- ai = GithubChat("cookies.json")
367
- response = ai.chat("Python code to count r in strawberry", stream=True)
368
- for chunk in response:
369
- print(chunk, end="", flush=True)
370
- print()
371
- except Exception as e:
372
- print(f"An error occurred: {e}")
1
+ from curl_cffi import CurlError
2
+ from curl_cffi.requests import Session
3
+ import json
4
+ import time
5
+ from typing import Any, Dict, Optional, Union, Generator
6
+ from webscout.AIutel import Conversation
7
+ from webscout.AIutel import Optimizers
8
+ from webscout.AIutel import AwesomePrompts, sanitize_stream # Import sanitize_stream
9
+ from webscout.AIbase import Provider
10
+ from webscout import exceptions
11
+ from webscout.litagent import LitAgent
12
+
13
+ class GithubChat(Provider):
14
+ """
15
+ A class to interact with the GitHub Copilot Chat API.
16
+ Uses cookies for authentication and supports streaming responses.
17
+ """
18
+ required_auth = True
19
+ # Available models
20
+ AVAILABLE_MODELS = [
21
+ "gpt-4o",
22
+ "gpt-5",
23
+ "gpt-5-mini",
24
+ "o3-mini",
25
+ "o1",
26
+ "claude-3.5-sonnet",
27
+ "claude-3.7-sonnet",
28
+ "claude-3.7-sonnet-thought",
29
+ "claude-sonnet-4",
30
+ "claude-sonnet-4.5",
31
+ "gemini-2.0-flash-001",
32
+ "gemini-2.5-pro",
33
+ "gpt-4.1",
34
+ "o4-mini"
35
+
36
+ ]
37
+
38
+ def __init__(
39
+ self,
40
+ is_conversation: bool = True,
41
+ max_tokens: int = 2000,
42
+ timeout: int = 60,
43
+ intro: str = None,
44
+ filepath: str = None,
45
+ update_file: bool = True,
46
+ proxies: dict = {},
47
+ history_offset: int = 10250,
48
+ act: str = None,
49
+ model: str = "gpt-4o",
50
+ cookie_path: str = "cookies.json"
51
+ ):
52
+ """Initialize the GithubChat client."""
53
+ if model not in self.AVAILABLE_MODELS:
54
+ raise ValueError(f"Invalid model: {model}. Choose from: {', '.join(self.AVAILABLE_MODELS)}")
55
+
56
+ self.url = "https://github.com/copilot"
57
+ self.api_url = "https://api.individual.githubcopilot.com"
58
+ self.cookie_path = cookie_path
59
+ self.session = Session() # Use curl_cffi Session
60
+ self.session.proxies.update(proxies)
61
+
62
+ # Load cookies for authentication
63
+ self.cookies = self.load_cookies()
64
+
65
+ # Set up headers for all requests
66
+ self.headers = {
67
+ "Content-Type": "application/json",
68
+ "User-Agent": LitAgent().random(),
69
+ "Accept": "*/*",
70
+ "Accept-Encoding": "gzip, deflate, br",
71
+ "Accept-Language": "en-US,en;q=0.5",
72
+ "Origin": "https://github.com",
73
+ "Referer": "https://github.com/copilot",
74
+ "GitHub-Verified-Fetch": "true",
75
+ "X-Requested-With": "XMLHttpRequest",
76
+ "Connection": "keep-alive",
77
+ "Sec-Fetch-Dest": "empty",
78
+ "Sec-Fetch-Mode": "cors",
79
+ "Sec-Fetch-Site": "same-origin",
80
+ }
81
+
82
+ # Apply cookies to session
83
+ if self.cookies:
84
+ self.session.cookies.update(self.cookies)
85
+
86
+ # Set default model
87
+ self.model = model
88
+
89
+ # Provider settings
90
+ self.is_conversation = is_conversation
91
+ self.max_tokens_to_sample = max_tokens
92
+ self.timeout = timeout
93
+ self.last_response = {}
94
+
95
+ # Available optimizers
96
+ self.__available_optimizers = (
97
+ method
98
+ for method in dir(Optimizers)
99
+ if callable(getattr(Optimizers, method)) and not method.startswith("__")
100
+ )
101
+
102
+ # Set up conversation
103
+ Conversation.intro = (
104
+ AwesomePrompts().get_act(
105
+ act, raise_not_found=True, default=None, case_insensitive=True
106
+ )
107
+ if act
108
+ else intro or Conversation.intro
109
+ )
110
+
111
+ self.conversation = Conversation(
112
+ is_conversation, self.max_tokens_to_sample, filepath, update_file
113
+ )
114
+ self.conversation.history_offset = history_offset
115
+
116
+ # Store conversation data
117
+ self._conversation_id = None
118
+ self._access_token = None
119
+
120
+ def load_cookies(self):
121
+ """Load cookies from a JSON file"""
122
+ try:
123
+ with open(self.cookie_path, 'r') as f:
124
+ cookies_data = json.load(f)
125
+
126
+ # Convert the cookie list to a dictionary format for requests
127
+ cookies = {}
128
+ for cookie in cookies_data:
129
+ # Only include cookies that are not expired and have a name and value
130
+ if 'name' in cookie and 'value':
131
+ # Check if the cookie hasn't expired
132
+ if 'expirationDate' not in cookie or cookie['expirationDate'] > time.time():
133
+ cookies[cookie['name']] = cookie['value']
134
+
135
+ return cookies
136
+ except Exception:
137
+ return {}
138
+
139
+ def get_access_token(self):
140
+ """Get GitHub Copilot access token."""
141
+ if self._access_token:
142
+ return self._access_token
143
+
144
+ url = "https://github.com/github-copilot/chat/token"
145
+
146
+ try:
147
+ response = self.session.post(url, headers=self.headers)
148
+
149
+ if response.status_code == 401:
150
+ raise exceptions.AuthenticationError("Authentication failed. Please check your cookies.")
151
+
152
+ if response.status_code != 200:
153
+ raise exceptions.FailedToGenerateResponseError(f"Failed to get access token: {response.status_code}")
154
+
155
+ data = response.json()
156
+ self._access_token = data.get("token")
157
+
158
+ if not self._access_token:
159
+ raise exceptions.FailedToGenerateResponseError("Failed to extract access token from response")
160
+
161
+ return self._access_token
162
+
163
+ except:
164
+ pass
165
+
166
+ @staticmethod
167
+ def _github_extractor(chunk: Union[str, Dict[str, Any]]) -> Optional[str]:
168
+ """Extracts content from GitHub Copilot stream JSON objects."""
169
+ if isinstance(chunk, dict) and chunk.get("type") == "content":
170
+ return chunk.get("body")
171
+ return None
172
+
173
+ def create_conversation(self):
174
+ """Create a new conversation with GitHub Copilot."""
175
+ if self._conversation_id:
176
+ return self._conversation_id
177
+
178
+ access_token = self.get_access_token()
179
+ url = f"{self.api_url}/github/chat/threads"
180
+
181
+ headers = self.headers.copy()
182
+ headers["Authorization"] = f"GitHub-Bearer {access_token}"
183
+
184
+ try:
185
+ response = self.session.post(
186
+ url, headers=headers,
187
+ impersonate="chrome120" # Add impersonate
188
+ )
189
+
190
+ if response.status_code == 401:
191
+ # Token might be expired, try refreshing
192
+ self._access_token = None
193
+ access_token = self.get_access_token()
194
+ headers["Authorization"] = f"GitHub-Bearer {access_token}"
195
+ response = self.session.post(url, headers=headers)
196
+
197
+ # Check status after potential retry
198
+ response.raise_for_status() # Raise HTTPError for bad responses (4xx or 5xx)
199
+
200
+ if response.status_code not in [200, 201]:
201
+ raise exceptions.FailedToGenerateResponseError(f"Failed to create conversation: {response.status_code}")
202
+
203
+ data = response.json()
204
+ self._conversation_id = data.get("thread_id")
205
+
206
+ if not self._conversation_id:
207
+ raise exceptions.FailedToGenerateResponseError("Failed to extract conversation ID from response")
208
+
209
+ return self._conversation_id
210
+ except (CurlError, exceptions.FailedToGenerateResponseError, Exception) as e: # Catch CurlError and others
211
+ raise exceptions.FailedToGenerateResponseError(f"Failed to create conversation: {str(e)}")
212
+
213
+ def ask(
214
+ self,
215
+ prompt: str,
216
+ stream: bool = False,
217
+ raw: bool = False,
218
+ optimizer: str = None,
219
+ conversationally: bool = False,
220
+ ) -> Union[Dict[str, Any], Generator]:
221
+ """Send a message to the GitHub Copilot Chat API"""
222
+
223
+ # Apply optimizers if specified
224
+ conversation_prompt = self.conversation.gen_complete_prompt(prompt)
225
+ if optimizer:
226
+ if optimizer in self.__available_optimizers:
227
+ conversation_prompt = getattr(Optimizers, optimizer)(
228
+ conversation_prompt if conversationally else prompt
229
+ )
230
+ else:
231
+ raise Exception(f"Optimizer is not one of {self.__available_optimizers}")
232
+
233
+ # Make sure we have a conversation ID
234
+ try:
235
+ conversation_id = self.create_conversation()
236
+ except exceptions.FailedToGenerateResponseError as e:
237
+ raise exceptions.FailedToGenerateResponseError(f"Failed to create conversation: {e}")
238
+
239
+ access_token = self.get_access_token()
240
+
241
+ url = f"{self.api_url}/github/chat/threads/{conversation_id}/messages"
242
+
243
+ # Update headers for this specific request
244
+ headers = self.headers.copy()
245
+ headers["Authorization"] = f"GitHub-Bearer {access_token}"
246
+
247
+ # Prepare the request payload
248
+ request_data = {
249
+ "content": conversation_prompt,
250
+ "intent": "conversation",
251
+ "references": [],
252
+ "context": [],
253
+ "currentURL": f"https://github.com/copilot/c/{conversation_id}",
254
+ "streaming": True,
255
+ "confirmations": [],
256
+ "customInstructions": [],
257
+ "model": self.model,
258
+ "mode": "immersive"
259
+ }
260
+
261
+ streaming_text = "" # Initialize for history update
262
+ def for_stream():
263
+ nonlocal streaming_text # Allow modification of outer scope variable
264
+ try:
265
+ response = self.session.post(
266
+ url,
267
+ json=request_data,
268
+ headers=headers, # Use updated headers with Authorization
269
+ stream=True,
270
+ timeout=self.timeout
271
+ )
272
+
273
+ if response.status_code == 401:
274
+ # Token might be expired, try refreshing
275
+ self._access_token = None
276
+ access_token = self.get_access_token()
277
+ headers["Authorization"] = f"GitHub-Bearer {access_token}"
278
+ response = self.session.post(
279
+ url,
280
+ json=request_data, # Use original payload
281
+ headers=headers,
282
+ stream=True,
283
+ timeout=self.timeout
284
+ )
285
+
286
+ # If still not successful, raise exception
287
+ response.raise_for_status() # Raise HTTPError for bad responses (4xx or 5xx)
288
+
289
+ # Process the streaming response
290
+ # Use sanitize_stream
291
+ processed_stream = sanitize_stream(
292
+ data=response.iter_content(chunk_size=None), # Pass byte iterator
293
+ intro_value="data:",
294
+ to_json=True, # Stream sends JSON
295
+ skip_markers=["[DONE]"],
296
+ content_extractor=self._github_extractor, # Use the specific extractor
297
+ yield_raw_on_error=False # Skip non-JSON lines or lines where extractor fails
298
+ )
299
+
300
+ for content_chunk in processed_stream:
301
+ # content_chunk is the string extracted by _github_extractor
302
+ if content_chunk and isinstance(content_chunk, str):
303
+ streaming_text += content_chunk
304
+ resp = {"text": content_chunk}
305
+ yield resp if not raw else content_chunk
306
+
307
+ except Exception as e:
308
+ if isinstance(e, CurlError): # Check for CurlError
309
+ if hasattr(e, 'response') and e.response is not None:
310
+ status_code = e.response.status_code
311
+ if status_code == 401:
312
+ raise exceptions.AuthenticationError("Authentication failed. Please check your cookies.")
313
+
314
+ # If anything else fails
315
+ raise exceptions.FailedToGenerateResponseError(f"Request failed: {str(e)}")
316
+ finally:
317
+ # Update history after stream finishes or fails (if text was generated)
318
+ if streaming_text:
319
+ self.last_response = {"text": streaming_text}
320
+ self.conversation.update_chat_history(prompt, streaming_text)
321
+
322
+ def for_non_stream():
323
+ response_text = ""
324
+ for response in for_stream():
325
+ if "text" in response:
326
+ response_text += response["text"]
327
+ # self.last_response and history are updated in for_stream's finally block
328
+ return self.last_response
329
+
330
+ return for_stream() if stream else for_non_stream()
331
+
332
+ def chat(
333
+ self,
334
+ prompt: str,
335
+ stream: bool = False,
336
+ optimizer: str = None,
337
+ conversationally: bool = False,
338
+ ) -> Union[str, Generator]:
339
+ """Generate a response to a prompt"""
340
+ def for_stream():
341
+ for response in self.ask(
342
+ prompt, True, optimizer=optimizer, conversationally=conversationally
343
+ ):
344
+ yield self.get_message(response)
345
+
346
+ def for_non_stream():
347
+ return self.get_message(
348
+ self.ask(
349
+ prompt, False, optimizer=optimizer, conversationally=conversationally
350
+ )
351
+ )
352
+
353
+ return for_stream() if stream else for_non_stream()
354
+
355
+ def get_message(self, response: dict) -> str:
356
+ """Extract message text from response"""
357
+ assert isinstance(response, dict), "Response should be of dict data-type only"
358
+ return response.get("text", "")
359
+
360
+ if __name__ == "__main__":
361
+ # Simple test code
362
+ from rich import print
363
+
364
+ try:
365
+ ai = GithubChat("cookies.json")
366
+ response = ai.chat("Python code to count r in strawberry", stream=True)
367
+ for chunk in response:
368
+ print(chunk, end="", flush=True)
369
+ print()
370
+ except Exception as e:
371
+ print(f"An error occurred: {e}")