Installation

Install Timon

Download the installer for your OS from the download button, then follow the steps below. The builds are not code signed yet, so your OS will warn on first launch. That is expected, not a virus scan result.

macOS (Gatekeeper)

Open the .dmg and drag Timon into Applications.
In Finder, open Applications, then Control-click Timon and choose Open. Confirm Open in the dialog. A double-click is not enough the first time.
If macOS still refuses: System Settings, Privacy & Security, scroll to the message about Timon, then Open Anyway.
Last resort, in Terminal:
```
xattr -dr com.apple.quarantine /Applications/Timon.app
```
Then open Timon from Applications again.

Windows (SmartScreen)

Run the .exe installer.
If Windows protected your PC appears: More info, then Run anyway.
If the file stays blocked: right-click the installer, Properties, Unblock, Apply, then run it again.

Linux

Make the AppImage executable and run it:

chmod +x Timon-*.AppImage
./Timon-*.AppImage

Some desktops also want a right-click, Properties, Allow running as a program.

First launch

Connect the AI subscriptions, API keys or endpoint you already use, then create your first project. Everything runs on your own machine.

If the app does not open

Common blocks, and what to do
What you see	Meaning	What to do
macOS says the app is damaged, or it cannot be opened	Gatekeeper on an unsigned build	Follow the macOS steps above.
Windows protected your PC	SmartScreen on an unsigned installer	More info, Run anyway.
Nothing happens when you open the AppImage	The file is not executable yet	Run the `chmod +x` step above.

Still stuck, or found a bug

Ask on our Discord. Include your OS, the Timon version (from the about screen or timon --version) and what you already tried.