Graphiti

🚀 Graphiti 項目

Graphiti 是一款用於構建智能應用的工具，支持多種語言模型和向量數據庫。它與 Neo4j 圖數據庫集成，具備強大的知識表示和檢索能力，能讓複雜的知識管理任務變得簡單高效。

🚀 快速開始

Graphiti 是一個用於構建智能應用的工具，支持多種語言模型（LLM）和向量數據庫。它通過與 Neo4j 圖數據庫集成，提供強大的知識表示和檢索功能。

✨ 主要特性

• 多語言模型支持：兼容 OpenAI、Azure OpenAI 和 Google Gemini 等主流 LLM 服務。
• 向量嵌入：利用文本嵌入技術進行高效的知識檢索。
• 靈活的圖結構：允許用戶自定義節點和邊，構建個性化知識圖譜。
• 強大的檢索能力：提供多種檢索選項，滿足不同應用場景的需求。

📦 安裝指南

安裝 Graphiti

使用 pip 安裝：

poetry add graphiti_core  # 或者
pip install graphiti_core

💻 使用示例

基礎用法

from graphiti_core import Graphiti

# 初始化 Graphiti，連接到本地 Neo4j 實例
graphiti = Graphiti(
    "bolt://localhost:7687",
    "neo4j",
    "password"
)

# 執行查詢
response = graphiti.query("告訴我關於人工智能的基本信息。")
print(response)

高級用法

使用 Azure OpenAI

from openai import AsyncAzureOpenAI
from graphiti_core import Graphiti
from graphiti_core.llm_client import OpenAIClient
from graphiti_core.embedder.openai import OpenAIEmbedder, OpenAIEmbedderConfig

# 配置 Azure OpenAI 服務
api_key = "<你的 API 密鑰>"
api_version = "<你的 API 版本>"
endpoint = "<你的 Azure 端點>"

# 初始化 Azure OpenAI 客戶端
client = AsyncAzureOpenAI(
    api_key=api_key,
    api_version=api_version,
    endpoint=endpoint
)

# 創建 Graphiti 實例，使用 Azure OpenAI 作為 LLM 和嵌入器
graphiti = Graphiti(
    "bolt://localhost:7687",
    "neo4j", 
    "password",
    llm_client=OpenAIClient(client),
    embedder=OpenAIEmbedder(config=OpenAIEmbedderConfig(embedding_model="text-embedding-3-small"), client=client)
)

# 執行查詢
response = graphiti.query("搜索關於機器學習的文章。")
print(response)

使用 Google Gemini

from graphiti_core import Graphiti
from graphiti_core.llm_client.gemini_client import GeminiClient, LLMConfig
from graphiti_core.embedder.gemini import GeminiEmbedder, GeminiEmbedderConfig

# 配置 Google API 密鑰
api_key = "<你的 Google API 密鑰>"

# 初始化 Graphiti 實例，使用 Gemini 作為 LLM 和嵌入器
graphiti = Graphiti(
    "bolt://localhost:7687",
    "neo4j",
    "password",
    llm_client=GeminiClient(config=LLMConfig(api_key=api_key, model="gemini-2.0")),
    embedder= GeminiEmbedder(config=GeminiEmbedderConfig(api_key=api_key))
)

# 執行查詢
response = graphiti.query("解釋量子計算的基本原理。")
print(response)

📚 詳細文檔

• 官方指南與 API 文檔
• 項目源代碼倉庫

🔧 技術細節

當前版本

• 穩定版本：v1.0.0
• 最新開發版：v1.1.0-beta

計劃功能

• 支持更多 LLM 提供商（如 Anthropic）
• 增強向量檢索性能
• 圖數據可視化工具集成

🤝 貢獻指南

歡迎社區參與貢獻！請參考開發者文檔瞭解如何為項目貢獻力量。

代碼規範

• 遵循 PEP8 編碼規範
• 提供單元測試用例
• 確保文檔更新

📞 聯繫方式

如需反饋或技術支持，請聯繫：

• 郵件：support@graphiti-project.com
• Slack 社區：加入社區

通過 Graphiti，您可以輕鬆構建智能應用，將複雜的知識管理任務變得簡單高效。立即開始使用，探索更多可能性！