completcha 1.0.0__tar.gz

completcha-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Completcha
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

completcha-1.0.0/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.4
+Name: completcha
+Version: 1.0.0
+Summary: Captcha Solver
+Author: Completcha
+Author-email: support@completcha.com
+License-Expression: MIT
+Project-URL: Homepage, https://completcha.com
+Project-URL: Repository, https://github.com/completcha/completcha-python
+Keywords: completcha,captcha,solver,api,token,captcha solver,funcaptcha,arkose,funcaptcha solver,arkose solver,x,twitter,twitter captcha,x captcha,arkose token,funcaptcha token
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 4 - Beta
+Classifier: Natural Language :: English
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.12.1
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: colorama
+Dynamic: license-file
+
+# 🚀 Completcha
+
+Python library for solving **Arkose Labs / FunCaptcha** challenges, built to deliver **high success rates, speed, and real-world reliability in production**.
+
+### [Free trial for new users on completcha.com](https://completcha.com)
+
+Unlike traditional approaches, **Completcha** was designed to solve the most common problems faced when dealing with captchas:
+
+- ❌ Challenges that never get solved  
+- ⏳ Long waiting times for responses  
+- 🔁 Constant need to generate new captcha URLs  
+- 🚫 Limited attempts per challenge  
+
+---
+
+## 💡 Key Advantages
+
+### 🚀 Bypass Resolution (Main Advantage)
+
+The biggest advantage of Completcha is its **full Arkose bypass capability**.
+
+- Most challenges are solved **without requiring image solving**
+- The system accurately replicates real browser behavior
+- This results in:
+  - ⚡ Much faster responses  
+  - 🎯 Extremely high success rates  
+  - 🔄 Reduced need to generate new challenges  
+
+👉 In practice, this eliminates the most frustrating issue: waiting for a captcha that often never gets solved.
+
+---
+
+### 🖼️ Image Solving with Smart Retries
+
+When bypass is not possible (e.g., using rotating proxies), Completcha still stands out:
+
+- 🔁 Performs **all necessary retries automatically**
+- 🧠 Designed to handle harder image challenges
+- 📉 Significantly reduces failure rates
+- ♻️ Avoids the need to generate new captcha URLs
+
+Additionally:
+
+- Full integration with Arkose's original flow ensures:
+  - Fewer images are generated
+  - Behavior closely matches a real browser
+
+👉 Result: **one of the highest solving success rates on the market**, even in difficult scenarios.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install completcha
+```
+
+---
+
+## 🔐 Solving Methods
+
+**Completcha** provides two main methods for solving Arkose challenges:
+
+---
+
+### 🚀 1. Bypass (Recommended)
+
+The fastest and most reliable method.
+
+**How it works:**
+- The Arkose challenge URL must be requested using a **fixed proxy**
+- The solution is executed on the **same IP as the request**
+- No images need to be solved
+
+**Advantages:**
+- ⚡ High speed  
+- 🎯 Maximum reliability  
+- 🧠 No image solving required  
+
+⚠️ **Important:**
+- Use **fixed (dedicated) proxies**
+- **Do NOT use sticky proxies**
+
+> ❗ Sticky proxies will change IP addresses because they depend on the same source IP address to remain static since your source IP address is different from ours in the resolution side.
+
+---
+
+### 🖼️ 2. Image Solving
+
+Used when bypass is not possible.
+
+**When it happens:**
+- When using **rotating proxies**
+- The request IP differs from the solving IP
+
+**Features:**
+- 🧩 Automatically solves any image challenge  
+- 📊 Real-time logs for tracking progress  
+
+---
+
+## ⚙️ Best Practices
+
+- ✅ Use the **same User-Agent** from the original request  
+- ♻️ Reuse the same API instance (avoids rate limiting)  
+- 🔒 Prefer fixed proxies for best performance  
+
+---
+
+## 💻 Example Usage
+
+```python
+from completcha import SolverApi
+
+# Instantiate only once to maintain same completcha session to avoid rate limit
+completcha_session = SolverApi(
+    api_key='xxx-xxxx-xxx-xxx-xxxx-xxx',
+    show_logs=True
+)
+
+arkose_data = 'Q9xL2mVtF8yZk/rW.JpG4aH6uSnoqLDEBvCwR5Xf3sYt0ZlN8Peu/jK3qTz7rVbA1MHi9UdWcE2Ox+gFJYnKsL0QpR4t6BvXy7zN5hMeCq8GjAfD3uWPlZrT1n/SoIkVxYcE2mH7F9QaUpbXgRZK5V3nTtLj8wQh4Gv0p2fMsYkJ6CDeaI1Xo7r8s9NwBtU5lE3ZcHyPgQfO2uV1dKjSxA7mW9bL0FvRzJq6YH3XcD8tUpnK5wIeM4aG2ZQh7sVb9C0fYkT1xP8LrNwD3mE6uJgS2AqXv5oFz+HyR8c7LkW9p0VJtN3ZbGdE6xF2aQs8UoYhP1rM4iTnK7wC5vLzX9qD2jH0BfE3R6gPZs1yN4t8uAqI5WcKXoM7dVhFzYJ2bL9xC6rT3gUpvSnQ0='
+proxy = 'proxyusername:proxypassword@proxyhost:proxyport'
+site_key = '2CB16598-CB82-4CF7-B332-5990DB66F3AB'
+user_agent = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36'
+
+solved_token_arkose = completcha_session.arkose(
+    arkose_data,
+    proxy,
+    site_key,
+    user_agent
+)
+```
+
+### Return Solved Token
+```
+70103a5dafe122e18.1833610001|r=us-east-1|meta=3|meta_width=558|meta_height=523|metabgclr=transparent|metaiconclr=%23555555|guitextcolor=%23000000|pk=2CB16598-CB82-4CF7-B332-5990DB66F3AB|at=30|ag=201|cdn_url=https%3A%2F%2Fclient-api.arkoselabs.com%2Fcdn%2Ffc|surl=https%3A%2F%2Fclient-api.arkoselabs.com|smurl=https%3A%2F%2Fclient-api.arkoselabs.com%2Fcdn%2Ffc%2Fassets%2Fstyle-manager
+```
+---
+
+## ⭐ Method Comparison
+
+| Method              | Speed     | Reliability |
+|--------------------|----------|------------|
+| 🚀 Bypass          | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
+| 🖼️ Image Solving   | ⭐⭐⭐⭐   | ⭐⭐⭐⭐   |
+
+---
+
+## 🏆 Final Recommendation
+
+- 🚀 **Bypass** → ⭐⭐⭐⭐⭐ (Best overall choice)  
+- 🖼️ **Image** → ⭐⭐⭐⭐  
+
+✔ Always prefer **bypass with fixed proxies** for optimal performance.
+
+---
+
+## 💬 Community & Support
+
+<p align="center">
+  <a href="https://discord.gg/cdgHgF2ySG">
+    <img src="https://img.shields.io/badge/Join%20our%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord">
+  </a>
+</p>
+
+<p align="center">
+Join the community for support, updates, and discussions 🚀
+</p>

completcha-1.0.0/README.md

@@ -0,0 +1,168 @@
+# 🚀 Completcha
+
+Python library for solving **Arkose Labs / FunCaptcha** challenges, built to deliver **high success rates, speed, and real-world reliability in production**.
+
+### [Free trial for new users on completcha.com](https://completcha.com)
+
+Unlike traditional approaches, **Completcha** was designed to solve the most common problems faced when dealing with captchas:
+
+- ❌ Challenges that never get solved  
+- ⏳ Long waiting times for responses  
+- 🔁 Constant need to generate new captcha URLs  
+- 🚫 Limited attempts per challenge  
+
+---
+
+## 💡 Key Advantages
+
+### 🚀 Bypass Resolution (Main Advantage)
+
+The biggest advantage of Completcha is its **full Arkose bypass capability**.
+
+- Most challenges are solved **without requiring image solving**
+- The system accurately replicates real browser behavior
+- This results in:
+  - ⚡ Much faster responses  
+  - 🎯 Extremely high success rates  
+  - 🔄 Reduced need to generate new challenges  
+
+👉 In practice, this eliminates the most frustrating issue: waiting for a captcha that often never gets solved.
+
+---
+
+### 🖼️ Image Solving with Smart Retries
+
+When bypass is not possible (e.g., using rotating proxies), Completcha still stands out:
+
+- 🔁 Performs **all necessary retries automatically**
+- 🧠 Designed to handle harder image challenges
+- 📉 Significantly reduces failure rates
+- ♻️ Avoids the need to generate new captcha URLs
+
+Additionally:
+
+- Full integration with Arkose's original flow ensures:
+  - Fewer images are generated
+  - Behavior closely matches a real browser
+
+👉 Result: **one of the highest solving success rates on the market**, even in difficult scenarios.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install completcha
+```
+
+---
+
+## 🔐 Solving Methods
+
+**Completcha** provides two main methods for solving Arkose challenges:
+
+---
+
+### 🚀 1. Bypass (Recommended)
+
+The fastest and most reliable method.
+
+**How it works:**
+- The Arkose challenge URL must be requested using a **fixed proxy**
+- The solution is executed on the **same IP as the request**
+- No images need to be solved
+
+**Advantages:**
+- ⚡ High speed  
+- 🎯 Maximum reliability  
+- 🧠 No image solving required  
+
+⚠️ **Important:**
+- Use **fixed (dedicated) proxies**
+- **Do NOT use sticky proxies**
+
+> ❗ Sticky proxies will change IP addresses because they depend on the same source IP address to remain static since your source IP address is different from ours in the resolution side.
+
+---
+
+### 🖼️ 2. Image Solving
+
+Used when bypass is not possible.
+
+**When it happens:**
+- When using **rotating proxies**
+- The request IP differs from the solving IP
+
+**Features:**
+- 🧩 Automatically solves any image challenge  
+- 📊 Real-time logs for tracking progress  
+
+---
+
+## ⚙️ Best Practices
+
+- ✅ Use the **same User-Agent** from the original request  
+- ♻️ Reuse the same API instance (avoids rate limiting)  
+- 🔒 Prefer fixed proxies for best performance  
+
+---
+
+## 💻 Example Usage
+
+```python
+from completcha import SolverApi
+
+# Instantiate only once to maintain same completcha session to avoid rate limit
+completcha_session = SolverApi(
+    api_key='xxx-xxxx-xxx-xxx-xxxx-xxx',
+    show_logs=True
+)
+
+arkose_data = 'Q9xL2mVtF8yZk/rW.JpG4aH6uSnoqLDEBvCwR5Xf3sYt0ZlN8Peu/jK3qTz7rVbA1MHi9UdWcE2Ox+gFJYnKsL0QpR4t6BvXy7zN5hMeCq8GjAfD3uWPlZrT1n/SoIkVxYcE2mH7F9QaUpbXgRZK5V3nTtLj8wQh4Gv0p2fMsYkJ6CDeaI1Xo7r8s9NwBtU5lE3ZcHyPgQfO2uV1dKjSxA7mW9bL0FvRzJq6YH3XcD8tUpnK5wIeM4aG2ZQh7sVb9C0fYkT1xP8LrNwD3mE6uJgS2AqXv5oFz+HyR8c7LkW9p0VJtN3ZbGdE6xF2aQs8UoYhP1rM4iTnK7wC5vLzX9qD2jH0BfE3R6gPZs1yN4t8uAqI5WcKXoM7dVhFzYJ2bL9xC6rT3gUpvSnQ0='
+proxy = 'proxyusername:proxypassword@proxyhost:proxyport'
+site_key = '2CB16598-CB82-4CF7-B332-5990DB66F3AB'
+user_agent = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36'
+
+solved_token_arkose = completcha_session.arkose(
+    arkose_data,
+    proxy,
+    site_key,
+    user_agent
+)
+```
+
+### Return Solved Token
+```
+70103a5dafe122e18.1833610001|r=us-east-1|meta=3|meta_width=558|meta_height=523|metabgclr=transparent|metaiconclr=%23555555|guitextcolor=%23000000|pk=2CB16598-CB82-4CF7-B332-5990DB66F3AB|at=30|ag=201|cdn_url=https%3A%2F%2Fclient-api.arkoselabs.com%2Fcdn%2Ffc|surl=https%3A%2F%2Fclient-api.arkoselabs.com|smurl=https%3A%2F%2Fclient-api.arkoselabs.com%2Fcdn%2Ffc%2Fassets%2Fstyle-manager
+```
+---
+
+## ⭐ Method Comparison
+
+| Method              | Speed     | Reliability |
+|--------------------|----------|------------|
+| 🚀 Bypass          | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
+| 🖼️ Image Solving   | ⭐⭐⭐⭐   | ⭐⭐⭐⭐   |
+
+---
+
+## 🏆 Final Recommendation
+
+- 🚀 **Bypass** → ⭐⭐⭐⭐⭐ (Best overall choice)  
+- 🖼️ **Image** → ⭐⭐⭐⭐  
+
+✔ Always prefer **bypass with fixed proxies** for optimal performance.
+
+---
+
+## 💬 Community & Support
+
+<p align="center">
+  <a href="https://discord.gg/cdgHgF2ySG">
+    <img src="https://img.shields.io/badge/Join%20our%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord">
+  </a>
+</p>
+
+<p align="center">
+Join the community for support, updates, and discussions 🚀
+</p>

