Skip to main content
Plugins live in the Freestyle monorepo, so set that up first. The CONTRIBUTING.md has the full details.

​
Prerequisites

  • Node.js 22+
  • pnpm 10+

​
Setup

1

Clone the repo

2

Install dependencies

3

Start it

This runs the Electron app with hot reload. The embedded server starts on its own. On first launch, macOS asks for Microphone and Accessibility access.

​
Layout

  • apps/electron: the desktop app (main process + React renderer).
  • apps/server: the embedded Hono API.
  • packages/sdk: the freestyle-voice package you build plugins against.
  • plugins: the example plugins.

​
Build

Next: see how plugins work.