SciSharp / SciSharp/BotSharp

GNAP: cross-language agent coordination protocol for BotSharp agent networks

Open
#1,308 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
C#
Stars
3.1k
Forks
651
Avg merge
15h 2m
Merged PRs (30d)
36

Description

Hi BotSharp team 👋

BotSharp is one of the few serious multi-agent frameworks for .NET — which means it often needs to coordinate with agents in other runtimes (Python, Node, etc.). I wanted to share a protocol designed exactly for this cross-language coordination challenge.

GNAP (Git-Native Agent Protocol) is an open RFC for agent coordination using git as the message bus. Because the protocol is pure JSON files + git, it works identically regardless of what language or runtime the agent uses.

BotSharp-specific value:

BotSharp agents run in .NET but enterprise workflows often involve Python data science agents, Node.js integration agents, or human reviewers. GNAP provides a common coordination layer that works across all of them:

Agent type Runtime GNAP compatible?
BotSharp agent .NET/C# ✅ Any git client
Python ML agent Python
Claude Code Node.js
Human reviewer Terminal

Integration idea for BotSharp:

BotSharp's IAgentService could have a GNAPBackend implementation that:

  1. Writes task assignments to .gnap/tasks/ on agent dispatch
  2. Polls via git pull in the heartbeat loop
  3. Reads results from task JSON on completion
  4. Provides full git-history audit trail

This would let BotSharp's orchestration layer coordinate .NET agents alongside Python, Node, or human agents without any API contracts or shared infrastructure beyond a git repo.

Spec: https://github.com/farol-team/gnap

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

The proposal points to IAgentService, .gnap/tasks/, the heartbeat loop, task JSON, and the linked GNAP specification. Start by reviewing those integration points and the GNAP spec; done would require an agreed scope and acceptance criteria for a GNAPBackend, which the issue does not currently define.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp, git, node.js, python
Domain
ai, backend-api-design, distributed-systems
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.