<h2 align="center">The #1 Open-Source CRM</h2>


# 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](https://twenty.com/resources/why-twenty)


# Installation

###  Cloud

The fastest way to get started. Sign up at [twenty.com](https://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:

```bash
npx create-twenty-app my-app
```

Define objects, fields, and views as code:

```ts
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:

```bash
npx twenty app:publish --private
```

See the [app development guide](https://docs.twenty.com/developers/extend/apps/getting-started) for objects, views, agents, and logic functions.

Building with a coding agent? Install the official [Twenty app skills](./packages/twenty-agent-skills), which work in Claude Code, Codex, Cursor, Pi, and any other harness supported by the `skills` CLI:

```bash
npx skills add https://github.com/twentyhq/twenty/tree/agent-skills --list
```

The `agent-skills` branch is created by the first successful publish from `main`. Until then, use the [local build instructions](./packages/twenty-agent-skills#local-development). [`SKILLS.md`](./SKILLS.md) explains the other skill families in this repository and who they are for.

###  Self-hosting

Run Twenty on your own infrastructure with [Docker Compose](https://docs.twenty.com/developers/self-host/capabilities/docker-compose), or contribute locally via the [local setup guide](https://docs.twenty.com/developers/contribute/capabilities/local-setup).


# 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](https://docs.twenty.com/user-guide/introduction) for product walkthroughs, or the [ Documentation](https://docs.twenty.com) for developer reference.


|  |  |
| --- | --- |
|  |  |
|  |  |


# Stack

- [ TypeScript](https://www.typescriptlang.org/)
- [ Nx](https://nx.dev/)
- [ NestJS](https://nestjs.com/), with [BullMQ](https://bullmq.io/), [ PostgreSQL](https://www.postgresql.org/), [ Redis](https://redis.io/)
- [ React](https://reactjs.org/), with [Jotai](https://jotai.org/), [Linaria](https://linaria.dev/) and [Lingui](https://lingui.dev/)

# Thanks


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](https://github.com/twentyhq/twenty) · [ Discord](https://discord.gg/cx5n4Jzs57) · [ Feature requests](https://github.com/twentyhq/twenty/discussions) · [ Releases](https://github.com/orgs/twentyhq/projects/1/views/35) · [ X](https://twitter.com/twentycrm) · [ LinkedIn](https://www.linkedin.com/company/twenty/) · [ Crowdin](https://twenty.crowdin.com/twenty) · [ Contribute](https://github.com/twentyhq/twenty/contribute)