completcha-1.0.0/completcha/__init__.py

@@ -0,0 +1,143 @@
+import requests
+from requests.exceptions import HTTPError, ConnectTimeout
+import time
+import random
+from completcha.logger_print import SimpleLogger
+from completcha.exceptions import *
+
+
+class SolverApi:
+    def __init__(self, api_key: str, show_logs: bool = False):
+        self._show_log: bool = show_logs
+        self._apikeycompletcha: str = api_key
+        if self._show_log:
+            self._log = SimpleLogger(level=SimpleLogger.DEBUG, name='COMPLETCHA')
+        else:
+            self._log = SimpleLogger(level=SimpleLogger.DISABLED)
+        self.session = requests.session()
+
+    @staticmethod
+    def _verify_new_update(json_response):
+        detail = json_response.get('detail') or []
+        if (
+                isinstance(detail, list) and
+                len(detail) > 0 and
+                isinstance(detail[0], dict) and
+                detail[0].get("type") == "missing" and
+                isinstance(detail[0].get("loc"), list) and
+                len(detail[0]["loc"]) > 0 and
+                detail[0]["loc"][0] == "body"
+        ):
+
+            raise DeprecatedLibrary(f"New parameter \033[31;4m{detail[0]["loc"][1]}\033[0m required in the payload. Update to the latest version of the completcha library.")
+
+    def _request_with_retry(self, func, max_retries=5, base_delay=1):
+        for attempt in range(1, max_retries + 1):
+            try:
+                return func()
+
+            except ConnectTimeout as err:
+                delay = base_delay * (2 ** (attempt - 1))
+                jitter = random.uniform(0, 0.5)
+                final_delay = delay + jitter
+
+                self._log.warning(
+                    f"Attempt {attempt}/{max_retries} to connect to the server failed: {err} | waiting {final_delay:.2f}s"
+                )
+
+                time.sleep(final_delay)
+
+        raise MaxRetriesServerExceeded("Maximum number of attempts to connect to the server reached")
+
+    def arkose(self, arkose_data_blob: str, proxy: str, public_key: str, user_agent: str | None = None) -> str:
+        """
+        Creates an Arkose resolution task and returns the resolved token.
+
+        Args:
+            arkose_data_blob (str): Parameter data blob.
+            proxy (str): Proxy in the format username:password@host:port.
+            public_key (str): The public key.
+            user_agent (str, optional): The User-Agent to be used. Defaults to None.
+
+        Returns:
+            str: The resolved challenge token.
+        """
+        if not self._apikeycompletcha or not isinstance(self._apikeycompletcha, str):
+            raise MissingApiKey(
+                "Invalid configuration: 'SolverApi()._apikeycompletcha' must be set to a valid string API key before calling SolverApi methods.")
+
+        root_path = 'demoarkose'
+        payload_create_task = {"datablob": arkose_data_blob, "user_agent": user_agent, "proxy": proxy,
+                               "public_key": public_key}
+
+        create_task_url = f'https://api.completcha.com/{root_path}/task/create'
+        get_status_url = f'https://api.completcha.com/{root_path}/task/status/'
+
+        headers_solver = {'x-api-key': self._apikeycompletcha}
+
+        def post_request(url, payload):
+            return self._request_with_retry(lambda: self.session.post(
+                url,
+                headers=headers_solver,
+                json=payload
+            ))
+
+        def get_request(url: str, task_id_passed: str):
+            return self._request_with_retry(lambda: self.session.get(
+                url + task_id_passed,
+                headers=headers_solver
+            ))
+
+        # Criar Tarefa
+        name_show = 'Arkose'
+        print(f"Requesting {name_show} Token in Completcha Solver ...")
+        response_create_task = post_request(create_task_url, payload_create_task)
+        status_response_create_task = response_create_task.status_code
+        text_response_create_task = response_create_task.text
+        self._log.debug(f"Status: {status_response_create_task}, Text: {text_response_create_task} ...")
+
+        try:
+            response_create_task.raise_for_status()
+        except HTTPError as e:
+            if e.response.status_code == 422:
+                if "application/json" in e.response.headers.get("Content-Type", ""):
+                    json_error_res = e.response.json()
+                    self._verify_new_update(json_error_res)
+            raise ServerError(
+                f'Error when trying to create a task >>\nStatus Code Error: {e.response.status_code}, Response: {e.response.text}')
+
+        json_response_create_task = response_create_task.json()
+        task_id = json_response_create_task["task_id"]
+
+        print_result = None
+        # Aguardar Resolução
+        while True:
+            response_status_resolution = get_request(get_status_url, task_id)
+            text_response_status_resolution = response_status_resolution.text
+
+            if not print_result == text_response_status_resolution:
+                print_result = text_response_status_resolution
+                self._log.debug(f"{print_result} ...")
+
+            try:
+                response_status_resolution.raise_for_status()
+            except HTTPError as e:
+                raise ServerError(
+                    f'Error when trying to get the task response >>\nStatus Code Error: {e.response.status_code}, Response: {e.response.text}')
+
+            json_response_status_resolution = response_status_resolution.json()
+            if json_response_status_resolution['status'] == 'completed':
+                token_solved = json_response_status_resolution['result']
+                print(f"{name_show} challenge completed", token_solved)
+                return token_solved
+            elif json_response_status_resolution['status'] == 'failed':
+                raise SolverApiError(f"Error in {name_show} challenge solution: {json_response_status_resolution['result']}")
+            elif json_response_status_resolution['status'] in ('in resolution', 'pending'):
+                time.sleep(1.2)
+            else:
+                raise ProgrammerError(
+                    f"The response status does not match any programmed criteria: {json_response_status_resolution}")
+
+
+if __name__ == '__main__':
+    breakpoint()

