mirror of
https://github.com/luxfi/crypto.git
synced 2026-07-27 01:54:50 +00:00
Hanzo AI
ddff44bbee
Adds the canonical runtime substrate selector for luxfi/crypto and decomplects
all per-algorithm GPU dispatchers behind it.
New `backend` API:
- Default()/SetDefault/Resolved()/IsGPU/IsCGo/IsVanilla — runtime selection
- CGoAvailable()/GPUAvailable() — real probes (was stubbed)
- Probe() returning Snapshot{Default, Resolved, CGo, GPU, Disabled,
GPUBackend, GPUDeviceCount, AccelVersion, Fallbacks}
- GPUDisabled() reads LUX_GPU_DISABLE operator kill switch
- RecordFallback(reason, where) atomic counter + one-shot log per reason,
low-cardinality FallbackReason enum (disabled / unsupported / probe_failed
/ backend_unavailable / abi_mismatch)
Dispatcher cleanup (one-and-one-way):
- All Resolve(gpuhost.Available(), false) call sites replaced with IsGPU()
- hqc switched to IsVanilla() (its accel batch wins for any non-vanilla pick)
- gpu/gpu.go now delegates entirely to backend (no separate session)
- internal/gpuhost dropped Snapshot()/Provenance — backend.Probe() canonical
Build tag policy: CGo is the only gate. There is no `gpu` build tag.
LLM.md documents the canonical surface.
73 lines
2.0 KiB
Go
73 lines
2.0 KiB
Go
// Package gpuhost provides the runtime hook between luxfi/crypto algorithm
|
|
// packages and github.com/luxfi/accel.
|
|
//
|
|
// gpuhost owns a singleton accel session and exposes thin helpers that
|
|
// algorithm packages call to ask "is GPU available right now?" and to
|
|
// fetch the session for batch operations.
|
|
//
|
|
// gpuhost is internal: callers outside luxfi/crypto must use the public
|
|
// dispatchers in each algorithm package, which call gpuhost.
|
|
package gpuhost
|
|
|
|
import (
|
|
"sync"
|
|
|
|
"github.com/luxfi/accel"
|
|
)
|
|
|
|
var (
|
|
once sync.Once
|
|
sess *accel.Session
|
|
initErr error
|
|
available bool
|
|
)
|
|
|
|
// Init initialises accel exactly once and creates the shared session.
|
|
// Safe to call from any goroutine. Subsequent calls are no-ops.
|
|
func Init() {
|
|
once.Do(func() {
|
|
if err := accel.Init(); err != nil {
|
|
initErr = err
|
|
return
|
|
}
|
|
if !accel.Available() {
|
|
return // accel ready but no devices; available stays false
|
|
}
|
|
s, err := accel.NewSession()
|
|
if err != nil {
|
|
initErr = err
|
|
return
|
|
}
|
|
sess = s
|
|
available = true
|
|
})
|
|
}
|
|
|
|
// Available returns true when an accel session was successfully created
|
|
// and is currently usable. Algorithm packages check this before deciding
|
|
// to dispatch to the GPU path.
|
|
func Available() bool {
|
|
Init()
|
|
return available
|
|
}
|
|
|
|
// Session returns the shared accel.Session, or nil if no GPU is available.
|
|
// Callers must check Available() first or guard nil at the call site.
|
|
func Session() *accel.Session {
|
|
Init()
|
|
return sess
|
|
}
|
|
|
|
// InitError returns the last error from accel initialisation. It is
|
|
// non-nil only when the accel library itself failed to load; an
|
|
// "accel works, no device" state returns nil.
|
|
func InitError() error {
|
|
Init()
|
|
return initErr
|
|
}
|
|
|
|
// Diagnostic snapshots live in github.com/luxfi/crypto/backend (Probe()).
|
|
// gpuhost stays narrow: Init / Available / Session / InitError — the
|
|
// substrate primitives. Anything richer is a diagnostic question and
|
|
// belongs in backend, which is the canonical runtime substrate selector.
|