feat: add simple helpers for various providers

providers/cerebras/cerebras.go

@@ -0,0 +1,22 @@
+package cerebras
+
+import (
+	"charm.land/fantasy"
+	"charm.land/fantasy/providers/openaicompat"
+)
+
+const (
+	Name = "cerebras"
+	BaseURL = "https://api.cerebras.ai/v1"
+)
+
+type Option = openaicompat.Option
+
+func New(opts ...Option) (fantasy.Provider, error) {
+	options := []Option{
+		openaicompat.WithName(Name),
+		openaicompat.WithBaseURL(BaseURL),
+	}
+	options = append(options, opts...)
+	return openaicompat.New(options...)
+}

providers/groq/groq.go

@@ -0,0 +1,22 @@
+package groq
+
+import (
+	"charm.land/fantasy"
+	"charm.land/fantasy/providers/openaicompat"
+)
+
+const (
+	Name = "groq"
+	BaseURL = "https://api.groq.com/openai/v1"
+)
+
+type Option = openaicompat.Option
+
+func New(opts ...Option) (fantasy.Provider, error) {
+	options := []Option{
+		openaicompat.WithName(Name),
+		openaicompat.WithBaseURL(BaseURL),
+	}
+	options = append(options, opts...)
+	return openaicompat.New(options...)
+}

providers/huggingface/huggingface.go

@@ -0,0 +1,22 @@
+package huggingface
+
+import (
+	"charm.land/fantasy"
+	"charm.land/fantasy/providers/openaicompat"
+)
+
+const (
+	Name = "huggingface"
+	BaseURL = "https://router.huggingface.co/v1"
+)
+
+type Option = openaicompat.Option
+
+func New(opts ...Option) (fantasy.Provider, error) {
+	options := []Option{
+		openaicompat.WithName(Name),
+		openaicompat.WithBaseURL(BaseURL),
+	}
+	options = append(options, opts...)
+	return openaicompat.New(options...)
+}

providers/xai/xai.go

@@ -0,0 +1,22 @@
+package xai
+
+import (
+	"charm.land/fantasy"
+	"charm.land/fantasy/providers/openaicompat"
+)
+
+const (
+	Name = "xai"
+	BaseURL = "https://api.x.ai/v1"
+)
+
+type Option = openaicompat.Option
+
+func New(opts ...Option) (fantasy.Provider, error) {
+	options := []Option{
+		openaicompat.WithName(Name),
+		openaicompat.WithBaseURL(BaseURL),
+	}
+	options = append(options, opts...)
+	return openaicompat.New(options...)
+}

providers/zai/zai.go

@@ -0,0 +1,22 @@
+package zai
+
+import (
+	"charm.land/fantasy"
+	"charm.land/fantasy/providers/openaicompat"
+)
+
+const (
+	Name = "zai"
+	BaseURL = "https://api.z.ai/api/coding/paas/v4"
+)
+
+type Option = openaicompat.Option
+
+func New(opts ...Option) (fantasy.Provider, error) {
+	options := []Option{
+		openaicompat.WithName(Name),
+		openaicompat.WithBaseURL(BaseURL),
+	}
+	options = append(options, opts...)
+	return openaicompat.New(options...)
+}

providertests/cerebras_test.go

@@ -0,0 +1,29 @@
+package providertests
+
+import (
+	"net/http"
+	"os"
+	"testing"
+
+	"charm.land/fantasy"
+	"charm.land/fantasy/providers/cerebras"
+	"charm.land/fantasy/providers/openaicompat"
+	"gopkg.in/dnaeon/go-vcr.v4/pkg/recorder"
+)
+
+func TestCerebrasCommon(t *testing.T) {
+	testCommon(t, []builderPair{
+		{"cerebras-qwen-3-coder-480b", builderCerebras, nil, nil},
+	})
+}
+
+func builderCerebras(t *testing.T, r *recorder.Recorder) (fantasy.LanguageModel, error) {
+	provider, err := cerebras.New(
+		openaicompat.WithAPIKey(os.Getenv("FANTASY_CEREBRAS_API_KEY")),
+		openaicompat.WithHTTPClient(&http.Client{Transport: r}),
+	)
+	if err != nil {
+		return nil, err
+	}
+	return provider.LanguageModel(t.Context(), "qwen-3-coder-480b")
+}

providertests/groq_test.go

@@ -0,0 +1,29 @@
+package providertests
+
+import (
+	"net/http"
+	"os"
+	"testing"
+
+	"charm.land/fantasy"
+	"charm.land/fantasy/providers/groq"
+	"charm.land/fantasy/providers/openaicompat"
+	"gopkg.in/dnaeon/go-vcr.v4/pkg/recorder"
+)
+
+func TestGroqCommon(t *testing.T) {
+	testCommon(t, []builderPair{
+		{"groq-kimi-k2-0905", builderGroqProvider, nil, nil},
+	})
+}
+
+func builderGroqProvider(t *testing.T, r *recorder.Recorder) (fantasy.LanguageModel, error) {
+	provider, err := groq.New(
+		openaicompat.WithAPIKey(os.Getenv("FANTASY_GROQ_API_KEY")),
+		openaicompat.WithHTTPClient(&http.Client{Transport: r}),
+	)
+	if err != nil {
+		return nil, err
+	}
+	return provider.LanguageModel(t.Context(), "moonshotai/kimi-k2-instruct-0905")
+}

providertests/huggingface_test.go

@@ -0,0 +1,29 @@
+package providertests
+
+import (
+	"net/http"
+	"os"
+	"testing"
+
+	"charm.land/fantasy"
+	"charm.land/fantasy/providers/huggingface"
+	"charm.land/fantasy/providers/openaicompat"
+	"gopkg.in/dnaeon/go-vcr.v4/pkg/recorder"
+)
+
+func TestHuggingFaceCommon(t *testing.T) {
+	testCommon(t, []builderPair{
+		{"huggingface-glm-4.6", builderHuggingFaceProvider, nil, nil},
+	})
+}
+
+func builderHuggingFaceProvider(t *testing.T, r *recorder.Recorder) (fantasy.LanguageModel, error) {
+	provider, err := huggingface.New(
+		openaicompat.WithAPIKey(os.Getenv("FANTASY_HUGGINGFACE_API_KEY")),
+		openaicompat.WithHTTPClient(&http.Client{Transport: r}),
+	)
+	if err != nil {
+		return nil, err
+	}
+	return provider.LanguageModel(t.Context(), "zai-org/GLM-4.6")
+}