voiceagent

package

v0.48.1 Latest Latest Go to latest Published: Jun 28, 2026 License: Apache-2.0 Imports: 3 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/kombifyio/SpeechKit

Links

Open Source Insights

Documentation ¶

Overview ¶

Package voiceagent provides an embeddable Voice Agent service.

Voice Agent is the realtime audio-to-audio mode: a duplex WebSocket session with the underlying live model (Gemini Live, OpenAI Realtime, or a pipeline fallback) where the user and the agent take audio turns in sequence. Use this when the host needs brainstorming, support, or follow-up dialogue rather than a one-shot result.

For tool registration, lifecycle hooks, and session memory, build on top of this with github.com/kombifyio/SpeechKit/pkg/speechkit/agentkit.

Construct an instance with [New], passing a provider and the strict- mode policy fields from the host config.

Index ¶

Variables
type Callbacks
type Config
type Options
type Provider
type Service
- func NewService(opts Options) (*Service, error)

Constants ¶

This section is empty.

Variables ¶

View Source

var ErrMissingProvider = errors.New("speechkit voiceagent: provider is required")

Functions ¶

This section is empty.

Types ¶

type Callbacks ¶

type Callbacks struct {
	OnAudio func([]byte)
	OnText  func(string)
	OnError func(error)
}

type Config ¶

type Config struct {
	ProviderProfileID string
	Model             string
	Locale            string
	Instruction       string
}

type Options ¶

type Options struct {
	Config    Config
	Callbacks Callbacks
	Provider  Provider
}

type Provider ¶

type Provider interface {
	StartVoiceAgent(context.Context, Config, Callbacks) error
	StopVoiceAgent(context.Context) (speechkit.VoiceAgentSession, error)
	SendText(context.Context, string) error
	CurrentSession(context.Context) (speechkit.VoiceAgentSession, error)
}

type Service ¶

type Service struct {
	// contains filtered or unexported fields
}

func NewService ¶

func NewService(opts Options) (*Service, error)

func (*Service) CurrentSession ¶

func (s *Service) CurrentSession(ctx context.Context) (speechkit.VoiceAgentSession, error)

func (*Service) SendText ¶

func (s *Service) SendText(ctx context.Context, text string) error

func (*Service) Start ¶

func (s *Service) Start(ctx context.Context) error

func (*Service) Stop ¶

func (s *Service) Stop(ctx context.Context) (speechkit.VoiceAgentSession, error)

Source Files ¶

View all Source files

service.go

Directories ¶

Path	Synopsis
cascaded Package cascaded implements a turn-based STT -> LLM -> TTS voice agent provider.	Package cascaded implements a turn-based STT -> LLM -> TTS voice agent provider.
live Package live exposes the low-level Voice Agent realtime-protocol types.	Package live exposes the low-level Voice Agent realtime-protocol types.
livecontract Package livecontract provides reusable conformance checks for LiveProvider implementations.	Package livecontract provides reusable conformance checks for LiveProvider implementations.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL