Documentation

Kynex documentation

Everything you need to install Kynex, run your first task, and get the most out of your desktop AI assistant. Written for Windows, macOS and Linux.

Last updated: 7 November 2026

Introduction

Kynex is a personal AI assistant that runs as a native desktop application on your own computer. It gives you a clean graphical interface for AI agents that would otherwise require a command line: you type what you want, and Kynex plans and carries out the work on your machine.

Kynex runs as a self-contained desktop application: everything the assistant needs is bundled inside the app, so there is nothing else for you to install or configure. Your files, your tools and your data stay on your computer — Kynex is designed to be private by default.

New here? Start with Installation, then Quickstart. The whole first-run flow takes about a minute.

System requirements

Operating systemWindows 10 or 11 (x64), macOS 11 or later (Apple silicon or Intel), Linux (Ubuntu 20.04 or newer)
Memory4 GB RAM minimum, 8 GB recommended
StorageAbout 1 GB of free disk space
Computer UseOptional. Requires macOS 13+ (Intel or Apple silicon) or Windows 10+ (x64)

Installation

Download the build for your operating system from the download section, then follow the steps for your platform.

Windows

  1. Run the installer

    Open the .exe you downloaded. Kynex installs per-user, so no administrator account is required.

  2. First launch on Windows

    Windows may ask you to confirm a new app the first time. Choose More info, then Run anyway.

  3. Launch Kynex

    Open Kynex from the Start menu. The setup wizard starts automatically.

macOS

  1. Open the disk image

    Open the .dmg and drag Kynex into your Applications folder.

  2. Allow the first launch

    If Gatekeeper blocks the first launch, right-click the app and choose Open, then confirm.

Linux

Kynex ships as an AppImage. Make it executable and run it:

# Linux (AppImage)
chmod +x Kynex-*.AppImage
./Kynex-*.AppImage
Checksums and older builds are published alongside each release, so you can verify what you downloaded.

Quickstart

On first launch, Kynex shows a short welcome message and then the setup wizard. You can be running your first task in about a minute.

  1. Welcome

    Read the welcome message, accept the terms, and choose Continue.

  2. Language & region

    Pick your language. Kynex preselects your system language when it is supported, and falls back to English otherwise.

  3. Connect a model provider

    Add at least one AI provider and paste its API key, or sign in with a browser or device login where the provider supports it. Keys are stored in your operating system keychain, never in a plain text file.

  4. Choose skills

    Select the skill bundles that match what you want to do. You can change this at any time.

  5. Verify and finish

    Kynex tests your configuration and takes you to the main interface.

Then just type your first instruction in the chat box. For example: “Summarise the PDF in my Downloads folder.” or “Create a spreadsheet from the CSV on my desktop.”

Core concepts

Kynex is built from a small number of parts. Understanding these five makes the rest of the documentation easier to read.

  • Agent — an assistant with its own instructions, workspace and chat history. You can create several, each specialised for different work.
  • Gateway — the local runtime that performs the actual AI orchestration. Kynex starts, supervises and recovers it for you automatically; you never manage it by hand.
  • Skill — a capability you can give an agent, such as working with PDFs, spreadsheets or documents. Skills are managed locally.
  • Channel — a way to reach your agent from outside the app, such as a messaging service. Each channel can hold multiple accounts.
  • Scheduled task — a job that runs on a recurring or one-time schedule and can deliver its result to a channel.

Feature guides

The sections below describe each part of Kynex in more detail.

Chat

Chat is where you talk to an agent. It supports multiple sessions with saved history, streaming replies with syntax-highlighted code, tables and maths, and previews of files such as Markdown, Word, PowerPoint and local HTML. Start a new conversation with Ctrl+N on Windows and Linux, or Cmd+N on macOS, or use File → New Chat. You can drop files into the composer, or mention an agent directly with @.

Agents

