Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Emanuele-web04/synara/llms.txt

Use this file to discover all available pages before exploring further.

Synara ships as a native desktop application for macOS, Linux, and Windows. The fastest way to get started is to download a pre-built release. If you prefer to run directly from source — or you want to follow along with development — you can build it yourself using Bun.
Synara is still early software. Expect bugs, rough edges, and fast-moving internals between releases.

​
Download the desktop app

Pre-built installers are available from two places:

​
Supported platforms

PlatformFormatArchitecture
macOSDMGarm64 (Apple Silicon)
macOSDMGx64 (Intel)
LinuxAppImagex64
WindowsNSIS installerx64
Download the file that matches your platform, run the installer or mount the disk image, and launch Synara.

​
Build from source

If you want to run Synara directly from the repository — for development or to track the latest changes before a release — you can do so with Bun.

​
Prerequisites

1

Clone the repository

git clone https://github.com/Emanuele-web04/Synara.git
cd Synara
2

Install dependencies

From the repository root, install all workspace packages at once:
bun install
3

Start in development mode

The dev script starts the server, web UI, and Electron shell together with hot-reloading:
bun run dev
The Synara window opens automatically once all three processes are ready.
4

Build and run for production

To produce a production build and run it without the dev toolchain:
bun run build
bun run start:desktop
bun run start:desktop launches the built Electron app from apps/desktop.
The dev script runs the server on a dynamically selected port starting at 3773. If you need a fixed port, set the T3CODE_PORT environment variable before starting.

​
Codex setup

Synara talks to OpenAI’s Codex through the Codex CLI, which must be installed and authorized separately on your machine before Codex sessions will work inside Synara.
If you skip Codex CLI setup, Codex sessions will fail to start. Follow the Codex CLI instructions to install and authenticate the CLI before using the Codex provider in Synara.
Other providers (Claude Code, Gemini, Grok, OpenCode, Cursor, Kilo Code, Pi) are managed through Synara’s built-in provider settings and do not require a separate CLI installation.

​
Next steps

Once Synara is installed and running, head to the Quickstart to open your first project and run your first agent session.

Build docs developers (and LLMs) love

Get started for freeTalk to us