Nerve

A home for your agents.
Self-hosted AI agent runtime — personal assistants, autonomous workers, and everything in between.

Setup Guide · Architecture · Configuration · Worker Guide · API Reference

---

Nerve is a self-hosted runtime for AI agents, built around the [Claude Agent SDK](https://github.com/anthropics/claude-agent-sdk). It gives agents everything they need to be useful long-term: persistent memory, scheduled execution, task management, learnable skills, and channels to reach you through — web UI, Telegram, or autonomous cron jobs.

Ship a **personal assistant** that develops a personality, remembers your preferences, and manages your inbox. Or deploy a **worker agent** that monitors your CI, reviews PRs, and fixes flaky tests — all plan-driven with human approval. Same engine, different mission.

Quick Start

curl -fsSL https://raw.githubusercontent.com/ClickHouse/nerve/main/install.sh | bash

The installer handles everything — installs dependencies (Python, Node.js, uv), clones the repo, builds the web UI, and launches the interactive setup wizard.

Manual install

**Prerequisites:** [Git](https://git-scm.com/), [Python 3.13+](https://www.python.org/), [uv](https://docs.astral.sh/uv/), [Node.js 18+](https://nodejs.org/)

git clone https://github.com/ClickHouse/nerve.git && cd nerve
uv sync                      # creates .venv from uv.lock
source .venv/bin/activate
cd web && npm ci && npm run build && cd ..
nerve init
nerve start -f

Upgrading

nerve upgrade
nerve restart

Runs `git pull`, reinstalls Python deps, and rebuilds the web UI in o