Trigger.dev logo ### Open source background jobs and AI infrastructure [Discord](https://trigger.dev/discord) | [Website](https://trigger.dev) | [Issues](https://github.com/triggerdotdev/trigger.dev/issues) | [Docs](https://trigger.dev/docs) [![Twitter](https://img.shields.io/twitter/url/https/twitter.com/triggerdotdev.svg?style=social&label=Follow%20%40trigger.dev)](https://twitter.com/triggerdotdev)
## About Trigger.dev Trigger.dev is an open source platform and SDK which allows you to create long-running background jobs. Write normal async code, deploy, and never hit a timeout. ### Key features: - JavaScript and TypeScript SDK - No timeouts - Retries (with exponential backoff) - Queues and concurrency controls - Schedules and crons - Full Observability; logs, live trace views, advanced filtering - React hooks to interact with the Trigger API from your React app - Pipe LLM streams straight to your users through the Realtime API - Trigger tasks and display the run status and metadata anywhere in your app - Custom alerts, get notified by email, Slack or webhooks - No infrastructure to manage - Elastic (scaling) - Works with your existing tech stack ## In your codebase Create tasks where they belong: in your codebase. Version control, localhost, test and review like you're already used to. ```ts import { task } from "@trigger.dev/sdk/v3"; //1. You need to export each task export const helloWorld = task({ //2. Use a unique id for each task id: "hello-world", //3. The run function is the main function of the task run: async (payload: { message: string }) => { //4. You can write code that runs for a long time here, there are no timeouts console.log(payload.message); }, }); ``` ## Deployment Use our SDK to write tasks in your codebase. There's no infrastructure to manage, your tasks automatically scale and connect to our cloud. Or you can always self-host. ## Environments We support `Development`, `Staging`, and `Production` environments, allowing you to test your tasks before deploying them to production. ## Full visibility of every job run View every task in every run so you can tell exactly what happened. We provide a full trace view of every task run so you can see what happened at every step. ![Trace view image](https://imagedelivery.net/3TbraffuDZ4aEf8KWOmI_w/7c1b347f-004c-4482-38a7-3f6fa9c00d00/public) # Getting started The quickest way to get started is to create an account and project in our [web app](https://cloud.trigger.dev), and follow the instructions in the onboarding. Build and deploy your first task in minutes. ### Useful links: - [Quick start](https://trigger.dev/docs/quick-start) - get up and running in minutes - [How it works](https://trigger.dev/docs/v3/how-it-works) - understand how Trigger.dev works under the hood - [Guides and examples](https://trigger.dev/docs/guides/introduction) - walk-through guides and code examples for popular frameworks and use cases ## Self-hosting If you prefer to self-host Trigger.dev, you can follow our [self-hosting guide](https://trigger.dev/docs/v3/open-source-self-hosting#overview). We also have a dedicated self-hosting channel in our [Discord server](https://trigger.dev/discord) for support. ## Development To setup and develop locally or contribute to the open source project, follow our [development guide](./CONTRIBUTING.md). ## Meet the Amazing People Behind This Project: