go-julep

Unofficial Go client for the Julep API, generated with oapi-codegen. julep.NewClientWithResponses(baseURL, opts...) from github.com/psyb0t/go-julep gives a typed method for every endpoint in Julep's OpenAPI spec (agents, agent docs and search, tools, tasks, executions and transitions, sessions and chat, users, files, secrets, projects, embeddings, jobs, health), with request structs and decoded JSON200/JSON201/JSON422 response fields. Auth is an API key in the Authorization header, added through a request editor. Use when Go code needs to call the Julep API, or already imports go-julep.

Typed Go client for the Julep API. Package julep, generated from the spec Julep publishes for its SDKs.

For install details, the method naming scheme and the operation list, see references/setup.md.

Security & safety

• Read the API key from an environment variable such as JULEP_API_KEY. Never hardcode it, commit it, or log it, and never print request headers.
• Requests and their data go only to the base URL passed to NewClientWithResponses: https://api.julep.ai/api, or https://dev.julep.ai/api when the user asks for dev.
• Delete, update, secret and execution calls change the user's account or start billed work. Call them only when the user asked for that change, and only on agents, users, sessions, tasks and secrets the task owns.

When to use

• Go code needs to manage Julep agents, users, sessions, tasks or docs, chat in a session, or start and inspect task executions.
• The project already imports github.com/psyb0t/go-julep.

When NOT to use

• The code is not Go. Julep ships official Python and Node SDKs.
• You need the execution status or transition streams as parsed events. The client has no server-sent events parser; poll GetExecutionDetailsExecutionsExecutionIdGet instead.

Usage

go

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

	"github.com/psyb0t/go-julep"
)

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

	return nil
})

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

limit := 10

agents, err := client.ListAgentsAgentsGetWithResponse(
	ctx,
	&julep.ListAgentsAgentsGetParams{Limit: &limit},
)
if err != nil {
	return err // transport failure
}

if agents.JSON200 == nil {
	return fmt.Errorf("list agents: status %d: %s", agents.StatusCode(), agents.Body)
}

for _, agent := range agents.JSON200.Items {
	fmt.Println(*agent.Id, agent.Name)
}

Creating a user (the API answers 201, so read JSON201):

go

name := "alice"

res, err := client.CreateUserUsersPostWithResponse(ctx, julep.CreateUserRequest{Name: &name})
if err != nil {
	return err
}

if res.JSON201 == nil {
	return fmt.Errorf("create user: status %d: %s", res.StatusCode(), res.Body)
}

fmt.Println(*res.JSON201.Id)

Errors

• A non-nil err is a transport or decoding failure.
• An HTTP error status is not an err. Check StatusCode(): the matching JSON200 or JSON201 field is set on success, JSON422 (*HTTPValidationError, with Detail) on a validation error, and Body always holds the raw response.