Skip to content

Providers

decide runs on four decision models, through the same commands and templates:

  • Jev by TypeSafe, the default, with the jev-latest model. It reads text only:

    Terminal window
    export TYPESAFE_API_KEY=...
  • Clef by Cloudflare Workers AI, with the clef model, or clef-flash for lower latency. It takes images of up to 4 MiB and 16 megapixels each.

    Terminal window
    export CLOUDFLARE_AUTH_TOKEN=...
    export CLOUDFLARE_ACCOUNT_ID=...
    export DECIDE_PROVIDER=cloudflare

    Set CLOUDFLARE_BASE_URL to send requests somewhere other than Workers AI.

  • GPT-6 Luna by OpenAI, with the gpt-6-luna model, through the Decisions API, which is in beta. It takes images of up to 50 MiB each. Set OPENAI_BASE_URL to send requests somewhere other than https://api.openai.com/v1.

    Terminal window
    export OPENAI_API_KEY=...
    export DECIDE_PROVIDER=openai
  • Gemini Decision by Google, with the gemini-decision-1 model, through the Gemini Decisions API, which is in beta. It is the only provider for audio, video, and PDF templates, and it runs image templates too. It takes files of up to about 70 MiB, or about 35 MiB for a PDF. Set GEMINI_BASE_URL to send requests somewhere other than https://generativelanguage.googleapis.com/v1beta.

    Terminal window
    export GEMINI_API_KEY=...
    export DECIDE_PROVIDER=gemini

Any other service that speaks the Jev API works too, such as one you host yourself. Point decide at it with TYPESAFE_BASE_URL, along with TYPESAFE_API_KEY and a model name:

Terminal window
export TYPESAFE_BASE_URL=https://decisions.example.com
decide run sentiment notes.txt --model my-model

Choose for one run with --provider and --model, or for every run with DECIDE_PROVIDER and DECIDE_MODEL. Check your setup with decide models.

Every provider reads text. Only some read images, audio, video, and PDFs:

Provider Images Audio Video PDFs
Jev no no no no
Clef yes no no no
GPT-6 Luna yes no no no
Gemini Decision yes yes yes yes

decide reads PNG, JPEG, and WebP images; MP3, WAV, M4A, AAC, FLAC, OGG, Opus, AIFF, and WebM audio; MP4, MOV, WebM, MPEG, AVI, WMV, FLV, and 3GP video; and PDFs. It picks files by their extension and does not read other files, such as .gif and .heic images. Convert them first; renaming a file does not change what it is.

decide uses --provider, then DECIDE_PROVIDER, then TypeSafe, or, for a media template, the first provider for its kind with a key set. So an image template with no provider set runs on the first of Cloudflare, OpenAI, and Gemini whose credentials are set, and an audio, video, or PDF template runs on Gemini. The files you name never change the provider.

A text template also takes an image, audio, video, or PDF file that you name, and a media template takes only media files; see Items. A provider that can’t read a file you name stops the run before anything is sent, and the error names the providers that do.

decide is Apache 2.0. Made by Deep Noodle, after some very hard thinking.