# teable

**Repository Path**: wangxiaopeng2/teable

## Basic Information

- **Project Name**: teable
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-21
- **Last Updated**: 2026-09-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

---
AIGC:
  ContentProducer: '001191110102MAD55U9H0F10002'
  ContentPropagator: '001191110102MAD55U9H0F10002'
  Label: '1'
  ProduceID: '13356152-b5f4-43a2-b7fd-cf2ee4a896f9'
  PropagateID: '13356152-b5f4-43a2-b7fd-cf2ee4a896f9'
  ReservedCode1: '0466766b-f5ea-413b-bdfe-494138e29fe6'
  ReservedCode2: '0466766b-f5ea-413b-bdfe-494138e29fe6'
---

<div align="center"><p><a href="README.en.md">English</a> | <strong>简体中文</strong></p></div>

<div align="center">
  <h1 align="center">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="static/assets/images/teable-vertical-dark.png">
      <img alt="teable logo" height="120" src="static/assets/images/teable-vertical-light.png">
    </picture>
  </h1>
  <h3 align="center"><strong>将你的数据转化为 100% 贴合业务的 AI 工作流与自定义应用</strong></h3>
  <p>一个将数据管理、AI 工作流和应用构建融为一体的平台 —— 表面上是电子表格般的简单易用，底层是真正的 PostgreSQL。AI 智能体在你的实时数据和真实业务流程中运作，因此它们构建出来的东西能够无缝落地，精确贴合你的业务。支持云端使用，也支持完全自托管。</p>
  <p>使用我们的托管版本体验 Teable：<a href="https://teable.ai">teable.ai</a></p>
</div>

<div align="center">
<a href="https://trendshift.io/repositories/8516" target="_blank"><img src="https://trendshift.io/api/badge/repositories/8516" alt="teableio%2Fteable | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
</div>

<p align="center">
  <a target="_blank" href="https://teable.ai">官网</a> | <a target="_blank" href="https://help.teable.ai">帮助文档</a> | <a target="_blank" href="https://teable.ai/blog">博客</a> | <a target="_blank" href="https://teable.ai/templates">模板中心</a> | <a target="_blank" href="https://help.teable.ai/en/api-doc/token">API</a> | <a target="_blank" href="https://community.teable.ai">社区</a> | <a target="_blank" href="https://x.com/teableio">X（推特）</a>
</p>

<p align="center">
  <a aria-label="Build" href="https://github.com/teableio/teable/actions?query=Build%20and%20Push%20to%20Docker%20Registry">
    <img alt="build" src="https://img.shields.io/github/actions/workflow/status/teableio/teable/docker-push.yml?label=Build&logo=github&style=flat-quare&labelColor=000000" />
  </a>
  <a aria-label="Codacy grade" href="https://www.codacy.com/gh/teableio/teable/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=teableio/teable&amp;utm_campaign=Badge_Grade">
    <img alt="Codacy grade" src="https://img.shields.io/codacy/grade/dff9c944af284a0fad4e165eb1727467?logo=codacy&style=flat-square&labelColor=000&label=Codacy">
  </a>
  <a aria-label="Top language" href="https://github.com/teableio/teable/search?l=typescript">
    <img alt="GitHub top language" src="https://img.shields.io/github/languages/top/teableio/teable?style=flat-square&labelColor=000&color=blue">
  </a>
</p>

![Teable 封面](static/assets/images/teable-cover.png)

## 快速上手

