Installation

Python

Requirements: Python 3.11 or higher.

pip install syncopate

For development (includes test and type-checking tools):

pip install syncopate[dev]

From Source

git clone https://github.com/Fixthemusic-com/syncopate.git
cd syncopate/sdk/python
pip install -e ".[dev]"

TypeScript

Requirements: Node.js 18 or higher.

npm install @syncopate/sdk

Or with yarn/pnpm:

yarn add @syncopate/sdk
pnpm add @syncopate/sdk

From Source

git clone https://github.com/Fixthemusic-com/syncopate.git
cd syncopate/sdk/typescript
npm install
npm run build

Bot Token

Every bot needs a token to authenticate. You can create one from your workspace settings:

1. Go to Workspace Settings → Integrations → Bots
2. Click Create Bot
3. Copy the token (starts with bot_)
4. Store it securely — never commit tokens to source control

# Set as environment variable
export BOT_TOKEN=bot_xxxx

Next Steps

• Your First Bot — build an echo bot