Getting Started
FaynOS runs entirely on your device. There is no cloud account required to run agents — your data never leaves your machine.
1. Download FaynOS
Head to the Download page and grab the build for your platform. FaynOS is available for macOS (Apple Silicon and Intel), Windows 10/11, and Linux (AppImage and .deb).
Verify the SHA-256 checksum shown on the download page before installing.
2. Install and launch
macOS: Open the .dmg, drag FaynOS to Applications, and launch it. You may need to allow it in System Preferences → Security on first run.
Windows: Run the .exe installer. FaynOS will register the faynos:// protocol handler automatically.
Linux: Make the AppImage executable and run it, or install the .deb with dpkg -i.
3. Activate your licence
On first launch, FaynOS will prompt for your licence token. Your token is in the email you received when you registered — it looks like FAYN-FREE-xxxxxxxxxxxxxxxx.
If you haven't registered yet, create a free account first. Activation is instant — no internet connection is required after the first validation.
4. Run your first agent
FaynOS ships with a built-in example agent called Summariser. To run it:
- Open the Agent Studio from the sidebar
- Click New Run on the Summariser agent
- Paste any text into the input field and click Run
The run log will appear in real time. All execution happens locally — no API calls are made unless your agent explicitly defines an outbound tool.
5. Browse the Store
The FaynOS Store has community-published agents, teams, and processes you can install with one click. Every listing shows its capability profile so you know exactly what permissions it requests before you install.
# Install an agent from the store via CLI (coming soon)
faynos install <handle>