Decisions that fit on a chip.

from sparrow_decider import Decider

d = Decider.load()   # bundled nano model

tools = {
    "flights":  "search and book flights",
    "refunds":  "refund a payment",
    "weather":  "forecasts for a city",
    "calendar": "create or move meetings",
}
answer = d.ask(
    "User: I was charged twice, I want my money back",
    {"tool": {"type": "choice",
              "instructions": "Which tool fits?",
              "criteria": tools}},
)["tool"]
print(answer["choice"], answer["confidence"])
# refunds 0.97

pip install sparrow-decider
sparrow-decider models
sparrow-decider ask "battery: 6%\nfront_obstacle_m: 7.0" --model nano-robot \
    --choice "What next?" -o "continue=keep going" -o "dock=go charge" -o "stop=halt"
sparrow-decider serve --port 8000        # POST /v1/systemone

#include "sparrow.h"
static sparrow_model m;
static sparrow_ctx ctx;   /* working memory; keep it static */

sparrow_load(&m, blob, blob_len);
float p_true = sparrow_noul(&m, &ctx, "motor_temp_c: 96\nmax_temp_c: 80", "Is the motor overheating?");
float conf;
int k = sparrow_choice(&m, &ctx, state, "Which skill?", opts, n_opts, &conf);
float level = sparrow_score(&m, &ctx, state, "How urgent?", levels, n_levels, &conf);

#include "sparrow.h"

extern const uint8_t model_start[] asm("_binary_model_spb_start");
extern const uint8_t model_end[]   asm("_binary_model_spb_end");
static sparrow_model model;
static sparrow_ctx ctx;

void app_main(void) {
    sparrow_load(&model, model_start, model_end - model_start);
    sparrow_option opts[] = {{"pick", "pick up an object"}, {"navigate", "move somewhere"},
                             {"speak", "answer the person"}};
    float conf;
    int k = sparrow_choice(&model, &ctx, "operator: bring me the red mug", "Which skill?", opts, 3, &conf);
}

{
  "name": "greenhouse",
  "context": "open vents when it is above 30 C; water when soil moisture is below 25%; never water and vent at the same time in frost.",
  "features": [
    {"name": "temp_c",        "type": "number", "min": -10, "max": 50},
    {"name": "soil_moisture", "type": "number", "min": 0,   "max": 100, "unit": "%"},
    {"name": "raining",       "type": "bool"},
    {"name": "time_of_day",   "type": "enum", "values": ["night", "morning", "afternoon", "evening"]}
  ],
  "questions": {
    "action":   {"type": "choice", "instructions": "What should the controller do now?",
                 "criteria": {"nothing": "no change", "water": "start watering",
                              "vent": "open the vents", "heat": "turn on the heater"}},
    "alert":    {"type": "noul", "instructions": "Should the grower be alerted?"},
    "stress":   {"type": "score", "instructions": "How stressed are the plants?",
                 "criteria": ["fine", "mild", "severe"]}
  }
}

#include "sparrow_pico_greenhouse.h"

greenhouse_state s = {.temp_c = 34.0f, .soil_moisture = 40.0f, .raining = 0,
                      .time_of_day = GREENHOUSE_TIME_OF_DAY_AFTERNOON};
float p[GREENHOUSE_ACTION_N];
greenhouse_action(&s, p);                  /* probabilities over the options */