Skip to content

Quick Start

This guide walks you through setting up Synatra on your local machine.

Prerequisites

Node.js 22+
pnpm 10+
Docker & Docker Compose

Installation

Clone the repository

git clone https://github.com/synatrahq/synatra.git
cd synatra

Install dependencies
Terminal window
```
pnpm install
```
Configure environment
Terminal window
```
cp .env.example .env
```
Start services
Terminal window
```
make compose-up
```
Apply database migrations
Terminal window
```
make db-migrations-push
```

Access the Application

Service	URL
Console	http://localhost:5173
API Server	http://localhost:8787
Temporal UI	http://localhost:8080

Next Steps

Now that Synatra is running, learn about the core concepts:

Agents - AI executors with versioned configurations
Tools - User-defined functions agents can call
Resources - External integrations with encrypted credentials
Triggers - Cron, webhooks, and app events to start workflows