Create and manage specialised agents from the desktop. Each agent keeps its own workspace and history, so a “Research” agent and a “Documents” agent never mix their work. Deleting a non-default agent asks for confirmation and permanently removes its managed workspace and history, so it cannot be undone.

Skills

Skills extend what an agent can do. Kynex manages them locally and ships with document-processing skills for PDF, Excel, Word and PowerPoint. You can browse the skills available to an agent and enable or remove them without touching configuration files.

Channels

Channels let your agents be reached outside the app. Kynex supports multiple accounts per channel, per-account agent binding, and a default account for each channel. Availability of individual channels depends on your build and configuration; the channel page shows what is connected and its status.

Scheduled tasks

Schedule a task to run once or on a recurring basis, and optionally send the result to a channel. This is useful for routine work such as a morning summary, a recurring report, or watching for a change and notifying you when it happens.

Models & providers

Kynex connects to a wide range of AI providers and lets you switch models per agent. Credentials are stored in the native system keychain. In Developer Mode you can also configure image-generation endpoints, and generated images appear inline in the chat.

Settings

  • Appearance — light, dark, or follow the system theme.
  • Startup — optionally launch Kynex when your computer starts.
  • Proxy — configure a proxy for the app and for channels that need one.
  • Developer Mode — reveals advanced options, including Computer Use and extra model settings.
  • Support — export a diagnostic bundle (with sensitive values removed) to help with troubleshooting.

Computer Use

Computer Use is an optional feature, off by default, that lets an agent operate your desktop — windows, menus, keyboard and mouse — on supported systems. Turn on Developer Mode to reveal it in the sidebar, then enable it on its page. On macOS you must also grant Accessibility and Screen Recording permissions and restart Kynex. Screenshots can be sent to your model provider for the agent to see them, so keep sensitive windows out of captures.

Plans & billing

The Kynex desktop app is free to download and install. Kynex Pro is a one-time purchase of US$19 that unlocks the agent for 31 days. There is no subscription and no automatic renewal — you buy again whenever you want to extend. Refunded orders have their access removed, exactly as purchased.

Payments are handled by our payment processor; Kynex never sees your card details.

Privacy & security

Kynex runs on your computer and keeps your work local. When an agent uses a model provider, the content needed for that task is sent to the provider you configured — nothing more. Provider credentials are kept in your operating system's secure keychain. For the full detail of what is collected and why, read our Privacy Policy, and for the rules of use see our Terms & Conditions.

Troubleshooting

Windows first-launch prompt

This is normal for a newly published application. Choose More info, then Run anyway.

macOS will not open the app

Right-click the app and choose Open, then confirm. If you granted a permission such as Screen Recording, fully quit and restart Kynex afterwards.

An agent cannot see my screen (Computer Use)

Computer Use needs a model that accepts image input and the correct OS permissions. Check that your provider and model support images, then grant Accessibility and Screen Recording on macOS.

The app feels stuck on first start

The local runtime can take a little longer the very first time it prepares a model. Wait for the readiness indicator; if it still does not connect, restart Kynex. If the problem continues, use Settings → Support to export a diagnostic bundle and contact us.

I need more help

Email support@xonomo.site with your operating system and a short description, and attach the diagnostic bundle if you can.

FAQ

Is Kynex free?

The desktop app is free to download. Kynex Pro is a one-time US$19 purchase for 31 days of agent access — no subscription and no auto-renewal.

Which platforms are supported?

Windows 10 and 11, macOS 11 and later, and Linux (AppImage). Availability per platform is shown on the download page.

Do I need an API key?

Yes — you connect at least one AI provider during setup. Keys are stored in your operating system keychain.

Does my data leave my computer?

Your files stay on your machine. Only the content needed for a task is sent to the model provider you chose. See the Privacy Policy for details.

How do updates work?

Kynex checks for a newer release at startup. When one is available you are notified and can download and install it when you are ready — no reinstall needed.

Can I use Kynex for my team?

Yes. Email sales@xonomo.site for team and licensing questions.

Support

We are happy to help with questions, bugs and licensing.