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

# Python SDK 概览

> 两个包的分工与使用环境。

Chaintable 的 Python SDK 由几个包组成，打开一个 Notebook 就能直接 `import`，不需要安装：

| 包            | 负责                                                                                   |
| ------------ | ------------------------------------------------------------------------------------ |
| `blockdb`    | 数据存取——[Table / BlockTable / TimeTable / Subscribe / Aligned](/reference/sdk/blockdb) |
| `blockx`     | 计算调度——[Pipeline 以及底层 CallConfig / Handler / Task](/reference/sdk/blockx)             |
| `chaintable` | 平台通用工具，比如 [Secrets](/workspace/secrets)                                              |
| `leafage`    | 轻量 EVM 状态查询                                                                          |

<Warning>
  **SDK 只在平台的 Notebook 运行时里可用，不支持在本地环境 `pip install`。** 所有代码都要在 Notebook 里写、在 Notebook 里跑。
</Warning>

## 该看哪一页

大多数时候你不需要直接翻这两个包的完整方法列表——[数据索引](/indexing/overview) 章节里的教程和指南已经覆盖了日常写管道要用到的部分，尤其是 [用 Pipeline 跑起来](/indexing/run/pipeline)，把 `blockdb` 和 `blockx` 的大部分细节都包掉了。

需要更底层的控制、或者想查一个具体方法的完整参数时，再来这两页：

<Columns cols={2}>
  <Card title="blockdb API" icon="database" href="/reference/sdk/blockdb">
    Table、BlockTable、TimeTable、Subscribe、Aligned 的完整参考
  </Card>

  <Card title="blockx API" icon="cog" href="/reference/sdk/blockx">
    Pipeline 之外的底层 API：CallConfig、ResultHandler、Task、Function 互调用
  </Card>
</Columns>