# Verso

> Verso is a free, open-source native macOS app that wraps the Hermes Agent harness in an intuitive interface, letting non-technical users run AI agents connected to their mail, calendar, notes, and other tools.

Verso is a native macOS application built by Hugo Sanchez that makes it easy for non-technical users to run AI agents against their everyday work tools. It wraps the open-source Hermes Agent harness from Nous Research in a SwiftUI interface, combining local memory, connected apps, and frontier AI models in one place. The project is licensed under AGPL-3.0 and available for free download directly from GitHub.

## What It Is

Verso is an agent orchestrator — a desktop app that coordinates AI models, tool integrations, and local memory so users can ask natural-language questions and have the agent act across multiple services at once. Rather than requiring users to configure agents from scratch, Verso provides a ready-made macOS app that handles the orchestration layer. It sits on top of Hermes Agent, which the homepage describes as "one of the most trusted agent harnesses out there; used by engineering teams, tinkerers, and artists at the frontier."

## Architecture: Verso + Hermes

The app has a layered architecture:

- **Verso** — the native macOS shell (SwiftUI), an embedded React chat interface, and a local Node.js sidecar that manages memory and Hermes integration
- **Hermes Agent** (Nous Research) — the underlying open-source agent harness that provides tools, skills, routines, memory, and browser automation
- **Frontier models** — OpenAI (via Codex device login) and Anthropic Claude (via your own API key), switchable mid-conversation

All local data — chats, memory, connections, and browser data — is stored in a plain SQLite-style database at `~/Library/Application Support/Verso/runtime/local/`, keeping working memory on the user's own machine.

## Connected Apps and MCP Support

Verso connects to external services through Composio, either via Verso's managed service or a user's own Composio project API key. Supported integrations shown on the homepage include Gmail, Google Calendar, Google Drive, Notion, Slack, and Granola MCP. The app also supports any tool that speaks MCP (Model Context Protocol), making it extensible beyond the built-in connectors. In a source build, users can supply their own Composio project key stored in macOS Keychain — no Verso account required.

## Who It's For

The homepage explicitly targets "non-technical folks" who want to leverage frontier AI without configuring agent pipelines themselves. The app handles the complexity of orchestration, memory, and multi-service reads and writes behind a simple chat interface. A typical use case shown on the site involves asking Verso to "catch me up on the board conversation," after which it reads Slack messages, finds Gmail threads, opens a Notion document, and checks Google Calendar — then summarizes the relevant context.

## Update: Verso 1.0.28

The latest release is **v1.0.28**, published on September 9, 2026, available as a `.dmg` download from the GitHub releases page. The repository was created in April 2026 and has been actively updated, with the last push on September 9, 2026. Source builds require an Apple Silicon Mac running macOS 14 or newer, Xcode, Node.js 24, and either a Codex-enabled OpenAI account or an Anthropic API key. The project is open to bug reports, documentation improvements, and focused fixes via GitHub issues.

## Features
- Native macOS app (SwiftUI)
- Built on Hermes Agent (Nous Research)
- Local memory stored on-device in plain database
- Connected apps via Composio (Gmail, Google Calendar, Google Drive, Notion, Slack)
- Custom MCP connector support
- OpenAI Codex and Anthropic Claude model support
- Switchable models mid-conversation
- Embedded React chat interface
- Local chat and session history
- Browser automation via Hermes
- Source build with no Verso account required
- macOS Keychain storage for API keys

## Integrations
Gmail, Google Calendar, Google Drive, Notion, Slack, Granola MCP, OpenAI Codex, Anthropic Claude, Composio, MCP (Model Context Protocol)

## Platforms
MACOS, LINUX, WEB, API, CLI

## Pricing
Open Source

## Version
v1.0.28

## Links
- Website: https://www.itsverso.xyz
- Repository: https://github.com/HugoSanchez/macos-agent-orchestrator
- EveryDev.ai: https://www.everydev.ai/tools/verso