Verified for v0.4.4 on
Quickstart
This guide covers Sythoria Desktop v0.4.4, tagged from source revision d256fb7.
The downloads page reads the files attached to the latest published GitHub release. A version tag can appear before its installers finish building or before a draft release is published, so the page does not guess file URLs.
The v0.4.4 build configuration targets:
| Operating system | Build |
|---|---|
| Windows 10 or 11 | x64 setup executable |
| macOS 12 or later | Apple silicon disk image |
| Linux x86_64 | Debian package, RPM package, or AppImage |
Windows ARM64, Linux ARM64, and Intel Mac builds are not configured for this release.
Install Sythoria#
Windows Desktop
Windows 10/11 · x64 Setup
Installation steps
Download the setup installer
Open the downloads page and choose the Windows setup file attached to the current published release.
- Run the downloaded setup executable.
- Follow the installer prompts.
- Open Sythoria from the Start menu.
Connect a model
Open Settings, add a provider, and run its connection check.
Use the downloads page to see the files that are actually available. GitHub is the final source for release files and signatures.
Connect a model#
- Open Sythoria and go to Settings > AI Models & API Keys.
- Select Add Model.
- Choose a provider preset or enter a custom OpenAI-compatible endpoint.
- Check the API base and model ID.
- Enter the provider credential if the endpoint requires one.
- Save the model and run its connection check.
- Start a conversation, select that model, and send a short test message.
Credentials are encrypted in secrets.enc. The root encryption key is stored in the operating system credential vault.
Preset values#
| Provider | Default model | Setup guide |
|---|---|---|
| OpenAI | gpt-5.6-sol | OpenAI |
| Anthropic | claude-opus-5 | Anthropic |
| Google Gemini | gemini-3.1-pro | Gemini |
| Ollama | deepseek-r1:7b | Ollama |
| OpenRouter | anthropic/claude-sonnet-5 | OpenRouter |
| NVIDIA NIM | meta/llama-3.3-70b-instruct | NVIDIA NIM |
These are editable defaults from the desktop source. A provider can rename, restrict, or remove a model independently of Sythoria.
Check the setup#
A working configuration should pass its connection check, stream a short reply, and remain available after restarting the app.
If it fails, note the status code and remove credentials, prompts, and local paths before sharing the error. See Troubleshooting & Logs.
Where to go next#
- Project Workspaces explains local file tools and worktree review.
- Search & Page Fetching covers Google, SearXNG, Firecrawl, and Jina Reader.
- Privacy & Security lists each network and storage boundary.