Go SDK Overview

​

What is the Go SDK?

​

Key Features

• Complete Embedding: Run the full proxy server inside your application
• Programmatic Control: Configure and manage the service through Go code
• Custom Providers: Add your own AI service providers with custom executors
• Request Translators: Transform requests between different API formats
• Access Control: Implement custom authentication and authorization
• Lifecycle Hooks: Hook into service startup and shutdown events
• File Watching: Automatic configuration and authentication reload
• Usage Tracking: Monitor API usage and token consumption

​

Use Cases

​

Desktop Applications

// Your desktop app can start the proxy internally
svc, _ := cliproxy.NewBuilder().
    WithConfig(cfg).
    WithConfigPath(configPath).
    Build()

go svc.Run(context.Background())

​

Custom AI Gateways

• Add custom authentication providers
• Implement request rate limiting
• Route requests based on custom business logic
• Add monitoring and observability

​

Integration Services

• Combine multiple AI services under one API
• Add custom retry logic and failover
• Implement request caching
• Add request/response transformation

​

Testing and Development

func TestAIIntegration(t *testing.T) {
    svc := startEmbeddedProxy(t)
    defer svc.Shutdown(context.Background())
    
    // Test your AI-powered features
}

​

Architecture Overview

​

Core Packages

• sdk/cliproxy: Main service and builder for embedding the proxy
• sdk/config: Configuration loading and management
• sdk/cliproxy/auth: Authentication and credential management
• sdk/cliproxy/executor: Provider executors for AI services
• sdk/translator: Request/response format translators
• sdk/access: Request authentication and access control

​

Component Flow

Incoming Request
       ↓
Access Manager (Authentication)
       ↓
Auth Manager (Credential Selection)
       ↓
Translator (Format Conversion)
       ↓
Executor (Provider API Call)
       ↓
Translator (Response Conversion)
       ↓
Outgoing Response

​

Quick Example

package main

import (
    "context"
    "github.com/router-for-me/CLIProxyAPI/v6/sdk/cliproxy"
    "github.com/router-for-me/CLIProxyAPI/v6/sdk/config"
)

func main() {
    // Load configuration
    cfg, err := config.LoadConfig("config.yaml")
    if err != nil {
        panic(err)
    }

    // Build the service
    svc, err := cliproxy.NewBuilder().
        WithConfig(cfg).
        WithConfigPath("config.yaml").
        Build()
    if err != nil {
        panic(err)
    }

    // Run the service (blocks until context is cancelled)
    if err := svc.Run(context.Background()); err != nil {
        panic(err)
    }
}

​

Installation

go get github.com/router-for-me/CLIProxyAPI/v6

​

Next Steps