Nerve
- 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>
<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.







