MGraph-AI__Service__Html__Graph

These details have been verified by PyPI

Project links

GitHub Statistics

Maintainers

These details have not been verified by PyPI

Project description

MGraph AI Service Html Graph

A powerful service that transforms HTML documents into graph representations for visualization, analysis, and manipulation. Built on the MGraph AI framework.

Overview

HTML Document  ──────►  Graph Representation  ──────►  Visual Output

<html>                     ┌─────────────┐              ┌─────────────┐
  <body>           ──►     │   Nodes     │      ──►     │   DOT       │
    <div>                  │   Edges     │              │   D3        │
  </body>                  │   Clusters  │              │   Cytoscape │
</html>                    └─────────────┘              │   VisJs     │
                                                        │   Mermaid   │
                                                        │   Tree      │
                                                        └─────────────┘

The Html Graph Service converts any HTML into a multi-graph model where different aspects of the document (DOM structure, attributes, scripts, styles) are represented as interconnected graphs that can be visualized using multiple rendering engines.

Features

Feature	Description
Multi-Graph Model	5 interconnected graphs: Body, Head, Attributes, Scripts, Styles
6 Rendering Engines	DOT (Graphviz), D3, Cytoscape, VisJs, Mermaid, Tree
8 Transformations	Default, Attributes View, Full Document, Head, Scripts, Styles, and more
Round-Trip Fidelity	HTML → Graph → HTML preserves all structure including boolean attributes
Clustered Views	Group subgraphs with colored clusters for full document visualization
REST API	FastAPI-based endpoints for programmatic access
AWS Lambda Ready	Deployable as serverless function

Quick Start

Installation

pip install mgraph-ai-service-html-graph

Basic Usage

from mgraph_ai_service_html_graph.service.html_graph.Html_Graph__Export__Service import Html_Graph__Export__Service

service = Html_Graph__Export__Service()

html = """
<html>
    <body>
        <div class="container">
            <p>Hello World</p>
        </div>
    </body>
</html>
"""

# Export to DOT format
result = service.export(
    html           = html,
    engine         = 'dot',
    transformation = 'default'
)

print(result['output'])

Running the Server

# Development
uvicorn mgraph_ai_service_html_graph.web.Html_Graph__Web:app --reload

# Production
uvicorn mgraph_ai_service_html_graph.web.Html_Graph__Web:app --host 0.0.0.0 --port 8000

Architecture

┌─────────────────────────────────────────────────────────────────────────────┐
│                              Html_MGraph Document                            │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│   ┌─────────────┐   ┌─────────────┐   ┌─────────────────────────────────┐  │
│   │  HEAD GRAPH │   │  BODY GRAPH │   │       ATTRIBUTES GRAPH          │  │
│   │             │   │             │   │                                 │  │
│   │  <head>     │   │  <body>     │   │  element ──► instance ──► name  │  │
│   │    └─title  │   │    └─div    │   │                    └──► value   │  │
│   └─────────────┘   └─────────────┘   └─────────────────────────────────┘  │
│                                                                             │
│   ┌─────────────┐   ┌─────────────┐   ┌─────────────────────────────────┐  │
│   │SCRIPTS GRAPH│   │STYLES GRAPH │   │       DOCUMENT GRAPH            │  │
│   │             │   │             │   │         (Meta View)             │  │
│   │  <script>   │   │  <style>    │   │  Connects all subgraphs         │  │
│   └─────────────┘   └─────────────┘   └─────────────────────────────────┘  │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

API Endpoints

Export HTML to Graph

POST /api/v1/html-graph/export
Content-Type: application/json

{
    "html": "<html><body><div>Hello</div></body></html>",
    "engine": "dot",
    "transformation": "default"
}

List Available Engines

GET /api/v1/html-graph/engines

Returns: ["dot", "d3", "cytoscape", "visjs", "mermaid", "tree"]

List Available Transformations

GET /api/v1/html-graph/transformations

Returns transformation metadata including name, label, and description.

Rendering Engines

Engine	Output	Best For
DOT	Graphviz DOT → SVG	Static diagrams, documentation
D3	JSON for D3.js	Interactive web visualizations
Cytoscape	JSON for Cytoscape.js	Complex network analysis
VisJs	JSON for vis.js	Dynamic, physics-based layouts
Mermaid	Mermaid syntax	Markdown-embeddable diagrams
Tree	JSON tree structure	Hierarchical views

Transformations

Transformation	Description
`default`	Body DOM structure
`attributes-view`	Tags and their attributes
`full-document`	All 5 subgraphs with colored clusters
`head-view`	Head section structure
`scripts-view`	Script elements and content
`styles-view`	Style elements and CSS

Creating Custom Transformations

from mgraph_ai_service_html_graph.service.html_graph__transformations.Graph_Transformation__Base import Graph_Transformation__Base