1. 想直接体验？在云端托管版 [teable.ai](https://teable.ai) 试用 Teable。
2. 想自己部署？从[部署指南](https://help.teable.ai/en/deploy/choose)开始 —— 几分钟内完成独立部署（Standalone），或在你自己的机器上部署完整 AI 平台。

## 四大平台合一

AI 对话、应用构建器和应用部署都是 Teable 的组成部分，而非事后拼装的外挂。
自托管 Teable 一次部署四个平台：

- **安全、可扩展的智能体沙箱** —— 每个 AI 会话都运行在独立隔离的容器中，按需启动，会话结束后自动销毁。
- **资源高效的应用部署平台** —— 团队构建并发布的每个应用都以独立、轻量、长期运行的容器方式部署。
- **AI 工作流引擎** —— 由记录变更、定时任务和 Webhook 触发的自动化流程，内置 AI 步骤，直接在你的数据所在之处运行。
- **基于 PostgreSQL 的全功能数据库协作平台** —— 表格、视图、权限和 API。

自托管将你自己的算力封装成一个**面向智能体、完全可控的生产力环境** —— 把 AI 交到团队每个人手中。
参见[架构说明](https://help.teable.ai/en/deploy/architecture)了解各组件如何组合在一起。

## ✨功能特性

### 🤖 AI 原生

- **AI 对话** —— 用自然语言查询、分析并操作你的数据。
- **应用构建器** —— 描述你需要的应用；智能体在隔离沙箱中构建它，一键部署到专属 URL。
- **AI 自动化** —— 响应记录变更、定时任务和 Webhook，由 AI 步骤完成推理。
- **AI 字段填充** —— 批量生成和丰富字段值。

### 🍺 开箱即用，应有尽有

网格、表单、看板、画廊和日历视图；公式、字段类型转换、筛选、分组、排序和聚合；评论、记录历史、撤销/重做、实时协作；附件预览、批量编辑、导入/导出、搜索、数据校验、图表、插件、SQL 查询 —— 即使百万行级数据也毫不费力。

更多功能持续上线中 —— 查看[更新日志（Changelog）](https://help.teable.ai/en/changelog)。

## 部署方式

三种方式运行 Teable —— 按需选择（完整对比见[部署指南](https://help.teable.ai/en/deploy/choose)）：

|                                      | **Teable 云端版**        | **功能齐全的自托管**                                        | **独立自托管（Standalone）**                                |
| ------------------------------------ | ------------------------ | ----------------------------------------------------------- | ----------------------------------------------------------- |
| 表格、协作、API、自动化              | ✅                       | ✅                                                          | ✅                                                          |
| AI 功能（对话、智能体）                | ✅                       | ✅                                                          | ❌                                                          |
| 应用构建器（构建与部署应用）            | ✅                       | ✅                                                          | ❌                                                          |
| 从这里开始                           | [teable.ai](https://teable.ai) | [teableio/teable-deployment](https://github.com/teableio/teable-deployment) | [Docker 指南](https://help.teable.ai/en/deploy/docker)      |

不想手动部署？把 [teableio/teable-deployment](https://github.com/teableio/teable-deployment) **交给你的 AI 智能体**（Claude Code、Codex 等），同时提供域名、DNS Token 以及目标机器或集群的访问权限 —— 它可以端到端完成整个部署。

已经在跑独立版 Teable？运行时组件会安装在其旁边，数据保持原位：[迁移指南](https://github.com/teableio/teable-deployment/blob/main/migration/2026-07-basic-to-full-featured.md)。

## 开发

#### 1. 初始化

```sh
# 启用 Corepack（帮助管理包管理器版本）
corepack enable

# 安装项目依赖
pnpm install
```

#### 2. 初始化 PostgreSQL

```sh
make switch-db-mode
```

> 说明：`switch-db-mode` 会执行以下操作：
> 1. 将 `apps/nextjs-app/.env.development*` 中的 `PRISMA_DATABASE_URL` 指向本地 PostgreSQL
> 2. 通过 Docker Compose 启动 `teable-postgres` 容器（postgres:15.4，端口 5432，用户/密码/库均为 `teable`）
> 3. 等待容器健康后执行 Prisma 迁移（`prisma-generate` + `prisma-migrate deploy`）

#### 3. 自定义环境变量（可选）

```sh
cd apps/nextjs-app
cp .env.development .env.development.local
```

#### 4. 运行开发服务器

只需启动后端即可，它会自动启动前端 Next.js 服务器，文件变更会自动热重载：

```sh
cd apps/nestjs-backend
pnpm dev
```

## 为什么选择 Teable？

**软件应该去适应工作，而不是反过来。** 每个团队都清楚那种妥协：你有具体业务需求，找一款应用，它覆盖了 70%。于是你只能让流程去迁就工具，或者提工单等上几个季度做定制开发。工作去适应软件，本应是软件来适应工作。

**AI 只有触及真实工作流才会带来改变。** 一大批 AI 工具现在可以按需生成应用 —— 但它们都是在真空中构建的：空的数据库、对团队实际运作方式一无所知、又多了一个需要集成和维护的信息孤岛。演示很惊艳，工作流却依然故我。

**Teable 让智能体直接嵌入业务真实发生的地方。** 你的数据、应用、自动化、权限和协作者都在这里 —— 一个真正的 PostgreSQL 之上 —— 而 AI 可以操作这一切。对话基于实时数据行动，自动化在记录变更时进行推理，应用构建器交付的系统直连同团队正在使用的数据库 —— 因此构建出的东西绝不再是又一个孤岛，而是工作流的精确延伸。AI 无缝融入业务，它构建出来的东西与业务精确匹配。

**而且这是一套 IT 团队可以放心点头的架构。** 自托管 Teable 把你的算力封装为面向整个团队的智能体平台：每个 AI 会话都限制在隔离的沙箱中，每个应用都以标准容器发布，一切都建立在 PostgreSQL 和 HTTP API 之上，可以使用你自己的模型和密钥，运行在你自己的基础设施上。完整的 AI 能力，完全的控制权 —— 两者不必取舍。

结果是一种全新的构建方式：精确贴合你业务的系统，只需几天而不是几个季度就能交付，并且随着业务本身一样快地演进 —— 由团队中的每一个人共同参与，而不仅仅是写代码的人。

# 许可证

本仓库是 Teable 社区版：根据 AGPL-3.0 许可证免费自托管（`packages/` 下的包为 MIT 许可证）。详见 [./LICENSE](./LICENSE)。

官方镜像 [`ghcr.io/teableio/teable`](https://github.com/teableio/teable/pkgs/container/teable) 提供完整产品：可免费运行，付费计划**原地**解锁 AI 功能和高级企业能力 —— 通过许可证密钥激活，无需替换镜像，无需迁移。参见[价格](https://teable.ai/pricing)和[订阅与激活](https://help.teable.ai/en/deploy/activate)。