Metadata-Version: 2.4
Name: webweavex
Version: 1.0.1
Summary: AI-powered web intelligence extraction engine
Author: Piyush Mishra
License-Expression: MIT
Project-URL: Homepage, https://github.com/ni-sh-a-char/WebWeaveX
Project-URL: Source, https://github.com/ni-sh-a-char/WebWeaveX/tree/python
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: python-dotenv
Dynamic: license-file

# 🚀 WebWeaveX

> **The Intelligence Layer of the Internet**
> Transform any website into structured, AI-ready data — instantly.

---

## 🌍 Why WebWeaveX Exists

The internet is built for humans to read, not for machines to understand.

Every website is:

* messy
* unstructured
* inconsistent

WebWeaveX changes that.

It converts raw web content into:

* clean text
* structured data
* knowledge graphs
* AI insights

👉 So developers and AI agents can actually use the internet, not just browse it.

---

## ⚡ What You Get

* 🧠 **Intelligent Extraction Engine** — understands content, not just parses HTML
* 🔗 **Automatic Knowledge Graphs** — entities + relationships
* 🤖 **AI Integration (Groq / OpenAI / Local)** — summaries, scoring, reasoning
* ♻️ **Deterministic Mode** — reproducible outputs for CI/CD
* 🔐 **Secure Context Layer** — powered by time-based encryption
* 📦 **Strict Schema Output** — always predictable
* ⚙️ **Parallel Extraction** — fast + scalable
* 🧬 **Self-Evolving Ready** — designed for autonomous AI systems

---

## 🧬 Built for the Future (AI + Agents)

WebWeaveX is not just a scraper.

It is designed for:

* AI agents
* autonomous systems
* self-evolving applications

It enables systems that can:

* read the web
* understand it
* extract meaning
* build knowledge
* improve over time

👉 This is the foundation for apps that can become anything.

---

## 📦 Installation

```bash
pip install webweavex
```

---

## 🚀 Quick Start

### Basic Extraction

```python
from webweavex import extract

result = extract("https://example.com")
print(result["content"]["text"])
```

---

### With AI Intelligence

```python
from webweavex import extract

result = extract(
    "https://docs.python.org/3/",
    options={
        "deterministic_mode": False,
        "ai": {
            "enabled": True,
            "provider": "groq",
            "api_key": "YOUR_API_KEY"
        }
    }
)

print(result["ai"]["result"]["summary"])
print(result["ai"]["result"]["entities"])
print(result["ai"]["result"]["score"])
```

---

## 🧠 Output Schema (Guaranteed)

```python
{
  "content": {
    "text": str,
    "code": list,
    "structured": dict
  },
  "intelligence": {},
  "knowledge": {
    "entities": list,
    "relations": list
  },
  "ai": {
    "mode": str,
    "result": {
      "summary": str,
      "entities": list,
      "score": float
    }
  },
  "meta": {
    "signature": {
      "powered_by": "WebWeaveX",
      "creator": "Piyush Mishra",
      "github": "PIYUSH-MISHRA-00"
    }
  },
  "knowledge_graph": {
    "nodes": int,
    "edges": int
  }
}
```

---

## 🔐 Security — Powered by Kaalka

WebWeaveX uses the **[Kaalka Encryption Algorithm](https://github.com/PIYUSH-MISHRA-00/Kaalka-Encryption-Algorithm)**.

A time-based encryption system where:

* ⏱️ Time acts as the key
* 🔄 Same data + different time → different encryption
* 🔐 Built for AI-native secure systems

👉 Designed for future autonomous intelligence systems.

---

## ⚙️ Configuration

| Option               | Type | Description               |
| -------------------- | ---- | ------------------------- |
| `deterministic_mode` | bool | Reproducible outputs      |
| `ai.enabled`         | bool | Enable AI                 |
| `ai.provider`        | str  | "groq", "openai", "local" |
| `ai.api_key`         | str  | API key                   |
| `max_depth`          | int  | Crawl depth               |
| `max_links_per_page` | int  | Link limit                |

---

## 🧪 Example Use Cases

* 🤖 AI agents reading the web
* 📊 Data pipelines from websites
* 🧠 Knowledge graph generation
* 🔍 Research automation
* 📚 Documentation summarization
* 🧬 Self-evolving applications

---

## 🧠 Core Principles

* Deterministic when needed
* Intelligent when enabled
* Secure by design
* Schema locked
* No hidden behavior

---

## 🧑‍💻 Creator Signature

Every output carries a traceable identity:

```json
{
  "powered_by": "WebWeaveX",
  "creator": "Piyush Mishra",
  "github": "PIYUSH-MISHRA-00"
}
```

---

## 🌍 Built for Humanity

WebWeaveX is a contribution toward:

* open intelligence
* accessible AI infrastructure
* systems that can learn and evolve

**Philosophy:**

* Free intelligence layer for the internet
* Built for humans and AI systems
* Secure by design
* Designed for the future

---

## ☕ Support the Project

If this helps you:

👉 Consider supporting:

* 🍵Buy Me a Coffee
* ⭐ Star the repo

---

## 📄 License

MIT License © 2026 Piyush Mishra

Use it. Build on it. Ship products with it.

---

## 🚀 Final Thought

> The internet was built for humans.
> WebWeaveX makes it usable for intelligence.

---

## ⭐ If You Like This

* Star the repo
* Share it
* Build something crazy with it

---

## 🔥 Built by

**Piyush Mishra :-**
[PIYUSH-MISHRA-00](https://github.com/PIYUSH-MISHRA-00)

<a href="buymeacoffee.com/piyushmishra00" target="_blank">
  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-orange.png" alt="Buy Me A Coffee" height="41" width="170">
</a>
