go-writer-ai

Unofficial Go client for the Writer (writer.com) API, generated from Writer's OpenAPI spec. writer.NewClientWithResponses("https://api.writer.com", auth) from github.com/psyb0t/go-writer-ai gives typed methods for chat (ChatWithResponse), text completions (CompletionsWithResponse), models (ModelsWithResponse), files (GatewayGetFilesWithResponse, GatewayUploadFileWithBodyWithResponse), Knowledge Graphs (CreateGraphWithResponse, QuestionWithResponse), no-code applications (GenerateContentWithResponse), the PDF parser, web search and vision, with responses decoded into JSON200. Auth is a Bearer API key set through a RequestEditorFn. Use when Go code needs to call the Writer API or already imports go-writer-ai.

Typed Go client for the Writer API. Package writer, generated with oapi-codegen; every operation in the spec is a method on ClientWithResponses.

For install, the full operation list and streaming, see references/setup.md.

Security & safety

• Read the API key from the WRITER_API_KEY environment variable. Never hardcode it, commit it, or log it, and never print request headers.
• Requests go only to the base URL you pass. Use https://api.writer.com.
• Prompts and uploaded files are sent to Writer. Upload files, and delete files or graphs, only when the user asked for it and only ones the task owns.

When to use

• Go code needs Writer chat, completions, Knowledge Graph questions, file uploads or no-code application runs.
• The project already imports github.com/psyb0t/go-writer-ai.

When NOT to use

• The code is not Go. Use Writer's official SDKs instead.
• You need a parsed streaming client. The generated client returns the raw *http.Response for stream: true; it does not parse server-sent events.

Usage

go

import (
	"context"
	"fmt"
	"net/http"
	"os"

	"github.com/psyb0t/go-writer-ai"
)

auth := writer.WithRequestEditorFn(func(_ context.Context, req *http.Request) error {
	req.Header.Set("Authorization", "Bearer "+os.Getenv("WRITER_API_KEY"))

	return nil
})

client, err := writer.NewClientWithResponses("https://api.writer.com", auth)
if err != nil {
	return err
}

models, err := client.ModelsWithResponse(ctx)
if err != nil {
	return err // transport error
}

if models.JSON200 == nil {
	return fmt.Errorf("models: %s", models.Status()) // API error, see models.Body
}

for _, model := range models.JSON200.Models {
	fmt.Println(model.Id, model.Name)
}

Chat:

go

var content writer.ChatMessage_Content
if err := content.FromChatMessageContent0("hello"); err != nil {
	return err
}

res, err := client.ChatWithResponse(ctx, writer.ChatRequest{
	Model: "<model-id>", // an Id from Models
	Messages: []writer.ChatMessage{{
		Content: &content,
		Role:    writer.ChatMessageRequestRoleUser,
	}},
})
if err != nil {
	return err
}

if res.JSON200 == nil || len(res.JSON200.Choices) == 0 {
	return fmt.Errorf("chat: %s", res.Status())
}

fmt.Println(res.JSON200.Choices[0].Message.Content)

Check JSON200 for nil before using it. On an error status the raw body is in Body.