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
What is this?An AI spreadsheet for business — spreadsheet-simple on the surface, a real PostgreSQL database underneath, with AI chat, an app builder, and automations on top of your live data.
Is it just a spreadsheet, or something bigger?Four platforms in one: a PostgreSQL-backed database collaboration platform, an AI workflow engine, an agent sandbox, and an app deployment platform — every published app runs as its own long-lived container.
How do I get started — cloud or self-hosted?Try the hosted cloud at teable.ai, or deploy it yourself: the full AI platform from the teableio/teable-deployment repo, or a standalone install via the Docker guide — up in minutes.
What does a self-hosted deployment need?Standalone runs from Docker; the full AI platform comes from the teableio/teable-deployment repo onto your own machines or cluster. Building from source needs Node 22+ and pnpm 9.13+.
Is anything missing in the lightweight standalone install?Yes — standalone has no AI features and no App Builder; those require Teable Cloud or the full-featured self-host. Tables, collaboration, API, and automation still work.
Do I need to be a developer to use it?No — the pitch is that the whole team builds: describe an app to the agent and it ships wired to your live database, while views, automations, and permissions are configured without code.
Where does it actually run?It's a web app: use the hosted cloud in a browser, or run the whole thing yourself — self-hosted via Docker on your own machines.
Can I run it on my own server or cluster?Yes — the full platform deploys onto your own machines or cluster, and if you start standalone and add the AI runtime later, your data stays in place.
Where does my data live, and can I use my own AI models?On your own infrastructure if you want: everything rests on your own PostgreSQL, AI sessions run in isolated sandbox containers, and you can plug in your own models and keys.
What do I get in the spreadsheet itself, without touching AI?Grid, Form, Kanban, Gallery, and Calendar views; formulas, field conversion, filtering, grouping, sorting, and aggregation; comments, record history, undo/redo, real-time collaboration; attachments preview, batch editing, import/export, search, validation, charts, plugins, SQL query — and millions of rows without breaking a sweat.
How is it different from Airtable?It positions itself as an Airtable alternative built on PostgreSQL you own: data, apps, automations, and permissions live in one place, and the AI operates that live data — so what it builds extends your workflow instead of becoming another silo.
Can my AI coding agent deploy it for me?Yes — hand the teableio/teable-deployment repo to an agent like Claude Code or Codex, give it a domain, a DNS token, and access to the target machine or cluster, and it can take the deployment end to end.
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