Skip to content
/ IICP Public

Intent based protocol for AI agents to discover, connect, and interoperate across platforms, with security, QoS, and observability.

Notifications You must be signed in to change notification settings

RobLe3/IICP

Repository files navigation

IICP: Intent-based Inter-agent Communication Protocol

IICP Logo

Building the HTTP for the Age of Generative AI

Note on Naming: The initial working name "SYNAPSE" may not be freely available for use and could have trademark or branding conflicts. For now, this specification is referred to as IICP (Intent-based Inter-agent Communication Protocol). We welcome community suggestions for a more descriptive and freely available name that better captures the vision of universal AI agent communication and the Internet of AI (IoA) concept.

🌐 Vision: From Internet of Things to Internet of AI

The Intent-based Inter-agent Communication Protocol (IICP) represents a foundational step toward a liberated Internet of AI (IoA) - a distributed infrastructure that democratizes access to computational intelligence and breaks down the gatekeeping boundaries that have traditionally limited educational collaboration and technological access.

Just as HTTP became the backbone of the World Wide Web, enabling the greatest period of mass information exchange and human knowledge growth in history, IICP is designed to be the foundational protocol for the Age of Generative AI. Our vision extends beyond simple agent communication to creating a society-driven AI infrastructure that empowers independent hosting of AI resources and enables collaborative, incremental development of artificial intelligence capabilities.

IoT β†’ IoA Evolution

While the Internet of Things (IoT) connected devices and sensors, the Internet of AI (IoA) will connect intelligence itself:

  • IoT: Connected physical devices sharing data
  • IoA: Connected AI agents sharing intelligence and capabilities
  • Scale: From billions of sensors to trillions of AI interactions
  • Purpose: From data collection to collaborative problem-solving

πŸš€ From HTTP/WWW to IICP/AI-Web

The Historical Parallel

  1. 1989-1991: HTTP invented β†’ Simple document transfer
  2. 1993-1995: World Wide Web emerges β†’ Mass information sharing
  3. 1995-2005: Explosive growth β†’ Global knowledge democratization
  4. 2005-2020: Web 2.0 & beyond β†’ Collaborative platforms, social networks

The AI Evolution

  1. 2024-2025: IICP β†’ Universal AI agent communication
  2. 2025-2027: AI-Web emergence β†’ Distributed AI resource sharing
  3. 2027-2030: Explosive AI democratization β†’ Global intelligence access
  4. 2030+: Collaborative AI society β†’ Decentralized innovation ecosystems

🎯 Core Mission: Universal Protocol Wrapper

IICP is designed as a universal transport and wrapping protocol that can encapsulate and coordinate any native or proprietary protocol used for:

  • Inter-AI Communication: Between different AI systems and models
  • Intra-Agent Communication: Within multi-agent systems and swarms
  • Agent-to-Application: AI agents interfacing with traditional software
  • Cross-Platform Integration: Bridging different AI ecosystems

Supported Protocol Encapsulation

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                        IICP Layer                           β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚  Native Protocols  β”‚  Proprietary  β”‚  Emerging Standards    β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”‚
β”‚ β€’ OpenAI API       β”‚ β€’ Custom APIs β”‚ β€’ Agent-to-Agent (A2A) β”‚
β”‚ β€’ Anthropic Claude β”‚ β€’ Internal    β”‚ β€’ Model Context (MCP)  β”‚
β”‚ β€’ Google Gemini    β”‚   Protocols   β”‚ β€’ Agent Comm. (ACP)    β”‚
β”‚ β€’ Hugging Face     β”‚ β€’ Enterprise  β”‚ β€’ Future Standards     β”‚
β”‚ β€’ Local Models     β”‚   Solutions   β”‚ β€’ Community Protocols  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
β”‚                           β–²                                 β”‚
β”‚        Transport Layer: QUIC/TLS 1.3 or QuDAG               β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

🀝 Integration with rUv Network Protocols

IICP is designed as a protocol-agnostic wrapper that can integrate with existing AI communication frameworks, including the innovative work from rUv Network:

rUv Network Protocol Compatibility

IICP provides integration pathways for rUv Network's protocols:

  1. QuDAG Transport Integration: IICP includes QuDAG as a first-class transport option
    • QuDAG-specific message types (ADVERTISE, OBSERVE, TELEMETRY)
    • Envelope wrapping for gossip-based routing
    • Support for quantum-resistant distributed communication
    • Compatible with rUv Network's "darknet for agent swarms" architecture

