Skip to main content

Common Issues

Symptoms:
  • Unauthorized - Invalid API key error
  • 401 status code on API requests
Solutions:
  1. Verify your API key is correct:
  1. Check environment variables are loaded:
  1. Verify the key format:
  1. Check if the key is revoked:
  • Log into your dashboard
  • Go to API Keys
  • Verify the key status is “Active”
Symptoms:
  • LLM doesn’t call add_item tool
  • No memories appear in database
Solutions:
  1. Verify tools are passed to streamText:
  1. Check system prompt instructs LLM to save:
  1. Verify maxSteps is set:
  1. Test with explicit command:
If this doesn’t work, check your API logs for errors.
Symptoms:
  • LLM doesn’t reference saved memories
  • Responses don’t seem personalized
Solutions:
  1. Verify context is fetched:
  1. Check context is in system prompt:
  1. Verify memories exist:
  1. Check search threshold:
Symptoms:
  • Too Many Requests error
  • 429 status code
Solutions:
  1. Implement exponential backoff:
  1. Batch operations:
  1. Cache context fetches:
  1. Contact support for higher limits
Symptoms:
  • API calls take several seconds
  • Chat feels sluggish
Solutions:
  1. Reduce context limit:
  1. Parallel operations:
  1. Cache embeddings for common queries:
  1. Use streaming:
Symptoms:
  • Type errors in IDE
  • Build fails with type errors
Solutions:
  1. Install type definitions:
  1. Import types correctly:
  1. Check tsconfig.json:
  1. Rebuild packages:
Symptoms:
  • CORS policy error in browser console
  • Requests fail from frontend
Solutions:
  1. Never call Satori API from frontend:
  1. Use server-side API routes:
Symptoms:
  • Memory not found when deleting
  • 404 errors
Solutions:
  1. Verify memory ID:
  1. Check memory belongs to user:
  1. Handle errors gracefully:
Symptoms:
  • Same information saved multiple times
  • Too many similar memories
Solutions:
  1. Check before saving:
  1. Update system prompt:
  1. Periodic cleanup:

Debugging Tips

Enable Verbose Logging

Test Memory Operations Directly

Check Network Requests

Getting Help

If you’re still experiencing issues:

Check Documentation

Review the quickstart guide

GitHub Issues

Report bugs or request features

Community Discord

Get help from the community

Email Support

Contact our support team

Useful Resources