pixeltable

环境要求

• 已安装 Python 环境（README 未给出具体版本要求）
• pip 可正常安装第三方包
• 需要可联网访问 PyPI
• 以 Python 库 + pxt 命令行工具两种方式使用

安装与启动步骤

1. 1安装 Pixeltable

   使用 pip 安装 Pixeltable 及其 serve 附加组件，命令中的 extras 需用引号包裹，避免 shell 解析方括号出错。

   pip install 'pixeltable[serve]'

   复制

2. 2初始化环境

   安装完成后执行 pxt init 完成命令行工具的初始化配置，未初始化前后续 pxt 命令可能无法正常使用。

   pxt init

   复制

3. 3生成示例应用

   用内置示例生成一个可运行的 app.py，作为后续创建目录和部署服务的输入文件，可先阅读其内容。

   pxt service example --out app.py

   复制

4. 4创建目录结构

   根据 app.py 中的定义创建名为 my_app 的 catalog 及其表结构，这是后续服务部署依赖的元数据基础。

   pxt schema update app.py my_app

   复制

5. 5部署应用服务

   把 app.py 中定义的服务更新到 my_app 上，README 中这是安装体验流程的最后一步。

   pxt service update app.py my_app

   复制

如何确认成功

以上命令均无报错即视为成功，其中 pxt schema update 会创建目录 my_app；更完整的验证方式见官方 Quickstart 文档。

常见问题

注意事项

• README 中 extras 必须写成 'pixeltable[serve]'，引号不可省略。
• 示例目录名 my_app 来自 README 命令，实际使用时需与 app.py 中定义保持一致。
• Pixeltable Cloud 为限量 Beta，现有安装流程为本地 Python 环境自建。
• 更多用法见官方文档 docs.pixeltable.com 与 quick-start 页面。