Troubleshooting

Graph Not Loading

• Ensure output/entities.json, relationships.json, communities.json, and community_reports.json exist
• Check /api/data/* endpoints return 200
• Retry indexing; watch logs for errors

Indexing Fails

• Verify OPENAI_API_KEY in .env
• Confirm GraphRAG installed: pip install graphrag
• Ensure PDFs were converted to .txt (conversion is automatic on stream start)

Slow 3D Performance

• Reduce visible communities (use Isolator mode)
• Increase minRelationshipWeight or filter entity types
• Avoid extremely dense corpora for initial tests

Memory / Large Corpora

• Index in smaller batches (use Archives to segment datasets)
• Increase Node memory: export NODE_OPTIONS=--max-old-space-size=8192

Embedding Mismatch Warnings (Chat)

• The stream will attempt fallbacks; check logs
• Re-run indexing with consistent embedding settings in settings.yaml