class My_Custom_Transformation(Graph_Transformation__Base):

    name        : str = "my-custom"
    label       : str = "My Custom View"
    description : str = "Custom visualization"

    def html_mgraph__to__mgraph(self, html_mgraph):
        # Select which graph to visualize
        return html_mgraph.attrs_graph.mgraph

    def configure_dot(self, config):
        # Customize DOT rendering
        config.rankdir = 'LR'
        return config

The 5-Phase Pipeline

Phase 1              Phase 2              Phase 3              Phase 4              Phase 5
────────             ────────             ────────             ────────             ────────
   │                    │                    │                    │                    │
   ▼                    ▼                    ▼                    ▼                    ▼

┌───────┐          ┌───────────┐        ┌─────────┐        ┌──────────┐        ┌────────┐
│ HTML  │────────► │Html_MGraph│───────►│ MGraph  │───────►│  Engine  │───────►│ Output │
└───────┘          └───────────┘        └─────────┘        └──────────┘        └────────┘

html__to__         html_mgraph__        transform_         configure_*         transform_
html_mgraph()      to__mgraph()         mgraph()           callbacks           export()

Each phase has a transformation hook allowing complete customization of the visualization pipeline.

Development

Setup

git clone https://github.com/the-cyber-boardroom/MGraph-AI__Service__Html__Graph.git
cd MGraph-AI__Service__Html__Graph
poetry install

Running Tests

pytest tests/

Project Structure

mgraph_ai_service_html_graph/
├── service/
│   ├── html_graph/              # Export service
│   ├── html_mgraph/             # Multi-graph HTML model
│   │   ├── converters/          # HTML ↔ MGraph converters
│   │   └── graphs/              # Subgraph implementations
│   ├── html_graph__transformations/  # View transformations
│   └── mgraph__engines/         # Rendering engines
└── web/                         # FastAPI endpoints

Use Cases

Web Scraping Analysis - Visualize DOM structure of scraped pages
HTML Diff Visualization - Compare documents via graph representations
Accessibility Auditing - Analyze attribute patterns for ARIA compliance
DOM Manipulation Planning - Visualize before/after transformation states
Educational Tool - Teach HTML structure through visual graphs
Security Analysis - Analyze script and style injection points

Documentation

Project Brief - Comprehensive overview
Attribute Refactor - 3-node attribute model

License

Apache 2.0 - See LICENSE for details.

Contributing

Contributions welcome! Please read our contributing guidelines and submit pull requests.

Related Projects

MGraph AI - Core graph framework
The Cyber Boardroom - Parent organization

Project details

These details have been verified by PyPI

Project links

GitHub Statistics

Maintainers

diniscruz

These details have not been verified by PyPI

Release history Release notifications | RSS feed

1.8.0

Jan 27, 2026

1.7.0

Jan 27, 2026

1.6.0

Jan 27, 2026

This version

1.5.0

Jan 21, 2026

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mgraph_ai_service_html_graph-1.5.0.tar.gz (523.6 kB view details)

Uploaded Jan 21, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

mgraph_ai_service_html_graph-1.5.0-py3-none-any.whl (807.9 kB view details)

Uploaded Jan 21, 2026 Python 3

File details

Details for the file mgraph_ai_service_html_graph-1.5.0.tar.gz.

File metadata

Download URL: mgraph_ai_service_html_graph-1.5.0.tar.gz
Upload date: Jan 21, 2026
Size: 523.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for mgraph_ai_service_html_graph-1.5.0.tar.gz
Algorithm	Hash digest
SHA256	`c2c361b68d53443f5cbe3022e29143e0733853549bb00ed929cfdae6caa3d068`
MD5	`28dd73324c9edb136a81bbdc9e0db981`
BLAKE2b-256	`4f80ef8c51d329f6f33c697304e83b4a4ca0970be0e6a07dc2c06eed8ef076e6`

See more details on using hashes here.

File details

Details for the file mgraph_ai_service_html_graph-1.5.0-py3-none-any.whl.

File metadata

Download URL: mgraph_ai_service_html_graph-1.5.0-py3-none-any.whl
Upload date: Jan 21, 2026
Size: 807.9 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for mgraph_ai_service_html_graph-1.5.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`0a66d732b915f0ed5f579b62b663a61c955e119e1ba4c4b5a64a6620c7e3d3ac`
MD5	`69734c9b21767a5d457c99216ee1f83d`
BLAKE2b-256	`c216270e59d7b1032f5be2b5351d35eb5a578e206eb9b8b6d254ead1c161e367`

See more details on using hashes here.

mgraph-ai-service-html-graph 1.5.0

Navigation

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Meta

Classifiers

Project description

MGraph AI Service Html Graph

Overview

Features

Quick Start

Installation

Basic Usage

Running the Server

Architecture

API Endpoints

Export HTML to Graph

List Available Engines

List Available Transformations

Rendering Engines

Transformations

Creating Custom Transformations

The 5-Phase Pipeline

Development

Setup

Running Tests

Project Structure

Use Cases

Documentation

License

Contributing

Related Projects

Project details

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

File details

File metadata

File hashes