> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memorose.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK

> 当前 Memorose SDK 可用性和服务端检索配置。

# SDK

Memorose 为当前 `/v1` 运行时提供轻量官方 SDK。

## 可用 SDK

| 语言                   | 包名                                    | 说明                    |
| -------------------- | ------------------------------------- | --------------------- |
| Python               | `memorose`                            | 支持 stream 作用域事件和检索    |
| Node.js / TypeScript | `memorose-client`                     | 面向 `/v1` 路由的类型化客户端    |
| Go                   | `github.com/memorose/memorose-sdk/go` | 支持 context 的 HTTP 客户端 |
| Java                 | `dev.memorose.sdk:memorose-client`    | Java 模型类和客户端          |

SDK 与文档中的 REST API 保持一致，并在配置 API key 时发送 `x-api-key`。

## Reranking 和 arbitration

Reranker 模式由服务端配置决定，不在 SDK 构造函数里选择。要使用内部基于模型的 arbitrator 模式，启动服务端时配置：

```bash theme={null}
MEMOROSE__RERANKER__TYPE=arbitrator
MEMOROSE__RERANKER__MODEL=gemini-3.1-flash-lite-preview
MEMOROSE__RERANKER__MAX_CANDIDATES=32
```

请求里的 `enable_arbitration` 字段控制 API 暴露的检索时记忆裁决行为。它不会选择服务端 reranker 实现或模型。

## 直接 HTTP 兜底

如果某个 SDK 还没有暴露新路由，可以直接调用本站记录的 REST API。SDK 本质上是同一套 HTTP 接口的轻量封装。