Handwave is a thin wrapper around InstructorLite that makes it simpler to use vague handwaving in your apps.

It comes with 3 built-in providers (Handwave.OpenAI, Handwave.Claude and Handwave.Gemini) and behaviour to define your own.

Here’s its whole API surface:

1. Use llm_if when you can’t come up with a regular if:

import Handwave.OpenAI

llm_if user_email, "looks suspicious?" do
  {:error, :blocked}
else
  create_user(user_email)
end

2. Use llm_rewrite when you just need that term() -> 🧠🪄✨ -> string function:

iex> llm_rewrite(
          %Req.Response{status: 401, body: "session token expired"},
          "Tell user what to do without technical details"
        )
"Your session has expired. Please log in again to continue."

3. Use llm_route when you want LLM to just figure out what to do:

import Handwave.OpenAI

@impl Oban.Worker
def process(job) do
  # do things
catch
  kind, error ->
    formatted = Exception.format(kind, error, __STACKTRACE__)
    
    formatted
    |> llm_route([:snooze, :cancel, :error], "Snooze if it makes sense to try later, cancel if it's a lost cause, otherwise just error")
    |> case do
      :snooze -> {:snooze, 60}
      :cancel -> {:cancel, error}
      _ -> {:error, formatted}
    end
end

Have fun.

• Hex
• Repo

https://github.com/martosaur/handwave