Go Calque

The Problem

Building AI apps in Go means wrestling with:

• Provider lock-in - Switching between OpenAI, Gemini, or local models requires rewriting code
• Conversation state - Managing chat history and context windows across requests
• Tool calling - Connecting AI to your Go functions with proper error handling
• Structured outputs - Getting reliable JSON responses that match your types
• RAG pipelines - Coordinating document retrieval, embedding, and generation

Go-Calque solves these with a simple, composable middleware pattern that feels native to Go.

Installation

go get github.com/calque-ai/go-calque

Quickstart

package main

import (
    "context"
    "fmt"
    "log"

    "github.com/calque-ai/go-calque/pkg/calque"
    "github.com/calque-ai/go-calque/pkg/middleware/ai"
    "github.com/calque-ai/go-calque/pkg/middleware/ai/ollama"
)

func main() {
    client, err := ollama.New("llama3.2:3b")
    if err != nil {
        log.Fatal(err)
    }

    flow := calque.NewFlow().Use(ai.Agent(client))

    var result string
    err = flow.Run(context.Background(), "What's the capital of France?", &result)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result)
}

Three lines to set up, one line to run.

What You Can Build

Chatbot with Memory

convMem := memory.NewConversation()

flow := calque.NewFlow().
    Use(convMem.Input(userID)).
    Use(ai.Agent(client)).
    Use(convMem.Output(userID))

AI with Tool Calling

calculator := tools.Simple("calc", "Math", calcFn)
weather := tools.Simple("weather", "Weather", weatherFn)

flow := calque.NewFlow().
    Use(ai.Agent(client, ai.WithTools(calculator, weather)))

Structured Output

flow := calque.NewFlow().
    Use(ai.Agent(client, ai.WithSchema(&MyType{})))

var result MyType
flow.Run(ctx, "Analyze this", convert.FromJSONSchema(&result))

RAG Pipeline

flow := calque.NewFlow().
    Use(retrieval.VectorSearch(store, opts)).
    Use(prompt.Template(ragTemplate)).
    Use(ai.Agent(client))

📖 [See Getting Started Guide →](docs/getting-started.md)

Why Go-Calque?

| Challenge | Raw SDK | Go-Calque | | ----------------------- | -------------------------- | ---------------------------------------- | | Provider switching | Rewrite API calls | Change one line: ollama.New() → openai.New() | | Conversation memory | Manual state management | convMem.Input() / convMem.Output() | | Tool calling | Parse, match, handle errors| ai.WithTools(...) - automatic | | Structured output | Hope AI follows instructions| ai.WithSchema() - guaranteed types | | Retries & fallbacks | Custom logic | ctrl.Retry(), ctrl.Fallback() |

Features

Core

• [AI Agents](docs/middleware.md#ai-agents) - OpenAI, Gemini, Ollama with unified interface
• [Tool Calling](docs/middleware.md#tool-integration) - Auto-discovery and execution of Go functions
• [Memory](docs/middleware.md#memory) - Conversation history with configurable limits

Data Processing

• [RAG & Retrieval](docs/middleware.md#retrieval) - Vector search, context building, semantic filtering
• [Converters](docs/middleware.md#converters) - JSON, YAML, Protobuf, JSONSchema, SSE
• [Flow Control](docs/middleware.md#flow-control) - Retry, timeout, fallback, parallel, chain

Production

• [Observability](docs/middleware.md#observability) - Metrics, tracing, health checks, structured logging
• [MCP Support](docs/middleware.md#mcp) - Model Context Protocol client
• [Multi-Agent](docs/middleware.md#multi-agent) - Agent routing and load balancing

📖 [See Full Middleware Reference →](docs/middleware.md)

Performance

Go-Calque is built for production AI workloads where LLM latency dominates.

| Metric | Value | |--------|-------| | Framework Overhead |

Star History

License

Mozilla Public License 2.0 - see [LICENSE](LICENSE) file for details.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: calque-ai
• Source: calque-ai/go-calque
• License: MPL-2.0
• Homepage: https://calque.ai/developer

Install and usage instructions live in the source repository linked above.