SDK · Go
Minds, idiomatic in Go.
The Go SDK is what powers the `mind` TUI. Production-grade, gRPC-first, with the conventions Go developers expect: options pattern, context-aware, errors-as-values.
Capabilities
What you get.
Production-grade from day one. No flags, no betas — these ship when you adopt Minds.
Options pattern
`minds.New(minds.WithEnv(), minds.WithTimeout(30*time.Second))`.
Context-aware
Every call takes a `ctx context.Context` as first arg.
Errors-as-values
Typed sentinel errors and `errors.Is`-friendly wrappers.
gRPC + protobuf
First-class with generated stubs; no runtime reflection.
Streaming
Channel-based streaming for generation and analytics.
Used in production
The `mind` TUI binary uses this SDK exclusively.
API
A few lines is all it takes.
exampletypescript
import "github.com/l1feai/minds-go-sdk/minds"
m := minds.New(minds.WithEnv())
ctx := context.Background()
memories, err := m.Recall(ctx, &minds.RecallRequest{
Query: "Why did Q3 revenue dip?",
Modes: []minds.Mode{minds.Vector, minds.Graph, minds.Episodic},
Timepoint: "2026-10-01",
TopK: 5,
})
for _, mem := range memories {
fmt.Println(mem.Confidence, mem.Source, mem.Text)
}Specs
What it costs, what it guarantees.
At a glance
- Module
- github.com/l1feai/minds-go-sdk
- Go
- 1.21+
- Wire
- gRPC + protobuf
- Streaming
- channel-based
- Used by
- mind TUI
Guarantees
- Durability
- fsync per WAL commit
- Isolation
- MVCC · snapshot
- Audit
- BLAKE3 Merkle chain
- Encryption
- AES-256-GCM per-namespace
- Concurrency
- 100K+ ops/sec
Get started in an afternoon.
Run anywhere — Akasha Cloud, on-prem, or air-gapped.