twentyhq/twenty
ProductivityAn open-source CRM that lets technical teams model data, build apps, and version their workspace with code.
What it is
Twenty is an open-source CRM aimed at technical teams that need to adapt the system as their business changes. Instead of treating customization as a professional-services project, it exposes CRM building blocks — objects, fields, views, workflows, and AI agents — and lets teams define and ship them as code. The product covers standard CRM territory and adds app development, layout customization, version control for app changes, and in-product AI chats and agents.
Quick start
There are three routes. The fastest is the hosted cloud: sign up at twenty.com and create a workspace without managing infrastructure. For self-hosting, follow the Docker Compose guide; contributors can use the local setup guide.
To build a custom app against a workspace, the README gives this flow:
- Install the CLI and scaffold an app:
npm install -g twenty
twenty app init my-app
cd my-app
yarn install
- Define objects and fields in TypeScript, for example a
dealobject with text, currency, and date-time fields usingdefineObjectandFieldTypefromtwenty-sdk/define(schema example). - Authenticate against your workspace and publish privately:
twenty auth login --url https://your-workspace.twenty.com
twenty app publish --private
The app development guide covers objects, views, agents, and logic functions. The repository also ships Twenty app skills for coding agents such as Claude Code, Codex, and Cursor; SKILLS.md explains which skill family is intended for whom (skills note).
Stack and self-hosting
The backend is NestJS with BullMQ, PostgreSQL, and Redis; the frontend is React with Jotai, Linaria, and Lingui, organized as an Nx monorepo (stack). Self-hosting therefore means operating at least a Postgres database and Redis alongside the application services; the Docker Compose guide is the supported path.
Constraints
The workspace URL in the publish example is a placeholder and must be replaced with your own. The agent-skills branch used by the skills install command is generated by the first successful publish from main; until then, the README points to local build instructions instead (skills branch note). Publishing an app requires an authenticated workspace, and the example uses a private publish. Licensing is marked as NOASSERTION on GitHub, so check the repository's license terms before redistributing or embedding it commercially.
HotRepo's take
Twenty has been on HotRepo's radar for a while: an October 2023 Hacker News thread drew 164 points and 67 comments, and a later 2026 thread with the AI-focused tagline drew only a handful of points (2026 thread, 2023 thread). The 2023 discussion exposed the central CRM trade-off: one commenter argued CRMs should be opinionated and enforce best practices, while another replied that without customization people will not buy (discussion). Twenty's answer is to make customization a code workflow rather than an implementation project. The 2023 thread also included early criticism that the demo lacked realistic data volumes (comment), and the maintainer replied that a backend rewrite with a flexible data model was underway (reply). Recent HotRepo snapshots show steady rather than explosive daily gains — 75 stars on 2026-11-19, ranking 9th on the TypeScript daily list, after around 105–112 stars per day in late October 2026. That fits a mature, actively used project rather than a one-off launch spike.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
Hacker News
You might also like
- macro-inc/macroA single all-in-one workspace for small teams replacing the Slack + Notion + Linear + Gmail + CRM stack with one @-linked system.
- warmbly/warmblySelf-hosted cold outreach platform with mailbox warmup, unified inbox, CRM, and deliverability tracking for sales teams.
- melgarafael/DeskcommCRMSelf-hosted WhatsApp sales CRM where AI agents qualify, follow up and hand off to humans.
- Raktim94/nodedr-restaurant-posA self-hosted restaurant POS that keeps billing, kitchen tickets and printing running on a local server when the internet drops.
- ever-co/ever-gauzyAn open ERP/CRM/HRM suite for small teams that want time tracking, invoicing and projects in one self-managed system.