Skip to content

README.md

Latest commit

 

History

History
101 lines (72 loc) · 2.93 KB

README.md

File metadata and controls

101 lines (72 loc) · 2.93 KB

Orpheon Protocol

The Intent-Native Interaction Standard for Autonomous Systems Orpheon replaces the rigid Request/Response paradigm with a negotiable, intent-based interaction model designed for AI agents, autonomous orchestrators, and high-reliability systems.

📚 Read the Full Context & Specification

🚀 Why Orpheon?

Feature Traditional APIs (REST/GraphQL) Orpheon Protocol
Interaction Imperative ("Do step X") Declarative ("Achieve outcome Y")
Responsibility Client orchestrates everything Server plans and executes
State Polling / Webhooks Real-time State Subscriptions
Failures Manual retry logic Automatic Compensation & Rollback
Time Instantaneous only Temporal (Schedule, Simulate, Replay)

📦 Installation

Add Orpheon to your Cargo.toml:

[dependencies]
orpheon = "0.1.0"

⚡ Quick Start

Define an Intent and submit it to the network:

use orpheon::prelude::*;

#[tokio::main]
async fn main() -> Result<(), OrpheonError> {
    let client = OrpheonClient::connect("https://api.mainnet.orpheon.network").await?;

    // 1. Define what you want
    let intent = Intent::builder()
        .kind("provision_gpu_cluster")
        .constraint("count", 8)
        .constraint("type", "H100")
        .budget(Budget::usd(100.0))
        .build();

    // 2. Submit intent and subscribe to updates
    let mut plan_stream = client.submit(intent).await?;

    while let Some(event) = plan_stream.next().await {
        match event {
            EventType::Negotiating(opt) => println!(" negotiating: {:?}", opt),
            EventType::Executing(step) => println!(" executing: {:?}", step),
            EventType::Complete(artifact) => {
                println!("✅ Done! Proof: {}", artifact.merkle_root);
                break;
            }
        }
    }
    
    Ok(())
}

Development

Web

cargo run -p orpheon-node
bun dev

🛠️ Features (The 100+ Matrix)

Orpheon supports over 100 advanced capabilities across 7 spheres:

  • Cognitive: Recursive Intents, Probabilistic Branching, LLM Integration.
  • Network: P2P Gossip, Federation, DTN, Edge Offloading.
  • Trust: Zero-Knowledge Proofs, Quantum-Resistant Crypto.
  • Temporal: Time-Travel Querying, Speculative Simulation.
  • Economic: Dynamic Markets, Resource Bonding Curves.
  • Developer: Visual Debugger, Chaos Injection.
  • Hardware: FPGA Acceleration, BCI Triggers.

See CONTEXT.md for the full matrix.

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines on how to get started.

🔒 Security

Security is our top priority. See SECURITY.md for our reporting policy and PGP keys.

📄 License

Dual-licensed under MIT and Apache 2.0. See LICENSE for details.