Install

Get Shatun running on your computer. You can use a packaged app (recommended) or run from source.

Packaged app

1. Open GitHub Releases.
2. Download the build for your platform (when available).
3. Unzip and run the app.

macOS notes

Gatekeeper may block unsigned downloads:

• Right-click the app → Open, or
• Clear quarantine:

xattr -dr com.apple.quarantine /path/to/Shatun.app

Packaged builds can check for updates and install newer versions when they are published.

From source

You need Python 3.14, Node.js + npm, and uv.

git clone https://github.com/13g10n/shatun.git
cd shatun

uv python pin 3.14
uv sync

cd resources
npm install
npm run build
cd ..

uv run shatun

Ways to run

Command	What you get
uv run shatun	Desktop window (recommended while developing)
uv run shatun serve	Browser only at http://127.0.0.1:8765

Next steps

• Connect an AI provider in Settings
• Open a project folder and start a chat
• Read Feedback and support if something goes wrong