پروفایل پروژه

Graphiti

Graphiti برای تیم‌هایی مناسب است که حافظه را به شکل structured و زمان‌مند می‌خواهند. این پروژه نه یک vector database عمومی است، نه یک full agent runtime و نه یک RAG framework استاندارد. ارزش اصلی آن در مدل‌کردن episodeها، حفظ provenance، نگه‌داری تغییرات زمانی و query روی context graph است.

پروفایل مخزنچارچوب temporal knowledge graph برای حافظهٔ ایجنتپیشرفته
temporal memoryknowledge graphprovenancehybrid retrievalstructured context
مسیر/projects/graphiti
نوعچارچوب temporal knowledge graph برای حافظهٔ ایجنت
سطحپیشرفته
شناسه repoGraphiti

getzep/graphiti

پروفایل مستقل برای بررسی پروژه، نه مقاله و نه داشبورد ابزار.

سیگنال‌های سریع

Star27.7k
Fork2.8k
PR144

خلاصهٔ فوری

framework برای temporal knowledge graph memory در AI agents

Star27.7k
Fork2.8k
Commit878
Issue245

نمای پروژه

نمای پروژه

چیست

framework برای temporal knowledge graph memory در AI agents

نیست

نه vector database، نه full agent runtime، نه RAG framework عمومی

مناسب برای

مناسب برای
ساخت حافظهٔ ساخت‌یافته و زمان‌مند برای agentهانگه‌داری provenance و history در contextquery روی facts و relationships تغییرپذیرترکیب semantic، keyword و graph-based retrieval

نامناسب برای

نامناسب برای
فقط یک orchestrator یا workflow engine می‌خواهیمسئلهٔ اصلی تو retrieval pipeline عمومی استنیازی به graph reasoning یا temporal context نداری

سلامت GitHub

سلامت GitHub

Snapshot دستی از مخزن رسمی GitHub برای سنجش مقیاس و فعالیت پروژه؛ این اعداد با زمان تغییر می‌کنند.

Star27.7k
Fork2.8k
Commit878
Issue245
PR144

سطح معماری

سطح معماری

01Episode ingest

Graphiti تعامل‌ها، eventها و observationها را به episode تبدیل می‌کند.

02Entity and fact extraction

از episodeها entity، relationship و fact استخراج می‌شود.

03Temporal graph build

facts با validity window زمانی و provenance در graph نگه‌داری می‌شوند.

04Hybrid query

semantic search، keyword search و graph traversal برای recall ترکیب می‌شوند.

05Incremental update

context graph بدون recomputation کامل با دادهٔ جدید به‌روز می‌شود.

ماتریس توانمندی Agent

ماتریس توانمندی Agent

Temporal reasoning
قوی

graph زمانی برای reasoning روی history و تغییرات مناسب است.

Provenance tracking
قوی

منشأ facts و context در ساختار حفظ می‌شود.

Hybrid retrieval
قوی

retrieval فقط vector-based نیست و traversal را هم پوشش می‌دهد.

Agent runtime
ضعیف

Graphiti agent loop را اجرا نمی‌کند.

Generic RAG pipeline
متوسط

در retrieval-aware workflows مفید است، اما RAG framework عمومی نیست.

جریان اجرا

جریان اجرا / Runtime

1
1. episode جمع کن

interactionها و eventها را به episodeهای قابل‌تحلیل تبدیل کن.

2
2. ساختار را استخراج کن

entityها، relationshipها و factها را از episodeها بیرون بکش.

3
3. graph زمانی بساز

factها را با زمان و provenance در context graph قرار بده.

4
4. query و recall کن

برای context augmentation از retrieval ترکیبی استفاده کن.

5
5. graph را به‌روز نگه‌دار

با داده‌های جدید، graph را incrementally update کن.

ماتریس تناسب

ماتریس تناسب

production-agent-workflowsبالا

برای حافظهٔ ساخت‌یافته و history-aware در production مناسب است.

ontology و fact schema را از ابتدا مشخص کن.

llm-application-developmentبالا