completcha-1.0.0/completcha/exceptions.py

@@ -0,0 +1,22 @@
+class SolverApiError(Exception):
+    pass
+
+
+class MissingApiKey(Exception):
+    pass
+
+
+class ProgrammerError(Exception):
+    pass
+
+
+class ServerError(Exception):
+    pass
+
+
+class MaxRetriesServerExceeded(Exception):
+    pass
+
+
+class DeprecatedLibrary(Exception):
+    pass

completcha-1.0.0/completcha/logger_print/__init__.py

@@ -0,0 +1,35 @@
+from datetime import datetime
+from colorama import Fore, Style, init
+
+
+class SimpleLogger:
+    DEBUG = 10
+    INFO = 20
+    WARNING = 30
+    DISABLED = 100
+
+    def __init__(self, level=INFO, name: str | None = None):
+        self.level = level
+        self.name = name
+        init()
+
+    def set_level(self, level):
+        self.level = level
+
+    def _display(self, label, message, color):
+        timestamp = datetime.now().strftime("%H:%M:%S.%f")[:-3]
+        if self.name:
+            label = self.name + "] [" + label
+        print(f"{color}[{timestamp}] [{label}] {message}{Style.RESET_ALL}", flush=True)
+
+    def debug(self, message):
+        if self.level <= self.DEBUG:
+            self._display("DEBUG", message, Fore.LIGHTGREEN_EX)
+
+    def info(self, message):
+        if self.level <= self.INFO:
+            self._display("INFO", message, Fore.LIGHTBLUE_EX)
+
+    def warning(self, message):
+        if self.level <= self.WARNING:
+            self._display("WARNING", message, Fore.LIGHTRED_EX)

