Skip to content

HotPlexAI Agent Control Plane

Transforming AI CLI Agents into Production-Ready Interactive Services

HotPlex

Quick Start

Install

bash
go get github.com/hrygo/hotplex

Basic Usage

go
package main

import (
    "context"
    "fmt"
    "time"
    "github.com/hrygo/hotplex"
)

func main() {
    opts := hotplex.EngineOptions{
        Timeout:         5 * time.Minute,
        PermissionMode:  "bypassPermissions",
        AllowedTools:    []string{"Bash", "Edit", "Read", "FileSearch"},
    }
    engine, _ := hotplex.NewEngine(opts)
    defer engine.Close()

    cfg := &hotplex.Config{
        WorkDir:          "/tmp/ai-sandbox",
        SessionID:        "user-123",
        TaskInstructions: "You are a senior Go systems engineer.",
    }

    ctx := context.Background()
    err := engine.Execute(ctx, cfg, "Refactor the main.go", 
        func(eventType string, data any) error {
            if eventType == "answer" {
                fmt.Printf("🤖 %v\n", data)
            }
            return nil
        })
}

Multi-Language SDKs

HotPlex provides official SDKs for multiple languages:

SDKStatusDescription
Go SDK✅ StableNative Go integration
Python SDK✅ StableWebSocket client for Python
TypeScript SDK✅ StableTypeScript/JavaScript client

Roadmap

We are actively evolving HotPlex to become the definitive execution engine for the Local AI ecosystem.

  • [x] Provider Abstraction (Claude Code, OpenCode)
  • [x] Event Hooks System
  • [x] OpenTelemetry Integration
  • [x] Prometheus Metrics
  • [x] Docker Remote Execution
  • [x] Multi-Language SDKs
  • [ ] L2/L3 Isolation (H2 2026)

Released under the MIT License.