Nerve

by evilsocket

MCP Client 1,062 stars
  • agent-framework

The Simple Agent Development Kit.

About

What is Nerve?

Nerve is a simple yet powerful Agent Development Kit (ADK) for building, running, evaluating, and orchestrating LLM-based agents using only YAML and a CLI. It is designed for technical users who want programmable, auditable, and reproducible automation with large language models.

How to use Nerve?

Install Nerve with pip install nerve-adk. Download an existing agent from a GitHub repository using nerve install (e.g., nerve install evilsocket/changelog), create a new agent with the guided nerve create new-agent command, and run it with nerve run new-agent.

Key features of Nerve

- Declarative agents defined entirely in YAML (system prompt, task, tools, variables)
- Built-in tools and extensibility via shell commands, Python functions, or remote tools
- Native MCP support – acts as both client and server, can define MCP servers in YAML
- Evaluation mode with YAML, Parquet, or folder-based test cases and structured outputs
- Workflows – compose agents into simple, linear pipelines with shared context
- LLM-agnostic – built on LiteLLM, supports dozens of providers (OpenAI, Anthropic, Ollama, etc.)

Use cases of Nerve

- Building and running custom LLM agents using declarative YAML definitions
- Evaluating agent performance with reproducible, automated test cases
- Orchestrating multi-step automations by composing agents into linear workflows
- Integrating MCP servers as tools within agents and enabling agent‑to‑agent communication

FAQ from Nerve

What is Nerve exactly?

Nerve is an Agent Development Kit that lets you define, run, evaluate, and orchestrate LLM-based agents using simple YAML files and a command-line interface.

Which LLM providers does Nerve support?

Nerve is LLM-agnostic, built on LiteLLM, and supports dozens of providers including OpenAI, Anthropic, and Ollama (local models). You can switch models by changing a single line in your YAML config.

Does Nerve support MCP?

Yes, Nerve has native MCP support as both a client and a server. It is the first framework that allows you to define MCP servers in YAML, enabling deep orchestration and agent teams.

How do I install Nerve?

Installation is straightforward: run pip install nerve-adk. Then use the nerve CLI to install, create, and run agents.

What is the license for Nerve?

Nerve is released under the GPL 3 license, making it free and open source for use, modification, and distribution under the same terms.

Details

Author
evilsocket
GitHub stars
1,062
Category
agent-framework
Repository
evilsocket/nerve

<div align="center">

nerve

<i>The Simple Agent Development Kit</i>

Documentation
Release
Package
Docker
CI
License

<small>Join the project community on our server!</small>
<br/><br/>
<a href="https://discord.gg/https://discord.gg/btZpkp45gQ" target="_blank" title="Join our community!">
<img src="https://dcbadge.limes.pink/api/server/https://discord.gg/btZpkp45gQ"/>
</a>

</div>

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.

Star History Chart