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.
System requirements
| Operating system | Windows 10 or 11 (x64), macOS 11 or later (Apple silicon or Intel), Linux (Ubuntu 20.04 or newer) |
|---|---|
| Memory | 4 GB RAM minimum, 8 GB recommended |
| Storage | About 1 GB of free disk space |
| Computer Use | Optional. 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
Run the installer
Open the
.exeyou downloaded. Kynex installs per-user, so no administrator account is required.First launch on Windows
Windows may ask you to confirm a new app the first time. Choose More info, then Run anyway.
Launch Kynex
Open Kynex from the Start menu. The setup wizard starts automatically.
macOS
Open the disk image
Open the
.dmgand drag Kynex into your Applications folder.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
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.
Welcome
Read the welcome message, accept the terms, and choose Continue.
Language & region
Pick your language. Kynex preselects your system language when it is supported, and falls back to English otherwise.
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.
Choose skills
Select the skill bundles that match what you want to do. You can change this at any time.
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.
- Support — support@xonomo.site
- Sales — sales@xonomo.site
- GitHub — releases and issue tracker