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
Teable
Что это такое?AI-таблицы для бизнеса — снаружи всё просто, как в электронной таблице, а под капотом настоящая база данных PostgreSQL. Сверху — AI-чат, конструктор приложений и автоматизации, работающие с вашими живыми данными.
Это просто таблицы или нечто большее?Четыре платформы в одной: платформа для совместной работы с базой данных на PostgreSQL, движок AI-сценариев, песочница для агентов и платформа для публикации приложений — каждое опубликованное приложение работает в собственном постоянно запущенном контейнере.
Как начать — облако или развернуть у себя?Попробуйте облачную версию на teable.ai или разверните сами: полноценная AI-платформа из репозитория teableio/teable-deployment либо автономная установка по Docker-руководству — всё поднимается за считанные минуты.
Что нужно для самостоятельного развертывания?Автономный вариант запускается через Docker; полноценная AI-платформа берётся из репозитория teableio/teable-deployment и ставится на ваши машины или кластер. Сборка из исходников требует Node 22+ и pnpm 9.13+.
Чего нет в облегчённой автономной установке?В автономном варианте нет AI-функций и конструктора приложений — они доступны только в Teable Cloud или полной версии для самостоятельного размещения. Таблицы, совместная работа, API и автоматизации работают как обычно.
Нужно ли быть разработчиком, чтобы этим пользоваться?Нет — идея в том, что строит вся команда: описываете приложение агенту, и оно готово и подключено к вашей живой базе данных, а представления, автоматизации и права доступа настраиваются без кода.
Где это вообще работает?Это веб-приложение: пользуйтесь облачной версией в браузере или разверните всё у себя — на своих машинах через Docker.
Можно ли запустить это на своём сервере или в кластере?Да — полная платформа разворачивается на ваших машинах или в кластере, а если вы начали с автономного варианта и позже добавите AI-среду, данные останутся на месте.
Где хранятся мои данные и можно ли подключить свои AI-модели?При желании всё остаётся на вашей инфраструктуре: данные лежат в вашем собственном PostgreSQL, AI-сессии идут в изолированных контейнерах-песочницах, а свои модели и ключи можно подключить напрямую.
Что есть в самих таблицах, без всякого AI?Представления Grid, Form, Kanban, Gallery и Calendar; формулы, преобразование типов полей, фильтрация, группировка, сортировка и агрегация; комментарии, история записей, отмена/повтор действий, совместная работа в реальном времени; предпросмотр вложений, пакетное редактирование, импорт/экспорт, поиск, валидация, диаграммы, плагины, SQL-запросы — и миллионы строк без запинки.
Чем это отличается от Airtable?Позиционируется как альтернатива Airtable на принадлежащем вам PostgreSQL: данные, приложения, автоматизации и права доступа живут в одном месте, а AI работает с этими живыми данными — поэтому то, что он создаёт, расширяет ваш рабочий процесс, а не превращается в очередную разрозненную систему.
Может ли мой AI-агент для кодинга развернуть это за меня?Да — передайте репозиторий teableio/teable-deployment агенту вроде Claude Code или Codex, дайте ему домен, DNS-токен и доступ к целевой машине или кластеру, и он доведёт развертывание от начала до конца.
What are similar projects?apitable, nocodb, illa-builder, nocobase, ToolJet, LoomFlow, appsmith, airbyte
Which topics is it in?airtable, internal-tool, app-builder, agent-sandbox, ai-chat, spreadsheet, postgres, byok, low-code, no-code, sandbox, workflow
Creator
teableio
Size
80.1 MB
Stars
21.9K
Updated
CommitOct 16Releaserelease.2026-10-16T07-06-34Z.3445Oct 16
Age
3y
Commits · 90 Days