completcha-1.0.0/completcha.egg-info/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.4
+Name: completcha
+Version: 1.0.0
+Summary: Captcha Solver
+Author: Completcha
+Author-email: support@completcha.com
+License-Expression: MIT
+Project-URL: Homepage, https://completcha.com
+Project-URL: Repository, https://github.com/completcha/completcha-python
+Keywords: completcha,captcha,solver,api,token,captcha solver,funcaptcha,arkose,funcaptcha solver,arkose solver,x,twitter,twitter captcha,x captcha,arkose token,funcaptcha token
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 4 - Beta
+Classifier: Natural Language :: English
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.12.1
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: colorama
+Dynamic: license-file
+
+# 🚀 Completcha
+
+Python library for solving **Arkose Labs / FunCaptcha** challenges, built to deliver **high success rates, speed, and real-world reliability in production**.
+
+### [Free trial for new users on completcha.com](https://completcha.com)
+
+Unlike traditional approaches, **Completcha** was designed to solve the most common problems faced when dealing with captchas:
+
+- ❌ Challenges that never get solved  
+- ⏳ Long waiting times for responses  
+- 🔁 Constant need to generate new captcha URLs  
+- 🚫 Limited attempts per challenge  
+
+---
+
+## 💡 Key Advantages
+
+### 🚀 Bypass Resolution (Main Advantage)
+
+The biggest advantage of Completcha is its **full Arkose bypass capability**.
+
+- Most challenges are solved **without requiring image solving**
+- The system accurately replicates real browser behavior
+- This results in:
+  - ⚡ Much faster responses  
+  - 🎯 Extremely high success rates  
+  - 🔄 Reduced need to generate new challenges  
+
+👉 In practice, this eliminates the most frustrating issue: waiting for a captcha that often never gets solved.
+
+---
+
+### 🖼️ Image Solving with Smart Retries
+
+When bypass is not possible (e.g., using rotating proxies), Completcha still stands out:
+
+- 🔁 Performs **all necessary retries automatically**
+- 🧠 Designed to handle harder image challenges
+- 📉 Significantly reduces failure rates
+- ♻️ Avoids the need to generate new captcha URLs
+
+Additionally:
+
+- Full integration with Arkose's original flow ensures:
+  - Fewer images are generated
+  - Behavior closely matches a real browser
+
+👉 Result: **one of the highest solving success rates on the market**, even in difficult scenarios.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install completcha
+```
+
+---
+
+## 🔐 Solving Methods
+
+**Completcha** provides two main methods for solving Arkose challenges:
+
+---
+
+### 🚀 1. Bypass (Recommended)
+
+The fastest and most reliable method.
+
+**How it works:**
+- The Arkose challenge URL must be requested using a **fixed proxy**
+- The solution is executed on the **same IP as the request**
+- No images need to be solved
+
+**Advantages:**
+- ⚡ High speed  
+- 🎯 Maximum reliability  
+- 🧠 No image solving required  
+
+⚠️ **Important:**
+- Use **fixed (dedicated) proxies**
+- **Do NOT use sticky proxies**
+
+> ❗ Sticky proxies will change IP addresses because they depend on the same source IP address to remain static since your source IP address is different from ours in the resolution side.
+
+---
+
+### 🖼️ 2. Image Solving
+
+Used when bypass is not possible.
+
+**When it happens:**
+- When using **rotating proxies**
+- The request IP differs from the solving IP
+
+**Features:**
+- 🧩 Automatically solves any image challenge  
+- 📊 Real-time logs for tracking progress  
+
+---
+
+## ⚙️ Best Practices
+
+- ✅ Use the **same User-Agent** from the original request  
+- ♻️ Reuse the same API instance (avoids rate limiting)  
+- 🔒 Prefer fixed proxies for best performance  
+
+---
+
+## 💻 Example Usage
+
+```python
+from completcha import SolverApi
+
+# Instantiate only once to maintain same completcha session to avoid rate limit
+completcha_session = SolverApi(
+    api_key='xxx-xxxx-xxx-xxx-xxxx-xxx',
+    show_logs=True
+)
+
+arkose_data = 'Q9xL2mVtF8yZk/rW.JpG4aH6uSnoqLDEBvCwR5Xf3sYt0ZlN8Peu/jK3qTz7rVbA1MHi9UdWcE2Ox+gFJYnKsL0QpR4t6BvXy7zN5hMeCq8GjAfD3uWPlZrT1n/SoIkVxYcE2mH7F9QaUpbXgRZK5V3nTtLj8wQh4Gv0p2fMsYkJ6CDeaI1Xo7r8s9NwBtU5lE3ZcHyPgQfO2uV1dKjSxA7mW9bL0FvRzJq6YH3XcD8tUpnK5wIeM4aG2ZQh7sVb9C0fYkT1xP8LrNwD3mE6uJgS2AqXv5oFz+HyR8c7LkW9p0VJtN3ZbGdE6xF2aQs8UoYhP1rM4iTnK7wC5vLzX9qD2jH0BfE3R6gPZs1yN4t8uAqI5WcKXoM7dVhFzYJ2bL9xC6rT3gUpvSnQ0='
+proxy = 'proxyusername:proxypassword@proxyhost:proxyport'
+site_key = '2CB16598-CB82-4CF7-B332-5990DB66F3AB'
+user_agent = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36'
+
+solved_token_arkose = completcha_session.arkose(
+    arkose_data,
+    proxy,
+    site_key,
+    user_agent
+)
+```
+
+### Return Solved Token
+```
+70103a5dafe122e18.1833610001|r=us-east-1|meta=3|meta_width=558|meta_height=523|metabgclr=transparent|metaiconclr=%23555555|guitextcolor=%23000000|pk=2CB16598-CB82-4CF7-B332-5990DB66F3AB|at=30|ag=201|cdn_url=https%3A%2F%2Fclient-api.arkoselabs.com%2Fcdn%2Ffc|surl=https%3A%2F%2Fclient-api.arkoselabs.com|smurl=https%3A%2F%2Fclient-api.arkoselabs.com%2Fcdn%2Ffc%2Fassets%2Fstyle-manager
+```
+---
+
+## ⭐ Method Comparison
+
+| Method              | Speed     | Reliability |
+|--------------------|----------|------------|
+| 🚀 Bypass          | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
+| 🖼️ Image Solving   | ⭐⭐⭐⭐   | ⭐⭐⭐⭐   |
+
+---
+
+## 🏆 Final Recommendation
+
+- 🚀 **Bypass** → ⭐⭐⭐⭐⭐ (Best overall choice)  
+- 🖼️ **Image** → ⭐⭐⭐⭐  
+
+✔ Always prefer **bypass with fixed proxies** for optimal performance.
+
+---
+
+## 💬 Community & Support
+
+<p align="center">
+  <a href="https://discord.gg/cdgHgF2ySG">
+    <img src="https://img.shields.io/badge/Join%20our%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord">
+  </a>
+</p>
+
+<p align="center">
+Join the community for support, updates, and discussions 🚀
+</p>

completcha-1.0.0/completcha.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+completcha/__init__.py
+completcha/exceptions.py
+completcha.egg-info/PKG-INFO
+completcha.egg-info/SOURCES.txt
+completcha.egg-info/dependency_links.txt
+completcha.egg-info/requires.txt
+completcha.egg-info/top_level.txt
+completcha/logger_print/__init__.py

completcha-1.0.0/completcha.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

completcha-1.0.0/completcha.egg-info/requires.txt

@@ -0,0 +1,2 @@
+requests
+colorama

completcha-1.0.0/completcha.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+completcha
+dist

completcha-1.0.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "completcha"
+version = "1.0.0"
+keywords = ["completcha", "captcha", "solver", "api", "token", "captcha solver", "funcaptcha", "arkose", "funcaptcha solver", "arkose solver", "x", "twitter", "twitter captcha", "x captcha", "arkose token", "funcaptcha token"]
+description = "Captcha Solver"
+readme = "README.md"
+authors = [{ name = "Completcha" }, { email = "support@completcha.com" }]
+license = "MIT"
+license-files = ["LICENSE"]
+urls = { "Homepage" = "https://completcha.com" ,  "Repository" = "https://github.com/completcha/completcha-python" }
+dependencies = ['requests', 'colorama']
+requires-python = ">=3.12.1"
+classifiers = [
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+    "Development Status :: 4 - Beta",
+    "Natural Language :: English",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Software Development :: Libraries :: Python Modules"
+]
+
+[tool.setuptools.packages.find]
+where = ["."]

completcha-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+