Skip to content

Examples

Real-world examples of using HtmlGraph.

Basic Examples

Use Cases

Personal Knowledge Base

Use HtmlGraph to manage notes and ideas:

from htmlgraph import SDK

sdk = SDK(agent="me")

# Create a note
note = sdk.features.create(
    title="Research: Graph Databases",
    properties={"type": "note", "category": "research"}
)

# Link related notes
sdk.features.add_edge(
    from_id=note.id,
    to_id="feature-another-note",
    relationship="related"
)

Project Management

Track tasks and deliverables:

# Create a project track
project = sdk.tracks.builder() \
    .title("Website Redesign") \
    .with_plan_phases([
        ("Phase 1: Design", [
            "Create mockups (8h)",
            "Review with stakeholders (2h)"
        ]),
        ("Phase 2: Development", [
            "Implement frontend (20h)",
            "Backend API (15h)"
        ])
    ]) \
    .create()

# Create features for each deliverable
for phase in project.plan.phases:
    for task in phase.tasks:
        sdk.features.create(
            title=task.description,
            track_id=project.track_id
        )

Agent Coordination

Coordinate multiple AI agents:

# Agent 1 creates feature
claude = SDK(agent="claude")
feature = claude.features.create("Implement auth")
feature.assigned_agent = "claude"
feature.save()

# Agent 1 completes part of the work
feature.steps[0].completed = True
feature.handoff_notes = "OAuth configured. JWT implementation next."
feature.assigned_agent = "gemini"
feature.save()

# Agent 2 picks up
gemini = SDK(agent="gemini")
feature = gemini.features.get(feature.id)
print(feature.handoff_notes)  # See what Agent 1 did

Complete Examples

Browse the example implementations:

Next Steps