teable README

The project's README from github.com/teableio/teable. As one markdown file: README.md.

teable logo

Turn your data into AI workflows and custom apps that 100% fit your business

One platform where data management, AI workflows, and app building come together — spreadsheet-simple on the surface, real PostgreSQL underneath. Agents work inside your live data and real processes, so what they build lands seamlessly and fits your business exactly. In the cloud or fully self-hosted.

Try out Teable using our hosted version at teable.ai

teableio%2Fteable | Trendshift

Home | Help | Blog | Template | API | Community | X

build Codacy grade GitHub top language

Teable cover

Quick Guide

  1. Want to see it in action? Try Teable on our hosted cloud at teable.ai.
  2. Deploying it yourself? Start from the Deployment guide — standalone in minutes, or the full AI platform on your own machines.

Four platforms in one

AI chat, App Builder, and app deployments are part of Teable, not bolt-ons. Self-hosting Teable deploys four platforms in one:

Self-hosting wraps your own compute into an agent-ready, fully controlled productivity environment — putting AI in the hands of everyone on your team. See Architecture for how the pieces fit together.

✨Features

🤖 AI-native

🍺 Everything you need, out of the box

Grid, Form, Kanban, Gallery, and Calendar views; formulas, field conversion, filtering, grouping, sorting, and aggregation; comments, record history, undo/redo, and real-time collaboration; attachments preview, batch editing, import/export, search, validation, charts, plugins, SQL query — and millions of rows without breaking a sweat.

More features land all the time — see the Changelog.

Deploy

Three ways to run Teable — pick by what you need (full comparison in the Deployment guide):

Teable Cloud Full-featured self-host Standalone self-host
Tables, collaboration, API, automation ✅ ✅ ✅
AI features (chat, agents) ✅ ✅ ❌
App Builder (build & deploy apps) ✅ ✅ ❌
Start here teable.ai teableio/teable-deployment Docker guide

Prefer not to deploy by hand? Hand teableio/teable-deployment to your AI agent (Claude Code, Codex, …) together with a domain, a DNS token, and access to the target machine or cluster — it can take the deployment end to end.

Already running standalone Teable? The runtime plane installs next to it and your data stays in place: migration guide.

Development

1. Initialize

# Enabling the Help Management Package Manager
corepack enable

# Install project dependencies
pnpm install

2. Initialize Postgres

make switch-db-mode

3. Custom Environment Variables(Optional)

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

4. Run Dev Server

you just need to start backend, it will start next server for frontend automatically, file change will be auto reload

cd apps/nestjs-backend
pnpm dev

Why Teable?

Software should fit the work — not the other way around. Every team knows the compromise: you have a concrete business need, you search for an app, and it covers 70% of it. So you bend your process around the tool, or you file a ticket and wait quarters for custom development. The work adapts to the software, when it should be the software adapting to the work.

AI only changes this if it reaches the real workflow. A wave of AI tools can now generate an app on demand — but each one is built in a vacuum: an empty database, no knowledge of how your team actually operates, one more island to integrate and maintain. The demo impresses; the workflow stays the same.

Teable puts the agent where the work already happens. Your data, apps, automations, permissions, and collaborators live here, on a real PostgreSQL — and the AI operates all of it. Chat acts on live data. Automations reason over records as they change. App Builder ships working systems wired to the same database your team already uses — so what gets built is never another silo, but a precise extension of the workflow it came from. AI lands in the work seamlessly, and what it builds fits the business exactly.

And it's an architecture an IT team can say yes to. Self-hosting Teable packages your own compute into an agent-ready platform for the whole team: every AI session confined to an isolated sandbox, every app shipped as a standard container, everything resting on PostgreSQL and HTTP APIs, with your own models and keys, on your own infrastructure. Full AI capability, full control — neither traded for the other.

The result is a different way of building: business systems shaped precisely to your business, delivered in days instead of quarters, evolving as fast as the work itself — by everyone on the team, not just the people who code.

License

This repository is the Teable Community Edition: free for self-hosting under the AGPL-3.0 license (packages under packages/ are MIT). See ./LICENSE for details.

The official image ghcr.io/teableio/teable ships the complete product: free to run, with paid plans unlocking AI features and advanced enterprise capabilities in place — activate with a license key, no image swap, no migration. See pricing and subscribe & activate.

teable (teableio/teable)

Searching Database…

21.9K ·GitHub
这是什么?一款面向企业的 AI 电子表格——表面上是简单的表格,底层是真正的 PostgreSQL 数据库,在实时数据之上还提供 AI 对话、应用搭建器和自动化功能。
它只是一个电子表格,还是更大的东西?四个平台合为一体:基于 PostgreSQL 的数据库协作平台、AI 工作流引擎、智能体沙箱,以及应用部署平台——每个发布的应用都以独立的常驻容器运行。
怎么开始——用云服务还是自己部署?可以先试用 teable.ai 上的托管云服务,也可以自己部署:从 teableio/teable-deployment 仓库部署完整的 AI 平台,或按照 Docker 指南独立安装——几分钟就能跑起来。
自己部署需要什么条件?独立版用 Docker 就能运行;完整的 AI 平台则从 teableio/teable-deployment 仓库部署到你自己的机器或集群上。如果想从源码构建,需要 Node 22+ 和 pnpm 9.13+。
轻量的独立安装版缺了什么吗?有——独立版没有 AI 功能,也没有应用搭建器;这些需要 Teable Cloud 或功能齐全的自托管版本。表格、协作、API 和自动化功能都照常可用。
必须是开发人员才能用吗?不需要——它的理念是全团队一起搭建:向智能体描述一个应用,它就能交付一个连接到你实时数据库的应用,而视图、自动化和权限设置都无需写代码。
它到底能跑在哪里?它是一个网页应用:可以在浏览器里使用托管云服务,也可以自己整套跑起来——通过 Docker 部署在自己的机器上。
能部署到我自己的服务器或集群上吗?可以——完整平台可以部署到你自己的机器或集群上,而且如果你先用独立版、之后再加上 AI 运行时,数据会原样保留。
我的数据存在哪里?能用自己选的 AI 模型吗?愿意的话完全可以放在你自己的基础设施上:所有数据都存放在你自己的 PostgreSQL 里,AI 会话在隔离的沙箱容器中运行,你还可以接入自己的模型和密钥。
不碰 AI 的话,电子表格本身有哪些功能?表格、表单、看板、画册和日历视图;公式、字段类型转换、筛选、分组、排序和汇总;评论、记录历史、撤销/重做、实时协作;附件预览、批量编辑、导入/导出、搜索、数据校验、图表、插件、SQL 查询——而且轻松应对数百万行数据。
它和 Airtable 有什么不同?它把自己定位为基于你自有的 PostgreSQL 的 Airtable 替代品:数据、应用、自动化和权限都集中在一处,AI 直接操作这些实时数据——所以它搭建出来的东西是在扩展你的工作流,而不是又多一个信息孤岛。
我的 AI 编程助手能替我部署它吗?可以——把 teableio/teable-deployment 仓库交给 Claude Code 或 Codex 这样的智能体,给它一个域名、一个 DNS 令牌以及目标机器或集群的访问权限,它就能从头到尾完成整个部署。
Creator
teableio
Size
80.2 MB
Stars
21.9K
Age
3y
Commits · 90 Days