nerve

<div align="center"> # `nerve` <i>The Simple Agent Development Kit</i> [](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) <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](https://github.com/evilsocket/nerve/blob/main/docs/mcp.md). **📊 Evaluation Mode** [Benchmark your agents](https://github.com/evilsocket/nerve/blob/main/docs/evaluation.md) 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](https://docs.litellm.ai/), Nerve supports OpenAI, Anthropic, Ollama, [and dozens more](https://docs.litellm.ai/docs/providers) — switch models in one line. ## Quick Start ```bash # 🖥️ 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](https://github.com/evilsocket/nerve/blob/main/docs/index.md) and the [examples](https://github.com/evilsocket/nerve/tree/main/examples) for more. ## Contributing We welcome contributions! Check out our [contributing guidelines](https://github.com/evilsocket/nerve/blob/main/CONTRIBUTING.md) to get started and join our [Discord community](https://discord.gg/btZpkp45gQ) 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. [](https://star-history.com/#evilsocket/nerve&Date)