HTML is All You Need¶

A lightweight graph database framework built entirely on web standards

HtmlGraph - Graph Database Visualization

## Install HtmlGraph

pip install htmlgraph

## Create Your First Graph

from htmlgraph import SDK

# Initialize SDK (auto-discovers .htmlgraph directory)
sdk = SDK(agent="claude")

# Create a feature with fluent API
feature = sdk.features.create("User Authentication") \
    .set_priority("high") \
    .add_steps([
        "Create login endpoint",
        "Add JWT middleware",
        "Write tests"
    ]) \
    .save()

# Query with filters
high_priority = sdk.features.where(status="todo", priority="high")

# Create tracks with specs and plans
track = sdk.tracks.builder() \
    .title("OAuth Integration") \
    .with_spec(overview="Add OAuth 2.0 support") \
    .with_plan_phases([
        ("Phase 1", ["Setup OAuth (2h)", "Add JWT (3h)"])
    ]) \
    .create()

</>

Pure Web Standards

HTML files as nodes, hyperlinks as edges, CSS selectors as queries. No Docker, no JVM, no external databases.

👁

Human Readable

Open any node in a browser. View relationships visually. Git diffs work perfectly. Inspect and debug with DevTools.

⚡

Minimal Infrastructure

No Docker, JVM, or external database servers. HTML files work in any browser. SDK uses pydantic, justhtml, SQLite. Offline-first.

📢

AI Agent First

Fluent SDK for Claude, Codex, Gemini. Automatic session tracking. TrackBuilder for deterministic workflows.

📈

Git Native

Text-based storage means perfect version control. Diffs show what changed. Merge conflicts are human-readable.

🚀

Production Ready

Pydantic validation. SQLite index for scale. Built-in dashboard. Session management. Event tracking. Type safe.

Why HtmlGraph?¶

Modern AI agent systems are drowning in complexity:

❌ Neo4j/Memgraph: Docker, JVM, learn Cypher
❌ Redis: Caching and state management overhead
❌ PostgreSQL: Heavy relational database setup
❌ Custom Protocols: Proprietary agent coordination
❌ Separate UIs: Additional observability tools

HtmlGraph eliminates all of this. The web is already a graph database. Use it.

Core Philosophy¶

The Web is the Graph

Every webpage is a node. Every hyperlink is an edge. Every browser is a graph viewer. Every CSS selector is a query. Version control works. Humans can read it. Agents can navigate it. HTML is all you need.

Quick Comparisons¶

vs Neo4j¶

Feature	Neo4j	HtmlGraph
Setup	Docker, JVM, learn Cypher	`pip install htmlgraph`
Human readable	❌ Browser required	✅ Any web browser
Version control	❌ Binary dumps	✅ Git diff works
Query language	Cypher (learn it)	CSS selectors (know it)
Cost	$$$ Enterprise	Free, MIT license

vs JSON/YAML¶

Feature	JSON	HtmlGraph
Human readable	🟡 Text editor	✅ Browser with styling
Graph structure	❌ Manual references	✅ Native hyperlinks
Query	❌ jq or custom	✅ CSS selectors
Presentation	❌ Needs UI	✅ Built-in rendering

Next Steps¶

📚 Get Started

Installation guide, first graph, and core concepts →

🔌 SDK Reference

Complete SDK documentation with examples →

📖 User Guide

Learn tracks, features, and session management →

⚡ Examples

Real-world use cases and code samples →

Built with web standards. Designed for AI agents. Loved by developers.

HTML is All You Need