Skip to content

README.md

Latest commit

 

History

History
138 lines (101 loc) · 4.06 KB

README.md

File metadata and controls

138 lines (101 loc) · 4.06 KB
Raw

helix-agent-sdk

Python SDK for Helix — self-healing infrastructure for AI agent payments.

Install

pip install helix-agent-sdk

Option A: Docker (recommended)

docker run -d -p 7842:7842 adrianhihi/helix-server

Option B: Node.js

npm install -g @helix-agent/core
npx helix serve --port 7842

Quick Start

Method 1: Client

from helix_agent import HelixClient

client = HelixClient(platform="coinbase")
result = client.repair("AA25 invalid account nonce")
print(f"Strategy: {result.strategy}")  # refresh_nonce
print(f"Immune: {result.immune}")      # True on 2nd call

Method 2: Decorator

from helix_agent import helix_wrap

@helix_wrap(platform="coinbase", max_retries=3)
def send_payment(to: str, amount: float):
    return agent.transfer(to, amount)

result = send_payment("0x...", 1.5)

Method 3: Context Manager

from helix_agent import helix_guard

with helix_guard("tempo") as guard:
    try:
        result = agent.transfer(to, amount)
    except Exception as e:
        repair = guard.repair(str(e))
        if repair.immune:
            result = agent.transfer(to, amount)

Features (via Helix Server)

The Python SDK talks to the Helix server which provides:

  • 17 Coinbase patterns — CDP API, ERC-4337, x402, policy, network
  • Cross-platform immunity — genes learned on Tempo/Privy auto-heal Coinbase errors
  • LLM fallback — unknown errors classified by Claude/GPT in real-time ($0.001), then cached forever ($0)
  • Gene Telemetry — anonymous network learning, coverage grows over time
  • Gene Dream — background memory consolidation, Gene Map gets smarter over time
  • Data Versioning — auto-migrates schema on server startup
  • Causal Repair Graph — predicts next errors before they happen
  • Meta-Learning — learns repair patterns from 3 examples
  • Self-Play Evolution — autonomous testing + weakness discovery
  • Federated Learning — privacy-preserving distributed RL
  • Safety Verification — 7 pre-execution constraints
  • Adversarial Robustness — 4-layer defense against Gene poisoning
  • 442+ TypeScript tests + 14 Python tests — production-grade reliability

Enable LLM on the server:

export ANTHROPIC_API_KEY=sk-ant-...
docker run -d -p 7842:7842 -e ANTHROPIC_API_KEY adrianhihi/helix-server

Architecture

┌──────────────────┐     HTTP/JSON    ┌──────────────────┐
│ Your Python Agent│ ──────────────→  │ Helix Server     │
│ (AgentKit, etc)  │                  │ PCEC + Gene Map  │
│                  │ ←──────────────  │ LLM + Telemetry  │
│ pip install      │    Strategy      │ docker run or    │
│ helix-agent-sdk  │                  │ npm install      │
└──────────────────┘                  └──────────────────┘

All intelligence runs server-side. The Python SDK is a lightweight HTTP client. Your agent gets the full power of PCEC, Gene Map, LLM, and network learning.

Gene Dream + Data Versioning

The Helix server includes background memory consolidation:

import requests

# Trigger Gene Dream manually
requests.post("http://localhost:7842/dream", json={"force": True})

# Check dream status
requests.get("http://localhost:7842/dream/status").json()

# Check schema version
requests.get("http://localhost:7842/schema").json()

Gene Dream runs automatically when your agent is idle. Data Versioning auto-migrates on server startup.

Configuration

HELIX_URL=http://localhost:7842  # env var

client = HelixClient(
    base_url="http://localhost:7842",
    platform="coinbase",
    agent_id="my-agent-1",
)

Supported Platforms

  • tempo — Tempo L1 blockchain
  • privy — Privy embedded wallets
  • coinbase — Coinbase CDP + AgentKit
  • generic — Any HTTP/RPC service