README.md

---
title: Omni-Digital Cloud Engine
emoji: 🌌
colorFrom: indigo
colorTo: purple
sdk: docker
pinned: false
app_port: 7860
---

# 🚀 Omni-Digital Cloud Engine (Advanced Headless API)

![Version](https://img.shields.io/badge/Version-2.0-blue.svg)
![Build](https://img.shields.io/badge/Build-Passing-brightgreen.svg)
![Security](https://img.shields.io/badge/Security-API%20Key%20Secured-red.svg)

## 📌 Overview
This repository hosts a highly optimized, stealth-enabled Headless Browser Engine deployed via Docker. It exposes a secure FastAPI gateway designed for advanced AI orchestration, automated OSINT gathering, and dynamic DOM manipulation.

## ⚙️ Core Architecture
* **Engine:** Playwright (Chromium) with Stealth injection.
* **Gateway:** FastAPI with Pydantic payload validation.
* **Concurrency:** Fully asynchronous execution model capable of handling multiple remote browser instances.
* **Security:** Header-based master key authentication (`x-api-key`).

## 📡 Primary Endpoint
**`POST /api/v1/execute`**

### Payload Structure (JSON)
```json
{
  "url": "[https://example.com](https://example.com)",
  "js_code": "document.title",
  "extract_html": false,
  "wait_time_ms": 2000
}