Pixeltable

项目简介

Pixeltable 是用于视频、图像、音频和文档 AI 应用的开源 Python 库。它以表组织文件引用、计算列、索引和 HTTP 路由，后端集中在 app.py 一个文件中。表中的路径或 URL 保持原位，上传或生成的文件进入媒体存储，可位于本地磁盘或自有存储桶。计算列可采样帧、转写音频、调用模型或生成嵌入；插入一行会运行依赖工作、保存输出并建立索引，无需单独的嵌入并写入任务。FastAPIRouter 可暴露插入和搜索路由，同一 app.py 也可在 Pixeltable Cloud 上运行。

核心功能

• 表可在普通列旁保存文件引用；插入的路径或 URL 保持原位，上传或生成的文件进入媒体存储，可位于本地磁盘或自有存储桶。
• 计算列可采样帧、转写音频、调用模型或生成嵌入；插入一行会运行依赖工作、保存输出并建立索引。
• 嵌入索引在表的 __indexes__ 中声明，无需单独的嵌入并写入任务。
• 依赖跟踪决定运行内容及变更后的重跑范围；新上传只产生新工作，提示词变更只重跑受影响的摘要。
• FastAPIRouter 可暴露插入和搜索路由，整个后端从表到 HTTP 路由都在 app.py 中。
• 同一 app.py 可在 Pixeltable Cloud 运行；pxt db update 将项目上传到托管数据库，命令使用 pxt:// URI。

适用场景

• RAG 与实时 API：文档切分为块，建立嵌入索引，并通过搜索路由提供，增删文档时无需重新嵌入任务。
• 智能体：工具调用即列，每次调用成为可稍后查询的行。
• 媒体流水线：帧和转写结果作为行，可直接导出用于训练。
• 视频搜索：上传视频被转写和摘要，用户可搜索摘要。

快速开始

• 在 Python 3.11 或更高版本上，运行 pip install -U 'pixeltable[serve]' 安装。
• 在 pxt schema update 之前先运行 pxt init。
• 运行 pxt schema update app.py my_app 创建表及其索引。
• 运行 pxt service update app.py my_app 启动服务。
• 使用 Pixeltable Cloud 时，先运行 pxt login，然后用 pxt:// URI 替代 my_app 执行相同命令。

部署与要求

• Python 3.11 或更高版本。
• 通过 pip install -U 'pixeltable[serve]' 安装 serve 附加组件。
• pxt init 是 pxt schema update 的前置条件。
• 媒体可存储在本地磁盘或自有存储桶。
• Pixeltable Cloud：pxt db update 将项目上传到托管数据库，相同的两个命令用其 pxt:// URI 替代 my_app。

采用前须知

• 许可证：Apache-2.0。在使用、修改或分发项目前，请确认其具体条款。