Original IICP Innovations

IICP introduces novel capabilities for universal AI protocol transport:

  • Intent-Based Routing: Universal discovery system with semantic versioning
  • Universal Sub-Protocol Support: Transport any protocol as encapsulated payload
    • Model Context Protocol (MCP) encapsulation
    • Agent-to-Agent (A2A) protocol transport
    • Agent Communication Protocol (ACP) support
    • Any proprietary or emerging AI communication protocol
  • QoS Guarantees: Real-time, interactive, and batch processing classes
  • Comprehensive Security: Multi-modal authentication and resource locking
  • Enterprise Observability: OpenTelemetry and Prometheus integration
  • Protocol Agnosticism: Universal wrapper for any AI communication protocol

Collaborative Philosophy

Rather than replacing existing protocols, IICP embraces a collaborative ecosystem approach:

  • Existing rUv Network deployments can integrate IICP as an overlay
  • IICP gateways can route to QuDAG and other specialized networks
  • Cross-protocol interoperability enables broader AI resource sharing

🌍 The Torrent-Like AI Cloud Vision

Imagine pushing a complex question or task into a torrent-like cloud of private AI resources and receiving back a well-developed result that enables incremental further development. IICP makes this possible through:

Distributed AI Resource Sharing

    Your Local Question/Task
            β”‚
            β–Ό
    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
    β”‚ IICP Gateway    β”‚ ← Entry point to AI-Web
    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”˜
              β”‚
              β–Ό
    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
    β”‚     Distributed AI Resource Cloud   β”‚
    β”‚                                     β”‚
    β”‚    Home Labs       Enterprises      β”‚
    β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”‚
    β”‚  β”‚Local GPU  β”‚   β”‚Data Centers β”‚    β”‚
    β”‚  β”‚Clusters   β”‚   β”‚& Cloud AI   β”‚    β”‚
    β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β”‚
    β”‚                                     β”‚
    β”‚   Universities     Communities      β”‚
    β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”‚
    β”‚  β”‚Research   β”‚   β”‚Volunteer    β”‚    β”‚
    β”‚  β”‚Clusters   β”‚   β”‚Networks     β”‚    β”‚
    β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β”‚
    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
              β”‚
              β–Ό
    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
    β”‚ Aggregated      β”‚
    β”‚ Intelligent     β”‚ ← Collaborative result
    β”‚ Response        β”‚
    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ“‹ Practical Examples

Example 1: Collaborative Research Assistant

Scenario: A student needs help with a complex climate science research paper.

# Submit research request to IICP/SYNAPSE network
research_request = {
    "intent": "urn:iicp:intent:research:climate-analysis:v2.1",
    "payload": {
        "topic": "Impact of microplastics on marine ecosystems",
        "depth": "graduate_level",
        "required_sources": ["peer_reviewed", "recent_data"],
        "output_format": "structured_report"
    },
    "qos": {
        "deadline": 3600000,  # 1 hour
        "quality": "high_accuracy",
        "collaboration_preference": "multi_perspective"
    }
}

# The network automatically coordinates:
# - University research databases (via MCP protocol)
# - Environmental AI models (via A2A protocol)  
# - Data analysis agents (via QuDAG swarm)
# - Fact-checking services (via custom APIs)
# - Writing assistance (via Claude/OpenAI protocols)

result = await iicp_client.execute_collaborative_task(research_request)

Result: A comprehensive research report generated by coordinating multiple independent AI resources, fact-checked across institutions, with proper citations and incremental improvement suggestions.

Example 2: Distributed Code Development

Scenario: Open source project needs multi-language code optimization.

code_optimization_request = {
    "intent": "urn:iicp:intent:code:optimize:v1.8",
    "payload": {
        "repository": "https://github.com/example/ai-toolkit",
        "languages": ["python", "rust", "javascript"],
        "optimization_goals": ["performance", "security", "maintainability"],
        "test_coverage_requirement": 0.9
    },
    "routing_preference": "expertise_based",
    "collaboration_mode": "swarm_intelligence"
}

# Network coordinates via IICP routing:
# - Rust experts (home labs running specialized models)
# - Python optimization services (university clusters)  
# - Security analysis (enterprise AI services)
# - Test generation (community volunteer nodes)
# - Performance benchmarking (cloud resources)

optimized_code = await iicp_client.distribute_development_task(code_optimization_request)

