foundation-protocol 0.1.0

Foundation Protocol (FP) reference Python runtime

Foundation Protocol

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

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

https://github.com/user-attachments/assets/ceab2515-b8f2-47ec-8d7f-10452759c32a

Installation

Recommended: install the stable release from PyPI:

pip install foundation-protocol

Developers can install the latest source from GitHub:

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:

• Quickstart — install and run a two-entity exchange
• Checkpoint Pipeline — the trust and governance seam
• Trade & Trust — contracts, arbitration, reputation
• Security Notes — known boundaries and risks

License

MIT