Metadata-Version: 2.5
Name: alldayrec
Version: 0.4.0
Summary: AllDayRec: an open-source Plaud for your whole day, so your agent knows you. Record with your own devices to build a personal memory on your own server that your agent can query.
Project-URL: Homepage, https://github.com/suyiiyii/alldayrec
Project-URL: Documentation, https://suyiiyii.github.io/alldayrec/
License-Expression: MIT
Requires-Python: <3.15,>=3.11
Requires-Dist: anyio>=4.15.1
Requires-Dist: fastapi>=0.115
Requires-Dist: httpx2>=2.13.1
Requires-Dist: kaldi-native-fbank==1.22.3
Requires-Dist: numpy>=1.26
Requires-Dist: onnxruntime==1.30.0
Requires-Dist: scikit-learn>=1.9.1
Requires-Dist: scipy>=1.17.1
Requires-Dist: uvicorn>=0.32
Requires-Dist: websockets>=17.1
Provides-Extra: local
Requires-Dist: sherpa-onnx-core>=2.0.0; extra == 'local'
Requires-Dist: sherpa-onnx>=2.0.0; extra == 'local'
Description-Content-Type: text/markdown

<div align="center">

<img src="https://raw.githubusercontent.com/suyiiyii/alldayrec/main/docs/public/brand/mark-light.svg" height="48" alt="">

# AllDayRec（全天录）

读作 **all day rec**。

### 开源心力球，让 Agent 更懂你。

用你已有的设备记录每一天：戴着录、用手机录，或导入其他设备的录音，都整理成你自己服务器上、Agent 能查询的个人记忆。

