What is Nerve

Nerve is a Simple Agent Development Kit (ADK) designed to build, run, evaluate, and orchestrate LLM-based agents using YAML and a command-line interface (CLI). It targets technical users seeking programmable, auditable, and reproducible automation with large language models.

Use cases

Use cases for Nerve include automating repetitive tasks, creating intelligent chatbots, conducting data analysis, and developing complex workflows that require coordination between multiple agents.

How to use

To use Nerve, define your agents in a clean YAML format, specifying the system prompt, tasks, tools, and variables in a single file. Then, utilize the CLI to run and manage your agents effectively.

Key features

Key features of Nerve include declarative agents defined in YAML, built-in tools and extensibility with shell commands and Python functions, native MCP support for defining servers in YAML, and an evaluation mode for benchmarking agent performance.

Where to use

Nerve can be used in various fields such as software development, automation, data analysis, and any domain requiring the orchestration of LLM-based agents for complex tasks.

Nerve is a simple yet powerful Agent Development Kit (ADK) to build, run, evaluate, and orchestrate LLM-based agents using just YAML and a CLI. It’s designed for technical users who want programmable, auditable, and reproducible automation using large language models.

Key Features

📝 Declarative Agents

Define agents using a clean YAML format: system prompt, task, tools, and variables — all in one file.

🔧 Built-in Tools & Extensibility

Use shell commands, Python functions, or remote tools to power your agents. Tools are fully typed and annotated.

🌐 Native MCP Support (Client & Server)

Nerve is the first framework to let you define MCP servers in YAML — and act as both client and server, enabling agent teams and deep orchestration.

📊 Evaluation Mode

Benchmark your agents with YAML, Parquet, or folder-based test cases. Run reproducible tests, log structured outputs, and track regression or progress.

🔁 Workflows

Compose agents into simple, linear pipelines to create multi-step automations with shared context.

🧪 LLM-Agnostic

Built on LiteLLM, Nerve supports OpenAI, Anthropic, Ollama, and dozens more — switch models in one line.

Quick Start

# 🖥️ install the project with:
pip install nerve-adk

# ⬇️ download and install an agent from a github repo with:
nerve install evilsocket/changelog

# 💡 or create an agent with a guided procedure:
nerve create new-agent

# 🚀 go!
nerve run new-agent

Read the documentation and the examples for more.

Contributing

We welcome contributions! Check out our contributing guidelines to get started and join our Discord community for help and discussion.

License

Nerve is released under the GPL 3 license.