graphiti-core 0.22.0rc5__py3-none-any.whl → 0.22.1rc2__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of graphiti-core might be problematic. Click here for more details.

@@ -34,30 +34,13 @@ logger = logging.getLogger(__name__)
34
34
 
35
35
 
36
36
  async def build_indices_and_constraints(driver: GraphDriver, delete_existing: bool = False):
37
- if driver.aoss_client:
38
- await driver.create_aoss_indices() # pyright: ignore[reportAttributeAccessIssue]
39
- return
40
37
  if delete_existing:
41
- records, _, _ = await driver.execute_query(
42
- """
43
- SHOW INDEXES YIELD name
44
- """,
45
- )
46
- index_names = [record['name'] for record in records]
47
- await semaphore_gather(
48
- *[
49
- driver.execute_query(
50
- """DROP INDEX $name""",
51
- name=name,
52
- )
53
- for name in index_names
54
- ]
55
- )
38
+ await driver.delete_all_indexes()
56
39
 
57
40
  range_indices: list[LiteralString] = get_range_indices(driver.provider)
58
41
 
59
- # Don't create fulltext indices if OpenSearch is being used
60
- if not driver.aoss_client:
42
+ # Don't create fulltext indices if search_interface is being used
43
+ if not driver.search_interface:
61
44
  fulltext_indices: list[LiteralString] = get_fulltext_indices(driver.provider)
62
45
 
63
46
  if driver.provider == GraphProvider.KUZU:
@@ -95,8 +78,6 @@ async def clear_data(driver: GraphDriver, group_ids: list[str] | None = None):
95
78
 
96
79
  async def delete_all(tx):
97
80
  await tx.run('MATCH (n) DETACH DELETE n')
98
- if driver.aoss_client:
99
- await driver.clear_aoss_indices()
100
81
 
101
82
  async def delete_group_ids(tx):
102
83
  labels = ['Entity', 'Episodic', 'Community']
