Bidirectional Engine Architecture

A deep technical breakdown of Vibra-Ingenn's dual-mode receiver/caller pipeline, local REST daemon, and compiled Go graph execution flow.

The Bidirectional Junction

Traditional AI agents are unidirectional: they either act strictly as an API client calling out to external cloud intelligence (like a web chat window), or they serve as a local model host listening for instructions (like Ollama or LM Studio).

Vibra-Ingenn is a **bidirectional execution junction**. It sits in the middle of your stack, acting simultaneously as a high-speed command receiver (for IDEs and local scripts) and an outbound compiler (driving local and cloud model inference to coordinate system workflows).

1. RECEIVERS (Sink) MCP Tool Server Claude Desktop, Cursor Local REST API Port 8990, iOS Shortcuts CLI Command Synchronous terminal run 2. VIBRA CORE (Executor) 1 Load & Resolve Recipe 2 Compile DAG Graph 3 In-Memory Sandbox 4 Step Retries / Failures 3. CALLERS (Source) Local LLMs Ollama, LM Studio Cloud Frontier APIs OpenRouter, Claude, GPT Host Execution Filesystem, Scripts, Net

The Three Receiver Interfaces

Vibra-Ingenn does not force you into a specific workflow tool. You can drive the local engine from three distinct entry interfaces, making it highly versatile:

1. MCP over Stdio JSON-RPC

Instantly integrates with Claude Desktop, Cursor, Cline, Windsurf, or VS Code. AI models call tools and run recipes on your machine in real-time.

2. Local REST API Daemon (Port 8990)

Vibra runs as a background service. Any tool capable of executing standard HTTP POST requests (CURL, Python, iOS Shortcuts, webhooks) can trigger local recipes.

3. CLI Command Line Executable

Run workflows directly inside local build scripts, cron jobs, task schedulers, or terminal consoles via vibra run <path_to_recipe>.

Outbound Model Handoff (Variables & Execution)

During a recipe execution, Vibra-Ingenn takes over. It manages variable state and credentials securely in-memory. For example, you can query a local model to parse codebase headers, format the output, and pipe it straight to a cloud model for vulnerability checks.

Because Vibra-Ingenn handles all variable sanitization, HTTP connections (configured with a generous 120s timeout for large token generation tasks), and file operations natively in compiled Go code, the LLM is completely isolated from the execution bugs that plague traditional Python frameworks.

{
  "workflow_id": "hybrid_local_cloud_security_audit",
  "tasks": [
    {
      "id": "extract_local_code",
      "action_type": "http_request",
      "target": "http://localhost:11434/v1/chat/completions",
      "payload": {
        "body": {
          "model": "llama3.2:3b",
          "messages": [{"role": "user", "content": "Extract function signatures..."}]
        }
      },
      "output": { "store_as": "local_extracted_headers" }
    },
    {
      "id": "cloud_security_audit",
      "trigger": "after:extract_local_code",
      "action_type": "http_request",
      "target": "https://openrouter.ai/api/v1/chat/completions",
      "payload": {
        "headers": { "Authorization": "Bearer {{env.OPENROUTER_API_KEY}}" },
        "body": {
          "model": "anthropic/claude-opus-5",
          "messages": [{"role": "user", "content": "Audit these signatures: {{local_extracted_headers.choices[0].message.content}}"}]
        }
      }
    }
  ]
}

A Local Automation Server for Non-AI Clients

Because Vibra-Ingenn exposes a complete REST endpoint on port 8990, it operates as a lightweight, high-performance local automation runner (similar to a local n8n or Bash automation daemon) completely independent of active AI connections.

Once you've used an AI to compile a JSON recipe once, you can save it and trigger it 10,000 times a day via a simple curl command, iOS Shortcut, local cron job, or webhook—with zero LLM connection, zero API token costs, and sub-millisecond execution latency.

💡 Greenfield Advantage: AI-Optional Runtime

You don't need to pay API token costs to run the same tasks every day. The LLM is only the compiler (writing the JSON recipe once). Vibra-Ingenn is the runtime engine, executing saved recipes natively at machine speeds.