Docs

Universal API

Every task Computron has learned becomes a function you can call by name, as often as you like.

It is a local API. Calls run on your own PC, in a headless Chrome that carries your own sign-ins. If a site needs it, the run continues in a background tab of your Chrome. Functions, arguments, results and schedules stay on your PC; they are not sent to Computron's servers.

Functions

A function is a task Computron has learned once, with named parameters. Post on X, upload a video, check revenue on a dashboard: the first run takes a while because Computron learns the way. Repeats follow the recorded steps, usually with no generative model calls; reading a value off the page or finding the way after a site changed can take one, and modelCalls in the result says how many.

A function with parameters is learned from the values it was first run with. The first calls with other values may be learned again, which takes about as long as the first run; after two or three different values, a new value follows the recorded steps.

Tasks that end at a wall only a person can clear, such as a phone confirmation or a CAPTCHA, are not made into functions.

computron functions
computron functions --json
computron functions rm <name>

You can rename functions in the local console.

Your first call

Give a task in plain words. Computron runs it, learns it, and registers a function:

computron call --task "Search en.wikipedia.org for Kyoto and tell me its population" --json

The result names the new function in registered. Calling a function that already exists is faster and takes arguments.

Calling a function

From the command line, each parameter is a --<name> <value> flag:

computron call wikipedia.search --query Osaka --json

Over HTTP, run computron api on once. It creates a token and stores it in ~/.computron/api_token. The server listens on http://127.0.0.1:52367 and is reachable only from the same PC. Send the token as a bearer token:

curl http://127.0.0.1:52367/v1/functions/wikipedia.search \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"query":"Osaka"}'
RouteDoes
GET /v1/functionsLists functions. Each has a JSON Schema inputSchema.
POST /v1/functions/{name}Calls a function. The body is the arguments as JSON.
POST /v1/callBody {"function": "...", "args": {...}} calls a function; {"task": "..."} runs a task in words.
GET /v1/openapi.jsonThe OpenAPI description of these routes.

A request that carries a browser Origin header is refused, so web pages cannot call the API. Rotate the token with computron api rotate, and switch the API off with computron api off.

Idempotency key

A retry should not run twice. Send a key with the call, --key <key> on the command line or an Idempotency-Key header over HTTP, and a retry with the same key returns the first result instead of running again. While the first call is still running, the retry gets in_progress.

The result

{
  "callId": "c_...",
  "function": "x.post",
  "status": "succeeded",
  "output": null,
  "path": ["headless:recorded"],
  "ms": 4200,
  "modelCalls": 0,
  "choiceCalls": 0,
  "pressed": ["Post"],
  "registered": null,
  "replayed": false
}

status is one of:

  • succeeded: the run finished and the result was confirmed.
  • failed: it did not finish. See reasonCode.
  • unconfirmed: something irreversible was pressed, but the result could not be confirmed. Check the site yourself. Never run it again blindly.

modelCalls counts the generative model calls of the call; a repeat that follows its recorded steps has none. choiceCalls counts the quick calls that pick a step when a page changed.path says how each run went: recorded (followed the recorded steps),decided (decided step by step) or learned (learned first), in the hidden Chrome (headless) or a background tab of your Chrome (chrome). pressed lists the irreversible buttons it pressed.

Reason codes

A failed call carries a reasonCode:

reasonCodeMeaning
human_wallThe site asked for something only a person can do, such as a CAPTCHA or a phone check.
invalid_argsThe arguments do not match the function's inputSchema.
unknown_functionNo function has that name.
disabledThe API is switched off. Run computron api on.
in_progressA call with the same key is still running.
key_reusedThe key was used before for a different call.
not_signed_inThe site is not signed in with your account.
consent_requiredYour Computron account has not agreed to the current Privacy Policy.
out_of_creditsYour Computron account has no credits left.
browser_unavailableNo Chrome could be started or reached.
outcome_unknownThe run ended without a result you can rely on.
server_behindComputron's server is behind this version. Try again later.
failedAny other failure.

Over HTTP, any call result comes back as 200, whatever its status. Other codes mean the request itself was wrong: 400 bad body, 401 bad token, 403 origin or host refused, 404 unknown function, 409 a call with the same key is still running.

Credits

Each call is a Computron run and uses credits the same way as any run. See pricing, and your balance on the account page.

Local console

computron console opens http://127.0.0.1:52367/console: your functions with a form to try each one, recent calls, schedules, the API key and the MCP setup. It signs you in with a one-time code, so there is nothing to copy.

Next

Give an agent the same functions with MCP, or run them on a timer with schedules.