**中文** | [English](https://github.com/suyiiyii/alldayrec/blob/main/README.en.md)

<img src="https://raw.githubusercontent.com/suyiiyii/alldayrec/assets/img/live-captions-zh-summary-20261026.gif" width="240" align="top" alt="实时页：边说边出字幕，AI 实时摘要跟着更新"> <img src="https://raw.githubusercontent.com/suyiiyii/alldayrec/assets/img/timeline-zh-named-20261026c.png" width="240" align="top" alt="时间线：进行中的对话、到期待办、每天的对话"> <img src="https://raw.githubusercontent.com/suyiiyii/alldayrec/assets/img/conversation-zh-summary-20261026.png" width="240" align="top" alt="一段对话：摘要、待办和决定，每条都能点开听原声">

实时字幕 · 时间线 · 一段对话

[在线体验](https://suyiiyii.github.io/alldayrec/demo/)

</div>

全天录是跑在你自己服务器上的全天录音和记忆服务。用手机、开源录音设备或飞书录音豆从早录到晚，服务器在一分钟内把音频变成带说话人的转写，再整理成一天的时间线：对话摘要、认出的人、待办和每日回顾。原始录音一直留着，每句话都能点开听原声。你的 Agent 可以通过 MCP 查你的每一天。

## 能做什么

- **用你已有的设备**：飞书录音豆（仅安卓）和开源录音设备直接连 App 实时同步；其他设备的录音文件可以导入；没有设备，安卓、iPhone App 和浏览器都能直接录。
- **两层转写**：定稿交给云端语音识别（默认阿里云百炼千问，约 ¥0.05/小时音频），页面开着时几秒内出初稿；也可以 `ENGINE=local` 在本机转写。
- **认人**：认得出你自己，记得你给别人起的名字。
- **记忆**：对话摘要、待办和截止日期、每日回顾、全文搜索。
- **开放**：网页、远程 MCP 端点（Claude Code、Codex、Cursor）、命令行。
- **导入已有录音**：在网页上选录音文件[导入](https://suyiiyii.github.io/alldayrec/how-to/import-recordings.html)。

<div align="center">

[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/suyiiyii/alldayrec/blob/main/LICENSE)
[![PyPI](https://img.shields.io/pypi/v/alldayrec)](https://pypi.org/project/alldayrec/)
[![Release](https://img.shields.io/github/v/release/suyiiyii/alldayrec?filter=v*&label=release)](https://github.com/suyiiyii/alldayrec/releases)
[![Android APK](https://img.shields.io/github/v/release/suyiiyii/alldayrec?filter=apk-v*&label=Android%20APK)](https://github.com/suyiiyii/alldayrec/releases)
[![Docker image](https://img.shields.io/badge/ghcr.io-alldayrec-2496ed?logo=docker&logoColor=white)](https://github.com/suyiiyii/alldayrec/pkgs/container/alldayrec)
[![GitHub stars](https://img.shields.io/github/stars/suyiiyii/alldayrec?style=flat)](https://github.com/suyiiyii/alldayrec)

[文档](https://suyiiyii.github.io/alldayrec/) · [快速开始](https://github.com/suyiiyii/alldayrec/blob/main/README.md#快速开始) · [和市面产品比](https://suyiiyii.github.io/alldayrec/explanation/intro.html#和市面产品比) · [硬件](https://github.com/suyiiyii/alldayrec/blob/main/README.md#硬件) · [路线图](https://suyiiyii.github.io/alldayrec/explanation/roadmap.html) · [让 AI Agent 帮你部署（SKILL.md）](https://suyiiyii.github.io/alldayrec/SKILL.md)

`#自部署` `#全天录音` `#说话人识别` `#MCP` `#开源硬件`

</div>

## 架构

<a href="https://raw.githubusercontent.com/suyiiyii/alldayrec/assets/img/architecture-wide-zh-light-name-20261026.png">
<img alt="架构图：开源录音设备、飞书录音豆和手机麦克风经手机 App 上传，浏览器的 /record 页直接上传；自部署服务器先存下音频，再做语音检测、语音识别、认人，大模型写摘要；网页、MCP 和命令行读取结果" src="https://raw.githubusercontent.com/suyiiyii/alldayrec/assets/img/architecture-wide-zh-light-name-20261026.png">
</a>

每个部分做什么、数据怎么流，见[架构与数据流](https://suyiiyii.github.io/alldayrec/explanation/architecture.html)。

## 快速开始

需要一把[阿里云百炼（DashScope）](https://bailian.console.aliyun.com/)北京区的 API key，语音识别和大模型可以共用这一把；用别的引擎见[如何更换语音识别引擎](https://suyiiyii.github.io/alldayrec/how-to/change-asr-engine.html)。三种跑法任选一种。

### 用 uvx（最省事）

需要 [uv](https://docs.astral.sh/uv/)（Python 3.11–3.14，没有的话 uv 自己下载）和 ffmpeg。在一个空目录里建 `.env`：

```ini
DASHSCOPE_API_KEY=<你的百炼 key>
LLM_API_KEY=<同一把百炼 key>
LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
LLM_MODEL=qwen-plus
```

运行 `uvx --env-file .env alldayrec`，在这台电脑上打开日志里 `first start: ...` 那一行的链接。pip 安装、数据目录和让手机连上：[如何用 uvx 或 pip 运行](https://suyiiyii.github.io/alldayrec/how-to/run-uvx.html)。

### 用 Docker

```bash
git clone https://github.com/suyiiyii/alldayrec && cd alldayrec
cp .env.example .env    # 填 DASHSCOPE_API_KEY 和 LLM_API_KEY
mkdir -p data && echo '[{"id": "main", "token": "'$(openssl rand -hex 16)'", "data": "/data/main", "recordings": "/data/main/recordings"}]' > data/tenants.json && chmod 600 data/tenants.json
docker compose up -d && docker compose logs -f
```

打开 `http://<服务器 IP>:8770/?token=<你的 token>`（token 在 `data/tenants.json` 里）。端口、时区、镜像版本和公网访问：[如何用 Docker 部署](https://suyiiyii.github.io/alldayrec/how-to/deploy-docker.html)。

### 从源码运行

需要 uv、ffmpeg、Node 22 和 pnpm。

```bash
git clone https://github.com/suyiiyii/alldayrec && cd alldayrec && cp .env.example .env    # 填 key
(cd web && pnpm install && pnpm build)
cd server && uv sync && set -a && . ../.env && set +a && uv run alldayrec
```

详见[如何从源码运行](https://suyiiyii.github.io/alldayrec/how-to/deploy-without-docker.html)。

### 开始录音

- 安卓：在 [Releases](https://github.com/suyiiyii/alldayrec/releases) 下载最新的 `apk-v*` APK。
- iPhone：用 Xcode 从源码构建安装。
- 浏览器：打开网页的 `/record` 页。

App 的安装和连接见[安装并连接手机 App](https://suyiiyii.github.io/alldayrec/how-to/install-app.html)，从别的设备访问服务器见[让手机连上服务器](https://suyiiyii.github.io/alldayrec/how-to/remote-access.html)。

## 硬件

想全天佩戴，可以接这两种录音设备：

- **开源录音设备**：自己做的 `LR-X1`（Seeed XIAO nRF52840 Sense）或 `LR-P3`（ProMicro nRF52840，装在 3D 打印外壳里），一直往 SD 卡里录，连上手机就同步。零件、接线和固件：[录音设备硬件](https://suyiiyii.github.io/alldayrec/reference/hardware.html)、[`hardware/lr-p3/`](https://github.com/suyiiyii/alldayrec/blob/main/hardware/lr-p3/README.md)、[`firmware/devkit/`](https://github.com/suyiiyii/alldayrec/blob/main/firmware/devkit/README.md)。
- **[飞书录音豆](https://suyiiyii.github.io/alldayrec/how-to/bind-recorder.html#飞书录音豆)**：安卓 App 在「添加录音设备」里直接连接。

## 文档

[suyiiyii.github.io/alldayrec](https://suyiiyii.github.io/alldayrec/)，中英文：

- [教程](https://suyiiyii.github.io/alldayrec/tutorial/first-run.html)：第一次跑起来，看到第一句转写。
- [操作指南](https://suyiiyii.github.io/alldayrec/how-to/run-uvx.html)：部署、让手机连上、绑定录音设备、导入录音、接入 MCP、多人使用、升级和备份。
- [参考](https://suyiiyii.github.io/alldayrec/reference/configuration.html)：配置项、HTTP API、MCP 工具、命令行、数据目录、模型文件、硬件。
- [说明](https://suyiiyii.github.io/alldayrec/explanation/intro.html)：简介与定位、架构与数据流、隐私、语音识别评测。
- [局限与路线图](https://suyiiyii.github.io/alldayrec/explanation/roadmap.html)。

## 参与贡献

欢迎提 [issue](https://github.com/suyiiyii/alldayrec/issues) 和 PR。本地检查和提交说明见[如何参与开发](https://suyiiyii.github.io/alldayrec/how-to/contribute.html)，代码边界、CI 和发布构建见 [CONTRIBUTING.md](https://github.com/suyiiyii/alldayrec/blob/main/CONTRIBUTING.md)（英文）。

## 隐私与法律

录音会录到别人。请告知对方，需要时取得同意，遵守当地法律；有些地方要求所有参与方都同意。数据在你自己的服务器上，音频和文字会发给你选的语音识别服务和大模型，见[隐私与数据去向](https://suyiiyii.github.io/alldayrec/explanation/privacy.html)。

飞书、心力球等名称归各自所有者，本项目与它们没有关联。

## 许可

MIT，见 [LICENSE](https://github.com/suyiiyii/alldayrec/blob/main/LICENSE)。打包进来的第三方代码（Omi devkit、Opus、FireRedVAD 的后处理等）保留各自的许可：[THIRD_PARTY_NOTICES.md](https://github.com/suyiiyii/alldayrec/blob/main/THIRD_PARTY_NOTICES.md)。

## Star history

[![Star History Chart](https://api.star-history.com/svg?repos=suyiiyii/alldayrec&type=Date)](https://star-history.com/#suyiiyii/alldayrec&Date)