@@ -153,9 +134,9 @@ async def retrieve_episodes(
153
134
 
154
135
  query: LiteralString = (
155
136
  """
156
- MATCH (e:Episodic)
157
- WHERE e.valid_at <= $reference_time
158
- """
137
+ MATCH (e:Episodic)
138
+ WHERE e.valid_at <= $reference_time
139
+ """
159
140
  + query_filter
160
141
  + """
161
142
  RETURN
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: graphiti-core
3
- Version: 0.22.0rc5
3
+ Version: 0.22.1rc2
4
4
  Summary: A temporal graph building library
5
5
  Project-URL: Homepage, https://help.getzep.com/graphiti/graphiti/overview
6
6
  Project-URL: Repository, https://github.com/getzep/graphiti
@@ -27,7 +27,7 @@ Requires-Dist: google-genai>=1.8.0; extra == 'dev'
27
27
  Requires-Dist: groq>=0.2.0; extra == 'dev'
28
28
  Requires-Dist: ipykernel>=6.29.5; extra == 'dev'
29
29
  Requires-Dist: jupyterlab>=4.2.4; extra == 'dev'
30
- Requires-Dist: kuzu>=0.11.2; extra == 'dev'
30
+ Requires-Dist: kuzu>=0.11.3; extra == 'dev'
31
31
  Requires-Dist: langchain-anthropic>=0.2.4; extra == 'dev'
32
32
  Requires-Dist: langchain-aws>=0.2.29; extra == 'dev'
33
33
  Requires-Dist: langchain-openai>=0.2.6; extra == 'dev'
@@ -50,7 +50,7 @@ Requires-Dist: google-genai>=1.8.0; extra == 'google-genai'
50
50
  Provides-Extra: groq
51
51
  Requires-Dist: groq>=0.2.0; extra == 'groq'
52
52
  Provides-Extra: kuzu
53
- Requires-Dist: kuzu>=0.11.2; extra == 'kuzu'
53
+ Requires-Dist: kuzu>=0.11.3; extra == 'kuzu'
54
54
  Provides-Extra: neo4j-opensearch
55
55
  Requires-Dist: boto3>=1.39.16; extra == 'neo4j-opensearch'
56
56
  Requires-Dist: opensearch-py>=3.0.0; extra == 'neo4j-opensearch'
@@ -146,6 +146,23 @@ We're excited to open-source Graphiti, believing its potential reaches far beyon
146
146
  <a href="https://arxiv.org/abs/2501.13956"><img src="images/arxiv-screenshot.png" alt="Zep: A Temporal Knowledge Graph Architecture for Agent Memory" width="700px"></a>
147
147
  </p>
148
148
 
149
+ ## Zep vs Graphiti
150
+
151
+ | Aspect | Zep | Graphiti |
152
+ |--------|-----|----------|
153
+ | **What they are** | Complete managed platform for AI memory | Open-source graph framework |
154
+ | **User & conversation management** | Built-in users, threads, and message storage | Build your own |
155
+ | **Retrieval & performance** | Pre-configured, production-ready retrieval with sub-200ms performance at scale | Custom implementation required; performance depends on your setup |
156
+ | **Developer tools** | Dashboard with graph visualization, debug logs, API logs; SDKs for Python, TypeScript, and Go | Build your own tools |
157
+ | **Enterprise features** | SLAs, support, security guarantees | Self-managed |
158
+ | **Deployment** | Fully managed or in your cloud | Self-hosted only |
159
+
160
+ ### When to choose which
161
+
162
+ **Choose Zep** if you want a turnkey, enterprise-grade platform with security, performance, and support baked in.
163
+
164
+ **Choose Graphiti** if you want a flexible OSS core and you're comfortable building/operating the surrounding system.
165
+
149
166
  ## Why Graphiti?
150
167
 
151
168
  Traditional RAG approaches often rely on batch processing and static data summarization, making them inefficient for
@@ -308,6 +325,22 @@ The quickstart demonstrates:
308
325
  The example is fully documented with clear explanations of each functionality and includes a comprehensive README with
309
326
  setup instructions and next steps.
310
327
 
328
+ ### Running with Docker Compose
329
+
330
+ You can use Docker Compose to quickly start the required services:
331
+
332
+ - **Neo4j Docker:**
333
+ ```sh
334
+ docker compose up
335
+ ```
336
+ This will start the Neo4j Docker service and related components.
337
+
338
+ - **FalkorDB Docker:**
339
+ ```sh
340
+ docker compose --profile falkordb up
341
+ ```
342
+ This will start the FalkorDB Docker service and related components.
343
+
311
344
  ## MCP Server
312
345
 
313
346
  The `mcp_server` directory contains a Model Context Protocol (MCP) server implementation for Graphiti. This server
@@ -1,11 +1,11 @@
1
1
  graphiti_core/__init__.py,sha256=e5SWFkRiaUwfprYIeIgVIh7JDedNiloZvd3roU-0aDY,55
2
- graphiti_core/edges.py,sha256=2jA3x-9AGTldB52B5rWUhDtXXsj4PWM-MO1msIPsbdI,21048
2
+ graphiti_core/edges.py,sha256=JZZGo6G2HTYv-aaE-s8P7yIXkdHaNqg5UGGPDV4nZOI,20201
3
3
  graphiti_core/errors.py,sha256=cH_v9TPgEPeQE6GFOHIg5TvejpUCBddGarMY2Whxbwc,2707
4
4
  graphiti_core/graph_queries.py,sha256=ZWMqAo5pwb8PO5ddg4zZ0ArhHWuWV42g3R9ULIxsHOs,8058
5
5
  graphiti_core/graphiti.py,sha256=5DLW6Z7f1OqfD5rHn-pAAIRvwae7meQ7pOFNBCJDhGM,46593
6
6
  graphiti_core/graphiti_types.py,sha256=_v-XsMgV-bBbi5P-PoRVyGJEdHEDJR-Khmv4cU0oZ-4,1094
7
7
  graphiti_core/helpers.py,sha256=q8kbL9gz8igdlh-oMUS-ylUyeMlXZb-ccf-HQkrES_0,5184
8
- graphiti_core/nodes.py,sha256=ox7uDYpaayc5J_mrbMaP-d-jACFx9R7Fb14tvh9aRI8,30426
8
+ graphiti_core/nodes.py,sha256=W_Lx0x3YbJoNRVDGO2Mf9s3MwDFu2NolQl-15jFpr0U,27383
9
9
  graphiti_core/py.typed,sha256=vlmmzQOt7bmeQl9L3XJP4W6Ry0iiELepnOrinKz5KQg,79
10
10
  graphiti_core/tracer.py,sha256=5L05H8PdJ1eqhmcHuYTtwMThVGVUdUzTdiFd_-07H4E,6149
11
11
  graphiti_core/cross_encoder/__init__.py,sha256=hry59vz21x-AtGZ0MJ7ugw0HTwJkXiddpp_Yqnwsen0,723
@@ -14,11 +14,15 @@ graphiti_core/cross_encoder/client.py,sha256=KLsbfWKOEaAV3adFe3XZlAeb-gje9_sVKCV
14
14
  graphiti_core/cross_encoder/gemini_reranker_client.py,sha256=hmITG5YIib52nrKvINwRi4xTfAO1U4jCCaEVIwImHw0,6208
15
15
  graphiti_core/cross_encoder/openai_reranker_client.py,sha256=WHMl6Q6gEslR2EzjwpFSZt2Kh6bnu8alkLvzmi0MDtg,4674
16
16
  graphiti_core/driver/__init__.py,sha256=kCWimqQU19airu5gKwCmZtZuXkDfaQfKSUhMDoL-rTA,626
17
- graphiti_core/driver/driver.py,sha256=sF6CkGLNPIvUgrmWkVws7TvQCskRHiQKJze4Y4ibMmI,3357
18
- graphiti_core/driver/falkordb_driver.py,sha256=Q-dImfK4O2bkikqFzo0Wg2g7iFFRSuzy_c6u82tX6-M,9361
17
+ graphiti_core/driver/driver.py,sha256=haFhY-k8xkhMtTd8esP7IOL0-ffwuYrDRR_BWjmdueI,3473
18
+ graphiti_core/driver/falkordb_driver.py,sha256=i-_v-k6TsPqRCgyjbUs5in3yuciidLhvnNC-AjRB-qs,11344
19
19
  graphiti_core/driver/kuzu_driver.py,sha256=RcWu8E0CCdofrFe34NmCeqfuhaZr_7ZN5jqDkI3VQMI,5453
20
- graphiti_core/driver/neo4j_driver.py,sha256=xiMUvGpW-XFM_2ab5nJJTHoi_LM7CvVZVq6ZO0BbNwc,2380
20
+ graphiti_core/driver/neo4j_driver.py,sha256=XrfxKdIV89TK8q4Am67jY8__5qf5IRoLmrKYS2NWHiU,2705
21
21
  graphiti_core/driver/neptune_driver.py,sha256=dyQcaA5VnpNA_XkaWdvgGN3Q0QqbxWcVIud--yT8qhE,11266
22
+ graphiti_core/driver/graph_operations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
23
+ graphiti_core/driver/graph_operations/graph_operations.py,sha256=9Qxs4za1kUNnpGzkO_z2zX4wPvYq6KWan30WlCH-vw8,5284
24
+ graphiti_core/driver/search_interface/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
25
+ graphiti_core/driver/search_interface/search_interface.py,sha256=-lnPsXdv_4feULbOnuWUQN2wmLqcUkGMwmR74jaFyMI,2500
22
26
  graphiti_core/embedder/__init__.py,sha256=EL564ZuE-DZjcuKNUK_exMn_XHXm2LdO9fzdXePVKL4,179
23
27
  graphiti_core/embedder/azure_openai.py,sha256=OyomPwC1fIsddI-3n6g00kQFdQznZorBhHwkQKCLUok,2384
24
28
  graphiti_core/embedder/client.py,sha256=BXFMXvuPWxaAzPaPILnxtqQQ4JWBFQv9GdBLOXUWgwE,1158
@@ -40,9 +44,9 @@ graphiti_core/llm_client/utils.py,sha256=zKpxXEbKa369m4W7RDEf-m56kH46V1Mx3RowcWZ
40
44
  graphiti_core/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
41
45
  graphiti_core/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
42
46
  graphiti_core/models/edges/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
43
- graphiti_core/models/edges/edge_db_queries.py,sha256=NWmcWkKyXLY1l81PtcTmv68SrT4Cc6QlT7YtfsIQuzY,11050
47
+ graphiti_core/models/edges/edge_db_queries.py,sha256=Y-3VRb4EYMTRl0iDKV3eExk7kKv_gGFAiF1-wRc7niM,11123
44
48
  graphiti_core/models/nodes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
45
- graphiti_core/models/nodes/node_db_queries.py,sha256=TCHZKG5bQNarV9C5k4hOFFqc-LwTVQ8Pnd6okVVNKbo,12826
49
+ graphiti_core/models/nodes/node_db_queries.py,sha256=tDmJmRz51FkepRHEhU6eSukQKZZLPkkeN8YfRAiiKyE,12901
46
50
  graphiti_core/prompts/__init__.py,sha256=EA-x9xUki9l8wnu2l8ek_oNf75-do5tq5hVq7Zbv8Kw,101
47
51
  graphiti_core/prompts/dedupe_edges.py,sha256=nikgVW2P53MtOlT_ycTUyViu2eHFJm2EmQad5ZqfEos,6199
48
52
  graphiti_core/prompts/dedupe_nodes.py,sha256=uQrMPAr019KVUzbOslP3VDLaDG4tXp_BqWEtoY0OHbw,8836
@@ -60,24 +64,24 @@ graphiti_core/search/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hS
60
64
  graphiti_core/search/search.py,sha256=2kj7fybSFv6Fnf_cfEUhJhrpfzNtmkPPZ0hV3BQCDqg,18387
61
65
  graphiti_core/search/search_config.py,sha256=v_rUHsu1yo5OuPfEm21lSuXexQs-o8qYwSSemW2QWhU,4165
62
66
  graphiti_core/search/search_config_recipes.py,sha256=4GquRphHhJlpXQhAZOySYnCzBWYoTwxlJj44eTOavZQ,7443
63
- graphiti_core/search/search_filters.py,sha256=DOAmYkc6A0z20EZId5fJZj1RvLz4WeQcoPANk9k-Sh8,10304
67
+ graphiti_core/search/search_filters.py,sha256=88LiffneuCcSrddH9Gvxua3qlzvh94P-24NITJy3Nzg,8858
64
68
  graphiti_core/search/search_helpers.py,sha256=oty-IHVPf_0HxXsSGx21iPML9hMACDcECmdhkGltmVg,2691
65
- graphiti_core/search/search_utils.py,sha256=ak1aBeKNuxS7szydNHwva2ABWSRlQ0S_v8ZOx7k0wc4,76958
69
+ graphiti_core/search/search_utils.py,sha256=vT0G62T6JXE9bqRJFeLg4dKcHVtJpIOGkmufuvBHw28,71754
66
70
  graphiti_core/telemetry/__init__.py,sha256=5kALLDlU9bb2v19CdN7qVANsJWyfnL9E60J6FFgzm3o,226
67
71
  graphiti_core/telemetry/telemetry.py,sha256=47LrzOVBCcZxsYPsnSxWFiztHoxYKKxPwyRX0hnbDGc,3230
68
72
  graphiti_core/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
69
- graphiti_core/utils/bulk_utils.py,sha256=YpVs5olzrAWVd8pIQ8xi1Ql_IsPdbVSahV1JPuwmG4o,20308
73
+ graphiti_core/utils/bulk_utils.py,sha256=LijfbnUgNfH8BF6DFnmF1YvmKnOIjkJFbcTXo3udzhM,19816
70
74
  graphiti_core/utils/datetime_utils.py,sha256=J-zYSq7-H-2n9hYOXNIun12kM10vNX9mMATGR_egTmY,1806
71
75
  graphiti_core/utils/text_utils.py,sha256=Pth1vkrcHLfBnsPLmoc_F3BtOC73nrDwOIno4g_AF8M,1687
72
76
  graphiti_core/utils/maintenance/__init__.py,sha256=vW4H1KyapTl-OOz578uZABYcpND4wPx3Vt6aAPaXh78,301
73
77
  graphiti_core/utils/maintenance/community_operations.py,sha256=OzNo9DW47YWTy67aoq91wRgnKWVelOYduaJpIERdPFY,10803
74
78
  graphiti_core/utils/maintenance/dedup_helpers.py,sha256=B7k6KkB6Sii8PZCWNNTvsNiy4BNTNWpoLeGgrPLq6BE,9220
75
- graphiti_core/utils/maintenance/edge_operations.py,sha256=obxycUWskKvetQesW5o0opwB7Hw0kssM4LbIcsy0SyI,26778
76
- graphiti_core/utils/maintenance/graph_data_operations.py,sha256=42icj3S_ELAJ-NK3jVS_rg_243dmnaZOyUitJj_uJ-M,6085
79
+ graphiti_core/utils/maintenance/edge_operations.py,sha256=KuBPlFXHnlWM7smLOfaM-ExhPdlakLdyJV4cxO9U4tI,27187
80
+ graphiti_core/utils/maintenance/graph_data_operations.py,sha256=iH_1p9Mm8pg5H3_ORfSrfOPABAOePkgaZu7juBQUAE0,5523
77
81
  graphiti_core/utils/maintenance/node_operations.py,sha256=70G-Kf1mQJ_9XTi9MJmq5dqC28VJHRxkoAwgMRx4Gvo,20143
78
82
  graphiti_core/utils/maintenance/temporal_operations.py,sha256=LWMw8D8-XOZkl412QKa5qOe9vsX_kOhis_dZlwSXY14,3539
79
83
  graphiti_core/utils/ontology_utils/entity_types_utils.py,sha256=4eVgxLWY6Q8k9cRJ5pW59IYF--U4nXZsZIGOVb_yHfQ,1285
80
- graphiti_core-0.22.0rc5.dist-info/METADATA,sha256=RhepBRVrKI7t7Ea3m9x55qZtilrT8G7Dskl9egGBWco,27287
81
- graphiti_core-0.22.0rc5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
82
- graphiti_core-0.22.0rc5.dist-info/licenses/LICENSE,sha256=KCUwCyDXuVEgmDWkozHyniRyWjnWUWjkuDHfU6o3JlA,11325
83
- graphiti_core-0.22.0rc5.dist-info/RECORD,,
84
+ graphiti_core-0.22.1rc2.dist-info/METADATA,sha256=kjObryJ6fd2Ymx76gb7z1uEUIUb8XU-SPSF4AMDQlVU,28666
85
+ graphiti_core-0.22.1rc2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
86
+ graphiti_core-0.22.1rc2.dist-info/licenses/LICENSE,sha256=KCUwCyDXuVEgmDWkozHyniRyWjnWUWjkuDHfU6o3JlA,11325
87
+ graphiti_core-0.22.1rc2.dist-info/RECORD,,