cianfhoghlaim/cianchosaint / .agents/skills/graphiti
graphiti
VerifiedGraphiti - Temporal Knowledge Graph Memory
Version: graphiti-core 0.29.2+ | Last Updated: 2026-09-26
Verified upstream: https://github.com/getzep/graphiti/releases v0.29.2 (ff7e29c)
Docs: https://help.getzep.com/graphiti (root URL — no double /graphiti/graphiti/ prefix)
llms.txt: https://help.getzep.com/llms.txt (best for agents)
URLs (verified 2026-06-29)
- Overview: https://help.getzep.com/graphiti/getting-started/overview
- Quick Start: https://help.getzep.com/graphiti/getting-started/quick-start
- Configuration: https://help.getzep.com/graphiti/configuration/llm-configuration (and .../graph-database-configuration, .../telemetry)
- Working with Data / Episodes: https://help.getzep.com/graphiti/working-with-data/add-episodes
- LangGraph integration: https://help.getzep.com/graphiti/integrations/lang-graph-agent
- LLM-friendly index (best for agents): https://help.getzep.com/llms.txt
- MCP server for IDE clients: https://help.getzep.com/_mcp/server
Quick start
from graphiti_core import Graphiti
from graphiti_core.nodes import EpisodeType # canonical since v0.29.x
# Canonical URI: falkor://host:port (Cloud: falkor://your-instance.falkordb.cloud:6379)
graphiti = Graphiti(uri="falkor://falkordb:6379")
await graphiti.build_indices_and_constraints() # one-time
# Add an episode (event-time + ingestion-time tracked)
await graphiti.add_episode(
name="meeting-2026-06-29",
episode_body="Cian met with the Bunchloch team to plan a new FalkorDB-backed curriculum graph.",
source=EpisodeType.text,
source_description="calendar entry",
reference_time=datetime(2026, 6, 29, 10, 0),
)
# Search (bi-temporal + hybrid)
results = await graphiti.search_("FalkorDB curriculum", num_results=10)
v0.29.x new surface (live, not in Wave 1)
| Symbol | First released | Purpose |
|---|---|---|
Graphiti.summarize_saga(saga_id) | v0.29.0 | First-class multi-episode narrative rollup. Backed by SagaNode with bi-temporal watermarks. Returns SagaNode. |
EpisodeType.fact_triple | v0.29.0 | Direct fact-triple ingestion (no LLM extraction step). |
EpisodicNode.episode_metadata: dict | v0.29.0 | Customer-defined filtering key. |
_extract_and_resolve_nodes(episodes: list[EpisodicNode]) | v0.29.0 | Multi-episode batched node extraction; sets episode_indices on each node. |
extract_edges(episodes: list[EpisodicNode]) | v0.29.0 | Multi-episode batched edge extraction (concatenates with [Episode N] headers). |
extract_timestamps / extract_timestamps_batch | v0.29.0 | Decoupled valid_at / invalid_at post-extraction step. |
FalkorDriver(falkor_db=AsyncFalkorDB(...)) | v0.29.2 | Embedded FalkorDB Lite injection. |
graphiti-core[falkordblite] extra | v0.29.2 | pip install graphiti-core[falkordblite] for embedded mode (Python 3.12+). |
OpenAIGenericClient default structured_output_mode="json_schema" w/ json_object fallback | v0.29.2 (#1537) | Pragmatic structured-output for OpenAI-compatible endpoints. |
Anti-patterns (D-series, new in v0.29.x)
- Don't pin to
graphiti-core < 0.28.2if you also use the MCP server. Themcp-v1.0.2advisory is verbatim: "MCP v1.0.1 and prior has a security cypher injection vulnerability viagraphiti-core0.28.1." Usemcp >= 1.0.2+graphiti-core >= 0.28.2. - Don't parse
[Episode N]headers assuming 1-based indexing. v0.29.0 switched to 0-based. Updateepisode_indicesconsumers accordingly. - Don't import ops modules directly (e.g.
from graphiti_core.driver.falkordb.operations.entity_edge_ops import FalkorEntityEdgeOperations). v0.28.0 redesigned the architecture; ops are injected viaFalkorDriver._entity_edge_opsproperty. Direct import will break. - Don't assume
FalkorDB Liteis unavailable. v0.29.2 addedgraphiti-core[falkordblite]extra (Python 3.12+). For embedded mode passFalkorDriver(falkor_db=AsyncFalkorDB(dbfilename=...)). - Don't hard-code
gpt-4o-minias the default. v0.29.2 #1551 promotedgpt-5.5as the upstream default with model-tied reasoning effort. Override withOpenAIClient(config=LLMConfig(model="your-model")). - Don't use
EpisodeType.textfor Cianfhoghlaim product/catalog updates —EpisodeType.jsonbypasses entity extraction prompts and is ~10× faster. - Don't assume the docs live at
help.getzep.com/graphiti/graphiti/.... The Cianfhoghlaim.env.exampleshould setGRAPHPITI_DOCS_URL=https://help.getzep.com/graphiti(root, no double prefix) for the OpenSpec "live-docs" verification.
Saga watermarks
# Both last_summarized_at (wall-clock filter) and
# last_summarized_episode_valid_at (temporal public watermark)
add_saga_watermarks: True
Live-docs verification (Agent 81 — 2026-06-29)
Wave 2 verified graphiti-core 0.29.2 is still the latest on PyPI & GitHub as of 2026-06-29.
No release between Wave 1 (2026-06-28) and Wave 2 (2026-06-29).
Next scheduled re-verify: when 0.29.3 tags appear on github.com/getzep/graphiti/releases
or when 0.30.0 ships. Bookmark https://github.com/getzep/graphiti/releases.atom for
RSS watching.
CCC anchors (existing + new)
graphiti_core/graphiti.py:980—add_episodedefinition (line verified)graphiti_core/driver/falkordb_driver.py:124—FalkorDriverclassgraphiti_core/driver/falkordb_driver.py:113—default_group_id: str = '_'(new in v0.29.x)graphiti_core/nodes.py—EpisodeTypecanonical locationgraphiti_core/search/search_config_recipes.py— search recipes (NODE_HYBRID_SEARCH_RRF, etc.)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |