โ† AI Tools
WorkflowBeginner

GNAP (Git-Native Agent Protocol)

Git-based serverless multi-agent collaboration protocol.

Git-Native Agent Protocol (hereinafter referred to as GNAP) is an open-source, serverless multi-agent coordination protocol announced by Farol Labs on March 15, 2026. Instead of traditional centralized message brokers or complex database servers, it provides an architecture that transforms a distributed version control system (DVCS), which is most familiar to modern software developers, into a message bus and persistent state store. Similar to how scientists in a distributed laboratory coordinate projects by adhering to predefined rules, posting notes on a large shared whiteboard, and checking the completion status of tasks, GNAP enables multiple AI agents and human workers to asynchronously delegate and perform tasks through a standardized directory structure and JSON schema, without the need for additional server infrastructure. Existing autonomous agent frameworks have forced the construction of separate physical infrastructure, such as Redis servers, PostgreSQL databases, or dedicated WebSocket relays, for communication and state maintenance between agents. This has posed significant constraints in isolated environments handling sensitive information or in specialized research settings. GNAP completely eliminates the cost of additional infrastructure while ensuring a perfect, tamper-proof audit trail without a separate audit logging system, based on the cryptographic commit history inherently guaranteed by Git. Collaborators perform tasks individually in local sandboxes with no network access, and then adopt a delayed synchronization method, periodically running a heartbeat loop to pull tasks and push updates to the task status as JSON files, enabling even offline collaboration. In particular, in the field of biotechnology research, GNAP demonstrates excellent utility in coordinating distributed analysis pipelines between compute servers protected by firewalls. For example, when operating pipelines that require significant CPU and GPU processing power and take a long time, such as large-scale genomic sequence analysis (NGS) or protein-ligand docking prediction, simple loops of reading and writing JSON documents within the `.gnap/` folder hosted in a shared private Git repository, resident on each research workstation node, are sufficient for state synchronization. This allows laboratories to launch a stable, distributed pipeline that autonomously controls various analysis packages within 30 seconds, leveraging existing, proven configuration management infrastructure, without having to spend on expensive web server hosting or undergo cloud security audits.

๐Ÿ’ป System Requirements

๐Ÿง RAM

0 (Not essential for protocol operation; depends on the requirements of the associated AI agent runtime)

๐Ÿ’พStorage

Approximately 10MB or less (based on the protocol definition and initial schema template area; cumulative Git history storage is separate)

โšก Installation

### 4-1. Quick Start

```bash
# Create and initialize the GNAP directory structure in the Git repository
mkdir -p .gnap/tasks .gnap/runs .gnap/messages && echo "4" > .gnap/version && echo "[]" > .gnap/agents.json
```

### 4-2. Detailed Installation

```bash
# 1. Install the Python library that helps with GNAP integration
pip install workswithagents

# 2. Install the Node package for TypeScript/JavaScript agent configuration
npm install @workswithagents/agent-foundry
```
๐Ÿ“„ Official Docs๐Ÿ™ GitHub

๐Ÿ“ Update Notes

No update notes yet.

๐Ÿงช Related Code of Life

No related Code of Life posts yet.