Troubleshooting

Common issues and solutions for Memphora.

Memory search returns no results

  • Ensure memories have been stored for the user ID you're searching
  • Check that the search query is semantically related to stored memories
  • Try lowering the similarity threshold if using advanced search
  • Verify the vector database is properly initialized

API connection errors

  • Verify the Memphora API server is running on the expected port
  • Check your API endpoint URL is correct
  • Ensure network connectivity and firewall settings
  • Verify authentication credentials if enabled

Slow memory retrieval

  • Check if caching is enabled and working properly
  • Verify database connection pool settings
  • Consider increasing cache size for frequently accessed memories
  • Monitor system resources (CPU, memory, disk I/O)

Memory extraction not working

  • Verify LLM API key is configured correctly
  • Check that the LLM service is accessible
  • Review conversation format - ensure it's a list of messages with 'role' and 'content'
  • Check API logs for error messages

Still Need Help?

If you're still experiencing issues, check out our community resources: