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

# people()

> 下载通过人脸识别标注的人员数据

```python theme={null}
client.people() -> pd.DataFrame
```

下载经 AWS Rekognition 人脸识别分析所识别出的人物。

## 返回值

包含人员数据的 `pd.DataFrame`。

## 示例

```python theme={null}
from jmail import JmailClient

client = JmailClient()
people = client.people()

# 照片出现次数最多的人物
top = people.sort_values("photo_count", ascending=False).head(20)
print(top[["name", "photo_count"]])
```

## 列

| 列名 | 类型 | 描述 |
| - | - | - |
| `id` | int | 人员唯一 ID |
| `name` | string | 识别到的姓名 |
| `source` | string | 识别来源 |
| `photo_count` | int | 包含此人员的照片数量 |

## 直接链接

```
https://data.jmail.world/v1/people.parquet
https://data.jmail.world/v1/people.ndjson.gz
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.