
# SweetHive Agents Node

The **SweetHive Agents Node** is a desktop app for macOS and Windows that runs
your SweetHive agents **on your own computer**. Your agents answer with AI
models executed locally — prompts and content never leave your machine during
inference — and the app can also connect assistants like **Claude** or
**ChatGPT** to your SweetHive content through MCP.

> Using OpenClaw? It keeps working as an alternative runtime: it reads the same
> config bundles. The Agents Node simply makes everything one guided install.

## Install

1. Download the app:
   - [macOS (Apple Silicon)](https://downloads.sweethive.com/agents-node/mac/SweetHive-Agents-Node-arm64.dmg)
   - [macOS (Intel)](https://downloads.sweethive.com/agents-node/mac/SweetHive-Agents-Node-x64.dmg)
   - [Windows](https://downloads.sweethive.com/agents-node/win/SweetHive-Agents-Node-Setup.exe)
2. Open it, review and **accept the terms**.
3. **Sign in with your SweetHive account** (the same email and password as the
   web app).

The app keeps itself up to date automatically. The macOS builds are signed and
notarized by Apple, so they open without warnings.

## Add context agents

A *context agent* is a scoped connection to the hives and contexts you choose —
it can never see more than you can. You can add one from either side, and both
stay in sync:

- **From the app** — *Context agents → New context agent*: name it, pick the
  hives, choose a capability and expiry. It appears in SweetHive → **My agents**
  instantly.
- **From SweetHive web** — *My agents → Connect an agent*: create the token,
  download the config bundle and import it in the app (*Context agents → Import
  config bundle*).

Chat with your agents from **My agents** in SweetHive — replies are generated
on your computer. See [Chat with your agent](/en/chat-with-your-agent/).

## Local models

The Agents Node uses [Ollama](https://ollama.com) to run models locally. The
*Local models* tab detects it (with a download link if it is missing), lets you
pull models — **llama3.2** is a good start — and pick the default one. In
*Settings → Storage folders* you can choose where models, temporary files and
tool libraries are stored.

## Connect Claude or ChatGPT

The *Connect AI apps* tab turns the node into an MCP server for your assistant:

- **Claude Desktop / Claude Code** — copy the ready-made snippet into your
  Claude configuration; the assistant gets tools to list, search and read your
  scoped SweetHive content, plus any local tool servers you add.
- **HTTP endpoint (advanced)** — a local, secret-protected MCP endpoint for
  other clients.

## Privacy & control

- Tokens are scoped, expire, and can be revoked anytime from **My agents**.
- Secrets are stored encrypted with your operating system's key store.
- Model inference runs entirely on your machine.
