evilsocket / nerve

# `nerve` The Simple Agent Development Kit [](https://github.com/evilsocket/nerve/blob/main/docs/index.md) [](https://github.com/evilsocket/nerve/releases/latest) [](https://pypi.org/project/nerve-adk) [](https://hub.docker.com/r/evilsocket/nerve) [](https://github.com/evilsocket/nerve/actions/workflows/ci.yml) [](https://github.com/evilsocket/nerve/blob/master/LICENSE.md)  Join the project community on our server!

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.

<a href="https://github.com/evilsocket/nerve/graphs/contributors">
<img src="https://contrib.rocks/image?repo=evilsocket/nerve" alt="Nerve project contributors" />
</a>

License

Nerve is released under the GPL 3 license.