Metadata-Version: 2.4
Name: camouchat-browser
Version: 0.7.0
Summary: Plugin for CamouChat providing anti-detection browser management via Camoufox and Playwright.
Keywords: browser-automation,stealth,camoufox,playwright,anti-detection,fingerprinting,browserforge
Author: BITS-Rohit
Author-email: BITS-Rohit <rohitguptaradheradhe123@gmail.com>
License-Expression: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Classifier: Framework :: AsyncIO
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Natural Language :: English
Requires-Dist: browserforge>=1.2.4
Requires-Dist: camouchat-core
Requires-Dist: camoufox[geoip]>=0.4.11
Requires-Dist: platformdirs>=4.9.6
Requires-Dist: playwright>=1.58.0
Requires-Dist: pyobjc-framework-quartz ; sys_platform == 'darwin'
Maintainer: BITS-Rohit
Maintainer-email: BITS-Rohit <rohitguptaradheradhe123@gmail.com>
Requires-Python: >=3.14
Project-URL: Homepage, https://github.com/CamouChat-Team
Project-URL: Repository, https://github.com/CamouChat-Team/camouchat-browser
Project-URL: Bug Tracker, https://github.com/CamouChat-Team/camouchat-browser/issues
Project-URL: Changelog, https://github.com/CamouChat-Team/camouchat-browser/releases
Description-Content-Type: text/markdown

# CamouChat Browser 🦊

A high-performance, stealth-oriented browser orchestration layer designed for the CamouChat ecosystem. Built on top of [Camoufox](https://camoufox.com/), it provides advanced anti-detection capabilities, hardware-level fingerprint spoofing, and robust session management.

## Key Features

- **Advanced Stealth**: Powered by [Camoufox](https://camoufox.com/) for industry-leading anti-bot bypass.
- **Fingerprint Spoofing**: Deep integration with `browserforge` for authentic hardware and software headers.
- **Session Isolation**: Automated profile management with persistent storage for cookies and local data.
- **GeoIP & Proxy Ready**: Built-in support for residential proxies and automated GeoIP matching.
- **Humanized Interaction**: Smooth mouse movements and typing patterns to maintain high stealth scores.

## Installation

Add to your project using `uv`:

```bash
uv add camouchat-browser
```

## Quick Start

```python
from camouchat_browser import BrowserConfig, CamoufoxBrowser, ProfileManager, BrowserForge
from camouchat_core import Platform

# 1. Setup Configuration
config = BrowserConfig.from_dict({
    "platform": Platform.WHATSAPP,
    "headless": False,
    "locale": "en-US",
    "fingerprint_obj": BrowserForge()
})

# 2. Manage Profiles
pm = ProfileManager(platform=Platform.WHATSAPP)
profile = pm.get_profile(profile_id="stealth_user_1")

# 3. Launch Browser
browser = CamoufoxBrowser(config=config, profile=profile)
page = await browser.get_page()

await page.goto("https://check.camoufox.com")
```

## Documentation

- [Browser Configuration](https://github.com/CamouChat-Team/camouchat-browser/blob/main/docs/browser_config.md) - Finetuning stealth settings.
- [Browser Engine](https://github.com/CamouChat-Team/camouchat-browser/blob/main/docs/camoufox_browser.md) - Deep dive into Camoufox integration.
- [Profile Management](https://github.com/CamouChat-Team/camouchat-browser/blob/main/docs/profiles.md) - Managing sandboxes and encryption.
- [Fingerprinting](https://github.com/CamouChat-Team/camouchat-browser/blob/main/docs/BrowserForge.md) - hardware-level spoofing logic.

## Roadmap

- 🐳 **Docker Containerization**: Full headless Docker image with Xvfb, Camoufox binaries, and proxy-routing pre-configured out of the box (Targeting v0.8.0).

## ⚖️ Security & Ethics

CamouChat's strict policy regarding acceptable automation, anti-spam, and stealth disclaimers can be found in our central ecosystem hub:

👉 **[SECURITY.md](https://github.com/CamouChat-Team/CamouChat/blob/main/SECURITY.md)**

## License

MIT License. See [LICENSE](LICENSE) for details.
