> ## 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.

# Python

> 面向当前 Memorose `/v1` 运行时的 Python SDK。

# Python

安装官方 Python SDK：

```bash theme={null}
pip install memorose
```

基础检索流程：

```python theme={null}
from memorose import MemoroseClient
from memorose.types import IngestRequest, RetrieveRequest

client = MemoroseClient("http://127.0.0.1:3000", "your_api_key")
stream_id = "11111111-1111-1111-1111-111111111111"

client.ingest_event(
    "user_123",
    stream_id,
    IngestRequest(content="Dylan prefers concise summaries.", org_id="default"),
)

response = client.retrieve_memory(
    "user_123",
    stream_id,
    RetrieveRequest(query="What does Dylan prefer?", limit=5, org_id="default"),
)

print(response.results)
```

服务端 reranker 模式，包括 `arbitrator`，在 Memorose 服务启动时配置。SDK 请求不会选择 reranker 模型。
