Sponsored by Deepsite.site

Nerve

Created By
evilsocketa year ago
The Simple Agent Development Kit.
Content

nerve

The Simple Agent Development Kit

Documentation Release Package Docker CI License

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.

License

Nerve is released under the GPL 3 license.

Star History Chart

Recommend Clients
TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.
WindsurfThe new purpose-built IDE to harness magic
MCP ConnectEnables cloud-based AI services to access local Stdio based MCP servers via HTTP requests
Cline โ€“ #1 on OpenRouterAutonomous coding agent right in your IDE, capable of creating/editing files, executing commands, using the browser, and more with your permission every step of the way.
MCP PlaygroundCall MCP Server Tools Online
Refact.aiOpen-source AI Agent for VS Code and JetBrains that autonomously solves coding tasks end-to-end.
Cherry Studio๐Ÿ’ Cherry Studio is a desktop client that supports for multiple LLM providers.
Continueโฉ Create, share, and use custom AI code assistants with our open-source IDE extensions and hub of models, rules, prompts, docs, and other building blocks
chatmcpChatMCP is an AI chat client implementing the Model Context Protocol (MCP).
ChatWiseThe second fastest AI chatbotโ„ข
HyperChatHyperChat is a Chat client that strives for openness, utilizing APIs from various LLMs to achieve the best Chat experience, as well as implementing productivity tools through the MCP protocol.
Y GuiA web-based graphical interface for AI chat interactions with support for multiple AI models and MCP (Model Context Protocol) servers.
DeepChatYour AI Partner on Desktop
Roo Code (prev. Roo Cline)Roo Code (prev. Roo Cline) gives you a whole dev team of AI agents in your code editor.
SOCIAL-API.AI
LutraLutra is the first MCP compatible client built for everyone
y-cli ๐Ÿš€A Tiny Terminal Chat App for AI Models with MCP Client Support
A Sleek AI Assistant & MCP Client5ire is a cross-platform desktop AI assistant, MCP client. It compatible with major service providers, supports local knowledge base and tools via model context protocol servers .
CursorThe AI Code Editor
Visual Studio Code - Open Source ("Code - OSS")Visual Studio Code
ZedCode at the speed of thought โ€“ Zed is a high-performance, multiplayer code editor from the creators of Atom and Tree-sitter.