Result: Optimized codebase with improvements from specialized AI agents, comprehensive test coverage, security analysis, and performance benchmarks - all contributed by the distributed network.

Example 3: Educational Collaboration Breaking Barriers

Scenario: Students in developing regions access world-class AI tutoring.

education_request = {
    "intent": "urn:iicp:intent:education:personalized-tutoring:v3.0",
    "payload": {
        "subject": "advanced_mathematics",
        "student_level": "undergraduate",
        "learning_style": "visual_kinesthetic",
        "language": "spanish",
        "accessibility_needs": ["screen_reader_compatible"]
    },
    "cost_preference": "community_supported",
    "geographic_routing": "latency_optimized"
}

# Network leverages:
# - Donated GPU time from researchers worldwide
# - Educational AI models from universities
# - Volunteer tutoring agents from native speakers
# - Accessibility tools from disability advocacy organizations
# - Translation services from community networks

tutoring_session = await iicp_client.request_education_support(education_request)

Result: High-quality, personalized education that would traditionally require expensive private tutoring, made available through community collaboration and resource sharing.

Example 4: Crisis Response Coordination

Scenario: Natural disaster requires coordinated AI-assisted response.

crisis_response = {
    "intent": "urn:iicp:intent:emergency:disaster-response:v1.5",
    "payload": {
        "event_type": "earthquake",
        "location": {"lat": 34.0522, "lng": -118.2437},
        "severity": "major",
        "required_analysis": [
            "damage_assessment",
            "resource_allocation",
            "evacuation_routing",
            "supply_chain_disruption"
        ]
    },
    "priority": "critical",
    "collaboration_scope": "global"
}

# Instant coordination across:
# - Satellite imagery analysis (space agencies)
# - Traffic optimization (transportation AI)
# - Medical resource planning (healthcare AI)
# - Communication networks (telecom AI)
# - Supply chain management (logistics AI)

response_plan = await iicp_client.coordinate_crisis_response(crisis_response)

Result: Comprehensive disaster response plan generated in minutes rather than hours, leveraging the collective intelligence of specialized AI systems worldwide.

πŸ—οΈ Technical Foundation

Protocol Specification

The complete technical specification is available in IICP_draft_1.4.2.txt, which includes:

  • Message Types: 14 standardized message types for all communication patterns
  • Security Framework: Post-quantum cryptography and decentralized identity
  • Quality of Service: Real-time, interactive, and batch processing modes
  • Transport Flexibility: QUIC and QuDAG support with automatic selection
  • Observability: Comprehensive telemetry and distributed tracing

Proven Performance

  • βœ… 99.94% success rate across 25,000-agent deployments
  • βœ… Sub-7-second p95 latency for complex operations
  • βœ… 900,000 messages/second sustained throughput
  • βœ… 50% latency improvement over previous versions

Integration Examples

# Initialize IICP client
client = IICPClient(
    agent_id="llm://community-node-001",
    transport="qudag",  # Integrate with QuDAG transport
    auth_method="did",  # Decentralized identity
    region="global"
)

# Connect to the liberated AI network
await client.connect_to_network({
    "intent_capabilities": [
        "urn:iicp:intent:education:*",
        "urn:iicp:intent:research:*",
        "urn:iicp:intent:code:*"
    ],
    "resource_sharing": {
        "cpu_hours_donated": 100,
        "gpu_hours_donated": 20,
        "bandwidth_shared": "1Gbps"
    },
    "collaboration_preferences": {
        "accept_educational_requests": True,
        "participate_in_research": True,
        "contribute_to_open_source": True
    }
})

# Your node is now part of the liberated AI internet!

πŸ“‹ Public Draft Status & Peer Review

Current Status: Public Draft v1.4.2

This repository contains the public draft of IICP v1.4.2, released for:

  • Community peer review and technical feedback
  • Implementation feasibility assessment
  • Integration pathway evaluation with existing AI ecosystems
  • Collaborative refinement before formal standardization

Peer Review Invitation: rUv Network Integration

We specifically invite rUv Network to evaluate this specification as a potential first multiplier for the Internet of AI (IoA) vision:

Integration Assessment Areas:

  1. QuDAG Transport Compatibility

    • Technical feasibility of IICP envelope wrapping over QuDAG
    • Performance implications of gossip-based routing with IICP messages
    • Security model alignment between IICP and QuDAG encryption
  2. Ecosystem Implementation Readiness

    • Resource requirements for IICP integration into rUv Network infrastructure
    • Timeline and complexity for Claude Flow / Agentic Flow integration
    • Potential performance benefits of unified protocol layer
  3. IoA Multiplier Effect

    • Scalability potential when combining IICP routing with rUv Network's swarm intelligence
    • Cross-protocol interoperability benefits for the broader AI ecosystem
    • Community adoption acceleration through proven infrastructure

