API Server

OpenMemory exposes a REST API for language-agnostic integration.

Base URL: http://localhost:8080 (default)

Endpoints

Add a new memory.

Body:

{
  "content": "My cat's name is Luna",
  "user_id": "user_123",
  "tags": ["pet"]
}

Search for memories.

Body:

{
  "query": "What is the pet name?",
  "user_id": "user_123",
  "limit": 3
}

Response:

{
  "memories": [
    {
      "id": "mem_abc123",
      "content": "My cat's name is Luna",
      "score": 0.89
    }
  ]
}

Returns 200 OK if the system is running.

You can run the server using Docker or the Node CLI.

docker run -p 8080:8080 openmemory/server

opm serve --port 9000