# GitHub Issues Triage & Categorization **Date**: 2025-10-07 **Total Open Issues**: 100+ **Analysis Scope**: Issues [#451](https://github.com/getzep/graphiti/issues/451) - [#972](https://github.com/getzep/graphiti/issues/972) ## Issue Clusters ### 1. Database Driver Support #### FalkorDB Issues (6 issues) - [#972](https://github.com/getzep/graphiti/issues/972) - [BUG] Vector type mismatch in cosine distance operations - *Component*: `component:database` - *Status*: Open - [#815](https://github.com/getzep/graphiti/issues/815) - [BUG] falkordb query - *Component*: `component:database` - *Status*: Open - [#757](https://github.com/getzep/graphiti/issues/757) - [BUG] run quickstart_falkordb example, get query error - *Component*: `component:database` - *Status*: Open - [#749](https://github.com/getzep/graphiti/issues/749) - [BUG] Official Docker Image doesn't support FalkorDB - *Component*: `component:database`, `component:mcp` - *Status*: Open - [#731](https://github.com/getzep/graphiti/issues/731) - Episode insertion fails due to malformed Cypher query - *Component*: `component:database` - *Status*: Open - [#719](https://github.com/getzep/graphiti/issues/719) - FalkorDB support in MCP-Server - *Component*: `component:mcp`, `component:database` - *Status*: Open #### New Database Support Requests (6 issues) - [#947](https://github.com/getzep/graphiti/issues/947) - Apache AGE Graph DB support - [#933](https://github.com/getzep/graphiti/issues/933) - Support RDF - [#781](https://github.com/getzep/graphiti/issues/781) - More graph database support (NebulaGraph mentioned) - [#779](https://github.com/getzep/graphiti/issues/779) - Postgres with pgvector support - [#644](https://github.com/getzep/graphiti/issues/644) - AWS Neptune driver - [#643](https://github.com/getzep/graphiti/issues/643) - Kuzu driver support (may already be implemented?) - [#642](https://github.com/getzep/graphiti/issues/642) - MemGraph driver **Analysis**: FalkorDB has multiple critical bugs affecting basic operations. Consider deprecating or fixing comprehensively. High demand for alternative backends suggests need for driver abstraction layer. --- ### 2. MCP Server Issues (9 issues) - [#923](https://github.com/getzep/graphiti/issues/923) - [BUG] Switch from SSE (deprecated) to Streamable HTTP - *Priority*: HIGH - using deprecated protocol - *Component*: `component:mcp` - [#945](https://github.com/getzep/graphiti/issues/945) - [BUG] Custom OPENAI_BASE_URL causes NaN embeddings - *Component*: `component:mcp`, `component:llm` - [#848](https://github.com/getzep/graphiti/issues/848) - [BUG] clear_graph tool fails silently (async session bug) - *Component*: `component:mcp` - [#840](https://github.com/getzep/graphiti/issues/840) - [BUG] Failed to validate request (initialization timing) - *Component*: `component:mcp` - [#723](https://github.com/getzep/graphiti/issues/723) - DEFAULT_MAX_TOKENS 8192 too restrictive - *Component*: `component:mcp` - [#578](https://github.com/getzep/graphiti/issues/578) - MCP server with Gemini model - *Component*: `component:mcp`, `component:llm` - [#565](https://github.com/getzep/graphiti/issues/565) - Cross-encoder ignores OPENAI_BASE_URL - *Component*: `component:mcp`, `component:llm` - [#509](https://github.com/getzep/graphiti/issues/509) - MCP server add_nodes tool call doesn't work - *Component*: `component:mcp` **Duplicates in this cluster**: - [#867](https://github.com/getzep/graphiti/issues/867) + [#831](https://github.com/getzep/graphiti/issues/831) - GPT-oss:20 and 120B models (duplicate) - [#787](https://github.com/getzep/graphiti/issues/787) - Rate limit even with SEMAPHORE_LIMIT=1 (marked duplicate) **Analysis**: MCP server has protocol deprecation issue ([#923](https://github.com/getzep/graphiti/issues/923)) and multiple configuration/provider issues. Should be high priority for users relying on MCP integration. --- ### 3. LLM Provider Compatibility (8 issues) - [#902](https://github.com/getzep/graphiti/issues/902) - [BUG] OpenAI internal call broken (reasoning.effort param) - *Component*: `component:llm` - [#878](https://github.com/getzep/graphiti/issues/878) - [BUG] GPT-5 temperature parameter unsupported - *Component*: `component:llm` - [#912](https://github.com/getzep/graphiti/issues/912) - [BUG] Pydantic validation error with deepseek-r1:7b - *Component*: `component:llm` - [#791](https://github.com/getzep/graphiti/issues/791) - [BUG] Small model setting defaults to gpt-4.1-nano - *Component*: `component:llm` - [#790](https://github.com/getzep/graphiti/issues/790) - [BUG] Failed to parse structured response with Gemini - *Component*: `component:llm` - [#868](https://github.com/getzep/graphiti/issues/868) - [BUG] Cannot work with Ollama - *Component*: `component:llm` - [#763](https://github.com/getzep/graphiti/issues/763) - [BUG] LLMConfig.max_tokens not respected - *Component*: `component:llm` - [#760](https://github.com/getzep/graphiti/issues/760) - [BUG] Hallucinations with default models - *Component*: `component:llm` **Additional LLM Provider Requests**: - [#907](https://github.com/getzep/graphiti/issues/907) - VSC Copilot models - [#751](https://github.com/getzep/graphiti/issues/751) - Alibaba Cloud AI model - [#724](https://github.com/getzep/graphiti/issues/724) - Gemini with Google Cloud Credentials - [#459](https://github.com/getzep/graphiti/issues/459) - Amazon Bedrock support **Analysis**: Structured output compatibility is a recurring theme. Many issues stem from providers not supporting OpenAI's structured output format. Documentation should clearly state which providers are fully compatible. --- ### 4. Duplicate Entities (3 issues) - [#963](https://github.com/getzep/graphiti/issues/963) - [BUG] Duplicate entities in Neo4j (marked duplicate) - *Component*: `component:core` - *Status*: Duplicate (see [#875](https://github.com/getzep/graphiti/issues/875)) - [#875](https://github.com/getzep/graphiti/issues/875) - [BUG] Duplicate entities with custom db name - *Component*: `component:core`, `component:database` - *Priority*: HIGH - core deduplication functionality broken - [#774](https://github.com/getzep/graphiti/issues/774) - Same Chinese text extracted as different facts - *Component*: `component:core` **Analysis**: Core deduplication functionality appears broken, especially with custom database names. Critical for production use. --- ### 5. Bulk Upload Issues (3 issues) - [#882](https://github.com/getzep/graphiti/issues/882) - [BUG] IndexError during node resolution - *Component*: `component:bulk` - [#879](https://github.com/getzep/graphiti/issues/879) - ValidationError 'duplicates' field missing - *Component*: `component:bulk` - [#871](https://github.com/getzep/graphiti/issues/871) - Invalid JSON and index errors - *Component*: `component:bulk` **Related**: - [#747](https://github.com/getzep/graphiti/issues/747) - Add progress reporting to bulk upload - [#658](https://github.com/getzep/graphiti/issues/658) - Bulk ingestion not possible (may be duplicate) **Analysis**: Bulk operations are fundamentally broken. Appears to be schema/validation issues in the bulk processing pipeline. --- ### 6. Search Issues (6 issues) - [#810](https://github.com/getzep/graphiti/issues/810) - [BUG] Empty group_id handled inconsistently in search - *Component*: `component:search` - [#801](https://github.com/getzep/graphiti/issues/801) - [BUG] episode_fulltext_search empty results (marked duplicate) - *Component*: `component:search` - [#838](https://github.com/getzep/graphiti/issues/838) - Allow searching across all groups when group_ids is None - *Component*: `component:search` - [#772](https://github.com/getzep/graphiti/issues/772) - [BUG] BFS max_depth parameter ignored - *Component*: `component:search` - [#789](https://github.com/getzep/graphiti/issues/789) - [BUG] BFS returns duplicate edges with swapped source/target - *Component*: `component:search` - [#777](https://github.com/getzep/graphiti/issues/777) - [BUG] MMR reranker RuntimeWarning, no results - *Component*: `component:search` **Related**: - [#488](https://github.com/getzep/graphiti/issues/488) - edge_search_filter_query_constructor creating incorrect query - [#534](https://github.com/getzep/graphiti/issues/534) - retrieve_episodes always returns no results **Analysis**: Search functionality has multiple bugs in filtering, BFS traversal, and reranking. Group ID handling is particularly problematic. --- ### 7. Database Configuration (4 issues) - [#851](https://github.com/getzep/graphiti/issues/851) - [BUG] Search only connects to 'neo4j' db, add_episode works with any name - *Component*: `component:database` - *Priority*: HIGH - inconsistent behavior - [#798](https://github.com/getzep/graphiti/issues/798) - [BUG] Database name not passed through Graphiti object - *Component*: `component:database` - *Priority*: HIGH - related to [#851](https://github.com/getzep/graphiti/issues/851) - [#715](https://github.com/getzep/graphiti/issues/715) - [Feature] Configure Neo4j database name (multi-DB support) - *Component*: `component:database` **Analysis**: Database name configuration is broken. Hardcoded 'neo4j' default causes issues. Related to commit mentioned in CLAUDE.md about hardcoded database names. --- ### 8. Datetime/Timezone Issues (4 issues) - [#920](https://github.com/getzep/graphiti/issues/920) - [BUG] edge_operations.py timezone-naive/aware comparison (marked duplicate) - *Component*: `component:core` - *Status*: Duplicate (possibly fixed in commit 73015e9) - [#893](https://github.com/getzep/graphiti/issues/893) - [BUG] Kuzu driver valid_at datetime format - *Component*: `component:database` - [#606](https://github.com/getzep/graphiti/issues/606) - Add support for datetime fields in custom entities - *Component*: `component:core` **Analysis**: Recent commit 73015e9 "Fix datetime comparison errors by normalizing to UTC" may have addressed some of these. Needs verification. --- ### 9. API/Server Issues (4 issues) - [#961](https://github.com/getzep/graphiti/issues/961) - [Feature Request] Improve Episodes API (UUID, GET by ID, metadata) - *Component*: `component:server` - [#921](https://github.com/getzep/graphiti/issues/921) - SDK client like zep-cloud/zep-python - *Component*: `component:server` - [#566](https://github.com/getzep/graphiti/issues/566) - /messages endpoint doesn't persist episodes - *Component*: `component:server` - [#904](https://github.com/getzep/graphiti/issues/904) - docker-compose.yml env vars override .env - *Component*: `component:server`, `component:mcp` **Analysis**: API functionality gaps and configuration issues. Episode persistence bug is critical. --- ### 10. Error Handling & Validation (3 issues) - [#941](https://github.com/getzep/graphiti/issues/941) - TaskGroup errors (marked duplicate) - *Component*: `component:core` - [#937](https://github.com/getzep/graphiti/issues/937) - ArgumentError with empty query entities - *Component*: `component:core` - [#951](https://github.com/getzep/graphiti/issues/951) - Incorrect try import for AsyncOpenSearch - *Component*: `component:database` **Analysis**: Input validation needs improvement to handle edge cases like empty strings. --- ### 11. Feature Requests - Core Functionality (10 issues) - [#935](https://github.com/getzep/graphiti/issues/935) - Create episodes based on DOM structure - [#934](https://github.com/getzep/graphiti/issues/934) - Flag contradictions on merging facts - [#925](https://github.com/getzep/graphiti/issues/925) - Monitor LLM conversations - [#905](https://github.com/getzep/graphiti/issues/905) - ColbertV2 embeddings with Fastembed - [#864](https://github.com/getzep/graphiti/issues/864) - How to forget knowledge - [#819](https://github.com/getzep/graphiti/issues/819) - Count token usage - [#669](https://github.com/getzep/graphiti/issues/669) - Metadata on chunks for RAG - [#465](https://github.com/getzep/graphiti/issues/465) - Support ignoring non-custom entities - [#467](https://github.com/getzep/graphiti/issues/467) - LLM inference expenses are high **Analysis**: Feature requests range from observability (#925, #819) to advanced RAG features (#669, #905). Token cost reduction ([#467](https://github.com/getzep/graphiti/issues/467)) is recurring concern. --- ### 12. Documentation/Questions (9 issues) - [#913](https://github.com/getzep/graphiti/issues/913) - How to update data in graph - [#909](https://github.com/getzep/graphiti/issues/909) - Reproduce LongMemEval results - [#869](https://github.com/getzep/graphiti/issues/869) - Portuguese: Change OpenAI model - [#853](https://github.com/getzep/graphiti/issues/853) - Document VCS/extension setup - [#828](https://github.com/getzep/graphiti/issues/828) - Get a flowchart - [#701](https://github.com/getzep/graphiti/issues/701) - Chinese video tutorial (informational) - [#484](https://github.com/getzep/graphiti/issues/484) - OpenAIGenericClient documentation - [#530](https://github.com/getzep/graphiti/issues/530) - Cursor AI + OpenRouter setup - [#517](https://github.com/getzep/graphiti/issues/517) - OpenRouter and Voyage setup *Component*: `component:docs` **Analysis**: Many questions indicate documentation gaps, especially around custom LLM provider setup and basic operations. --- ### 13. Code Quality/Refactoring (5 issues) - [#836](https://github.com/getzep/graphiti/issues/836) - [BUG] update_communities broken - *Component*: `component:core` - [#811](https://github.com/getzep/graphiti/issues/811) - Refactor: hoist EXTRACT_EDGES_MAX_TOKENS constant - *Component*: `component:core` - [#681](https://github.com/getzep/graphiti/issues/681) - Refactor: no internal ghost variables - *Component*: `component:core` - [#451](https://github.com/getzep/graphiti/issues/451) - Minor type bug in bulk_utils - *Component*: `component:bulk` - [#717](https://github.com/getzep/graphiti/issues/717) - Adopt uv workspace for monorepo - *Component*: `component:core`, `component:server`, `component:mcp` **Analysis**: Technical debt items. [#717](https://github.com/getzep/graphiti/issues/717) (uv workspace) would improve developer experience for monorepo. --- ### 14. Cloud/Alternative Providers (2 issues) - [#739](https://github.com/getzep/graphiti/issues/739) - MCP server based on zep-cloud - *Component*: `component:mcp` - [#538](https://github.com/getzep/graphiti/issues/538) - Azure Cosmos DB version (informational) --- ### 15. Embeddings/Reranking (3 issues) - [#728](https://github.com/getzep/graphiti/issues/728) - Voyage embedder installation issue - *Component*: `component:core` - [#485](https://github.com/getzep/graphiti/issues/485) - Better Embedder error information - *Component*: `component:core` - [#543](https://github.com/getzep/graphiti/issues/543) - Hard-coded model in OpenAIRerankerClient - *Component*: `component:core` --- ### 16. Miscellaneous Bugs (5 issues) - [#800](https://github.com/getzep/graphiti/issues/800) - Blank disconnected nodes in sample project - *Component*: `component:mcp` - [#686](https://github.com/getzep/graphiti/issues/686) - Relationships not extracted automatically - *Component*: `component:core` - [#687](https://github.com/getzep/graphiti/issues/687) - Unable to add episodes with OpenAI agents SDK - *Component*: `component:core` - [#587](https://github.com/getzep/graphiti/issues/587) - Node type not being set - *Component*: `component:core` --- ## Summary Statistics - **Total Clustered Issues**: 100+ - **Major Clusters**: 16 - **Confirmed Duplicates**: 6 (marked) - **High Priority Bugs**: ~15-20 - **Feature Requests**: ~20 - **Documentation Gaps**: ~10 ## Component Breakdown - `component:core` - 25+ issues - `component:database` - 20+ issues (includes all DB drivers) - `component:mcp` - 12+ issues - `component:llm` - 12+ issues - `component:search` - 8+ issues - `component:bulk` - 5+ issues - `component:server` - 4+ issues - `component:docs` - 10+ issues