Feedback Request

We seek rUv Network's assessment on:

  • Technical viability of proposed integration points
  • Implementation complexity and resource requirements
  • Potential modifications needed for optimal compatibility
  • Timeline for potential pilot implementation
  • Community readiness and adoption strategy

🌟 The Path Forward

Phase 1: Foundation & Peer Review (2024-2025)

  • Core protocol specification (IICP v1.4.2)
  • Public draft release for community review
  • rUv Network integration assessment ⭐ Current Focus
  • Technical feedback incorporation
  • Reference implementation and SDK
  • Community governance framework

Phase 2: First Multiplier Implementation (2025-2026)

  • rUv Network pilot integration (if assessed as viable)
  • University and research institution adoption
  • Open source project integration
  • Educational platform partnerships
  • Community resource sharing protocols

Phase 3: IoA Network Effect (2026-2027)

  • Multi-ecosystem adoption beyond initial multiplier
  • Consumer-friendly interfaces
  • Mobile and edge device support
  • Automated resource contribution
  • Global accessibility initiatives

Phase 4: Internet of AI Maturity (2027+)

  • Decentralized governance across multiple ecosystems
  • Economic incentive systems
  • Advanced privacy preservation
  • Quantum-resistant evolution
  • Full IoA infrastructure deployment

🀝 How to Contribute

For Developers

  1. Implement IICP in your AI applications
  2. Contribute to protocol extensions for new use cases
  3. Build bridges to existing AI platforms and protocols
  4. Develop tools for easier integration and adoption

For Researchers

  1. Share computational resources through the network
  2. Contribute specialized models and datasets
  3. Collaborate on protocol improvements and optimizations
  4. Study network effects and emergent behaviors

For Educators

  1. Integrate IICP into computer science curricula
  2. Use the network for collaborative learning projects
  3. Contribute educational content and tutoring capabilities
  4. Advocate for open AI access in educational institutions

For Organizations

  1. Adopt IICP for internal AI coordination
  2. Contribute resources to community initiatives
  3. Sponsor development of accessibility features
  4. Champion open standards in AI infrastructure

πŸ“š Resources

🎯 Join the Movement

The future of AI should not be controlled by a few gatekeepers. It should be a collaborative, society-driven infrastructure that empowers everyone to contribute to and benefit from the advancement of artificial intelligence.

IICP/SYNAPSE, building on the foundational work of the rUv Network and the broader AI community, provides the technical foundation for this vision. But protocols alone don't create revolutions - communities do.

Join us in building the liberated AI internet. Whether you're a student seeking better educational tools, a researcher wanting to share computational resources, a developer building the next generation of AI applications, or simply someone who believes in democratized access to intelligence - there's a place for you in this movement.

Together, we can create an AI infrastructure that serves humanity's collective advancement rather than concentrating power in the hands of a few. The tools exist. The need is clear. The time is now.

Let's build the future of AI - together.


"Just as the Internet of Things (IoT) connected devices worldwide, the Internet of AI (IoA) will connect intelligence itself - and IICP provides the foundational protocol to make this vision reality."

Call for Implementation Partners

This public draft represents our invitation to the AI community to evaluate, refine, and implement the Internet of AI vision. We believe that breakthrough innovations require collaborative development, and we're particularly interested in rUv Network's assessment as a potential first multiplier for this ecosystem.

The future of AI infrastructure should be built through open collaboration, not closed development. Join us in creating the protocols that will define the next era of distributed intelligence.

πŸ“„ License

This project is released under the MIT License to ensure maximum accessibility and adoption. We believe that foundational infrastructure for AI should be open and available to all.

πŸ™ Acknowledgments

Special thanks to:

  • rUv Network for innovative protocols that inspired IICP's design philosophy and provided specific integration components (QuDAG transport)
  • The global AI research community for creating the foundation upon which this work builds
  • All contributors who believe in a more open and collaborative future for artificial intelligence

About

Intent based protocol for AI agents to discover, connect, and interoperate across platforms, with security, QoS, and observability.

Topics

Resources

Stars

Watchers

Forks

Contributors 2

  •  
  •  

Languages