Skip to content

FoundationAgents/foundation-protocol

Repository files navigation

Foundation Protocol

English | 中文 | 한국어 | 日本語 | Español | Tiếng Việt

GitHub Stars License Docs arXiv HuggingFace

A Python runtime for multi-entity AI collaboration — agents, humans, and tools on a shared protocol layer.

AI-Link-Net is a full-stack application built on this protocol.

Features

  • Unified entity model — agents, humans, tools, and services share a common identity and addressing system
  • Multi-party sessions — structured collaboration with strict lifecycle enforcement and event replay
  • Policy & governance — checkpoint hooks with provenance recording for trust and access control
  • Trade & payment — contracts, escrow, settlement, and dispute resolution via state machines
  • Federation — local and remote entity routing across distributed host nodes

Manifesto

20260526-151313.mp4

Installation

Install as a git dependency:

pip install "foundation-protocol @ git+https://github.com/FoundationAgents/foundation-protocol.git"

Usage

import asyncio
from fp import EntityKind, Host, Message, MessageKind

async def main():
    host = Host(name="LocalHost")

    alice = host.register_entity(name="Alice", kind=EntityKind.HUMAN)
    bot = host.register_entity(name="Bot", kind=EntityKind.AGENT)

    await alice.send_message(
        to=bot.entity_card,
        message=Message(kind=MessageKind.INVOKE, payload={"text": "Hello!"}),
    )

asyncio.run(main())

See the example/ directory for more scenarios including cross-host messaging, MCP tool integration, and trade workflows.

Documentation

Full documentation is published at foundationagents.github.io/foundation-protocol. Quick links:

License

MIT

About

A Python runtime for multi-entity AI collaboration — agents, humans, and tools on a shared protocol layer.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages