Skip to navigation
Working with Data

CRUD Operations

How to access and modify Nodes and Edges

Graphiti defines two abstract base classes and nine concrete graph classes.

Base classConcrete classes
NodeEpisodicNode, EntityNode, CommunityNode, SagaNode
EdgeEpisodicEdge, EntityEdge, CommunityEdge, HasEpisodeEdge, NextEpisodeEdge

The Graphiti instance provides CRUD namespaces for these classes:

  • graphiti.nodes.entity
  • graphiti.nodes.episode
  • graphiti.nodes.community
  • graphiti.nodes.saga
  • graphiti.edges.entity
  • graphiti.edges.episodic
  • graphiti.edges.community
  • graphiti.edges.has_episode
  • graphiti.edges.next_episode

Each namespace uses the configured GraphDriver.

Save an entity node

The entity namespace generates the name embedding before it saves the node.

from graphiti_core.nodes import EntityNode
node = EntityNode(
    name="Acme",
    group_id="customer-123",
    summary="A customer organization",
)
saved_node = await graphiti.nodes.entity.save(node)

Get an entity node

node = await graphiti.nodes.entity.get_by_uuid(saved_node.uuid)

You can also get multiple nodes by UUID or group:

nodes = await graphiti.nodes.entity.get_by_uuids(["uuid-1", "uuid-2"])
group_nodes = await graphiti.nodes.entity.get_by_group_ids(
    ["customer-123"],
    limit=100,
)

Delete an entity node

await graphiti.nodes.entity.delete(node)

The node namespaces also provide delete_by_uuids and delete_by_group_id methods.

Save and get an entity edge

The entity edge namespace generates the fact embedding before it saves the edge.

from datetime import datetime, timezone
from graphiti_core.edges import EntityEdge
from graphiti_core.nodes import EntityNode
target_node = await graphiti.nodes.entity.save(
    EntityNode(
        name="Graphiti",
        group_id="customer-123",
        summary="A temporal knowledge graph framework",
    )
)
edge = EntityEdge(
    name="USES",
    fact="Acme uses Graphiti",
    group_id="customer-123",
    source_node_uuid=saved_node.uuid,
    target_node_uuid=target_node.uuid,
    created_at=datetime.now(timezone.utc),
)
saved_edge = await graphiti.edges.entity.save(edge)
loaded_edge = await graphiti.edges.entity.get_by_uuid(saved_edge.uuid)

Delete the edge through the same namespace:

await graphiti.edges.entity.delete(loaded_edge)

The entity edge namespace also provides methods to get edges between two nodes, get edges for one node, and operate on lists of UUIDs.