twenty README

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

Twenty logo

The #1 Open-Source CRM

Website · Documentation · Roadmap · Discord · Figma

Twenty banner


Why Twenty

Twenty gives technical teams the building blocks for a custom CRM that meets complex business needs and quickly adapts as the business evolves. Twenty is the CRM you build, ship, and version like the rest of your stack.

Learn more about why we built Twenty


Installation

Cloud

The fastest way to get started. Sign up at twenty.com and spin up a workspace in under a minute, with no infrastructure to manage and always up to date.

Build an app

Scaffold a new app with the Twenty CLI:

npx create-twenty-app my-app

Define objects, fields, and views as code:

import { defineObject, FieldType } from 'twenty-sdk/define';

export default defineObject({
  nameSingular: 'deal',
  namePlural: 'deals',
  labelSingular: 'Deal',
  labelPlural: 'Deals',
  fields: [
    { name: 'name', label: 'Name', type: FieldType.TEXT },
    { name: 'amount', label: 'Amount', type: FieldType.CURRENCY },
    { name: 'closeDate', label: 'Close Date', type: FieldType.DATE_TIME },
  ],
});

Then ship it to your workspace:

npx twenty app:publish --private

See the app development guide for objects, views, agents, and logic functions.

Self-hosting

Run Twenty on your own infrastructure with Docker Compose, or contribute locally via the local setup guide.



Everything you need

Twenty gives you the building blocks of a modern CRM (objects, views, workflows, and agents) and lets you extend them as code. Here's a tour of what's in the box.

Want to go deeper? Read the User Guide for product walkthroughs, or the Documentation for developer reference.

Create your apps

Learn more about apps in doc

 Stay on top with version control

Learn more about version control in doc
All the tools you need to build anything

Learn more about primitives in doc

 Customize your layouts

Learn more about layouts in doc
AI agents and chats

Learn more about AI in doc

 Plus all the tools of a good CRM

Learn more about CRM features in doc

Stack

Thanks

Greptile      Sentry      Crowdin

Thanks to these amazing services that we use and recommend for code review (Greptile), catching bugs (Sentry) and translating (Crowdin).

Join the Community

Star the repo · Discord · Feature requests · Releases · X · LinkedIn · Crowdin · Contribute

twenty (twentyhq/twenty)

Searching Database…

58.5K ·GitHub
Twenty
这是什么？Twenty 是一款开源 CRM，定位是 Salesforce 的替代品，面向技术团队。你可以自定义对象、字段、视图、工作流和智能体，不必受限于封闭的平台。
这是现成的 CRM，还是我可以在上面二次开发的框架？它开箱即可作为完整的 CRM 应用使用，同时也支持像代码一样进行扩展。你可以用与其他技术栈相同的方式对它的改动进行版本管理和发布。
我该如何开始使用 Twenty？你可以在 twenty.com 注册，立即获得托管的工作区；也可以用 Docker Compose 在自己的基础设施上自托管；或者使用 Twenty CLI 搭建自定义应用。
底层运行的技术栈是什么？它是一个 TypeScript 单体仓库，使用 Nx 构建，后端是 NestJS，数据存储基于 PostgreSQL 和 Redis，前端采用 React。
自托管和云端注册一样快吗？不一样。云端版本不到一分钟就能启动一个可用的工作区，无需任何管理；而自托管需要通过 Docker Compose 或本地环境自行搭建基础设施。
Twenty 内置了 AI 功能吗？有。AI 是 Twenty 的核心构件之一，与对象、视图和工作流并列，让你可以直接在 CRM 中构建智能体。
为什么选择 Twenty 而不是 Salesforce？Twenty 是开源的，允许你以代码的方式对 CRM 进行版本管理和扩展，包括自定义对象、字段、工作流和智能体，而不必受限于封闭的专有平台。
What are similar projects?amplication, refine, illa-builder, crm, strapi, Smartstore, rankme.fast, rsschool-app
Which topics is it in?nestjs, good-first-issue, crm, marketing, reactjs, graphql, saas, monorepo, workflow, redis, postgresql, docker-compose
Creator
twentyhq
Size
2.1 GB
Stars
58.5K
Updated
CommitOct 17Releasesdk/v2.48.0Oct 16
Age
3y
Commits · 90 Days