به اپلیکیشن‌های LLM context graph پایدار می‌دهد.

source of truth برای eventها را تعریف کن.

retrieval-augmented-applicationsمتوسط

retrieval را تقویت می‌کند، اما هستهٔ آن RAG pipeline عمومی نیست.

اگر فقط indexing و chunk retrieval می‌خواهی، ابزار سبک‌تر انتخاب کن.

research-experimentationبالا

برای آزمایش روی memory semantics و graph reasoning مناسب است.

metricهای کیفیت memory را قبل از آزمایش تعریف کن.

رادار ریسک

رادار ریسک

Graph modeling complexityزیاد

اگر ontology و fact model ضعیف باشد، graph به‌سختی قابل‌استفاده می‌شود.

Scope ambiguityمتوسط

اگر boundary بین episode، entity و fact روشن نباشد، کیفیت memory افت می‌کند.

Operational overheadمتوسط

structured memory معمولاً هزینهٔ طراحی و نگه‌داری بیشتری نسبت به storage ساده دارد.

Runtime confusionمتوسط

ممکن است اشتباهاً به‌عنوان agent runtime یا orchestrator خوانده شود.

شواهد

شواهد

ارزش یادگیری

ارزش یادگیری

temporal knowledge graph designprovenance-aware memorygraph-based context retrievalstructured long-term memorydistinguishing memory layer from RAG

منابع مرتبط / ابزارها

منابع مرتبط / ابزارها

Project Fit

مناسب چه پروژه‌هایی است؟

این ابزار برای چه پروژه‌هایی مناسب است

Graphiti برای memory graph و knowledge graph مناسب است

وقتی رابطه‌ها، رویدادها و context زمانی مهم هستند، Graphiti خوب جواب می‌دهد. برای agentهای تحقیق، دانش سازمانی و RAG پیشرفته گزینه مناسبی است.

Research EngineerAI Agent BuilderData EngineerPython DeveloperFounder فنیKnowledge Ops

Audience

به درد چه کسانی می‌خورد؟

Research EngineerAI Agent BuilderData EngineerPython DeveloperFounder فنیKnowledge Ops

Use Cases

به درد چه پروژه‌هایی می‌خورد؟

Knowledge Graph

برای ذخیره رابطه‌ها و موجودیت‌ها.

Research Assistant

برای نگه‌داشتن منابع و اتصال مفاهیم.

Incident Memory

برای ثبت رخدادها و ریشه‌یابی.

RAG Augmentation

برای تقویت retrieval با graph context.

Entity Tracker

برای دنبال‌کردن موجودیت‌ها در زمان.

Memory Explorer

برای دیدن ارتباط‌ها به شکل قابل فهم.

Fit

میزان تناسب با پروژه‌ها

Knowledge graphعالی
Research agentsخیلی خوب
Temporal memoryخیلی خوب
Simple chatbotمتوسط
UI-only botضعیف

Flow

چطور ساده پیاده‌سازی می‌شود؟

1entity را تعریف کن
2relationها را ثبت کن
3زمان را مدل کن
4relevance را بسنج
5graph را query کن

Requirements

حداقل پیش‌نیازها

EntitiesRelationsTimestampingQuery layerTest data

Good Fit

چه زمانی انتخاب خوبی است؟

رابطه‌ها و رویدادها مهم هستند.
دانش شما ساختاریافته نیست.
RAG پیشرفته می‌خواهید.
نیاز به memory زمانی دارید.
پروژه پژوهشی یا knowledge محور است.

Bad Fit

چه زمانی انتخاب خوبی نیست؟

فقط یک چت‌بات ساده می‌خواهید.
graph اصلاً لازم نیست.
داده‌ها رابطه‌ای و کوچک هستند.
هیچ query گرافی ندارید.
به memory طولانی‌مدت نیاز ندارید.

Example

نمونه تصمیم واقعی

برای یک research assistant، Graphiti می‌تواند منابع، موجودیت‌ها و ارتباط‌ها را نگه دارد تا پاسخ‌ها به knowledge graph متکی شوند.