Praecise Harness v1.1.0 Get started

Documentation · Running

Config

Optional. A project needs none.

ts
// praecise.config.ts
import { defineConfig } from "@praecise/harness";

export default defineConfig({
  name: "Acme Support",
  quality: "balanced",
  port: 3000,
});

Every field is optional:

name, version, description What the app is called (the folder's name by default), the version it publishes itself as (0.1.0 by default), and one line on what it is for.
quality The default for every agent that does not set its own.
preference "cost", "balanced" (the default) or "quality": what to favour when cost and quality pull apart. Under "quality" the ladder is not climbed: the strongest rung answers at full depth and nothing is checked.
explore The share of routing decisions sent somewhere the estimate would not have sent them, so the routing record can be read back. Off by default; EXPLORATION (2%) is the value to use, and anything above 5% is clamped. Ignored under preference: "cost" and "quality".
port The dev server's port. 3000 by default.
models The endpoints, in the order they are preferred (see Install).
limits depth, concurrency (4 steps at once), timeout (600 seconds a step), budget (tokens a run may spend), calls, spend, retries and retryDelay.
store The store an agent remembers into when it asks for one without naming it.
stateDir Where runs, conversations, memory, recordings and the rest of the app's state are kept. .praecise by default.
strict Refuse where the framework would otherwise be friendly. An app with no model endpoint answers with a placeholder so that a new folder does something; with strict: true, or PRAECISE_STRICT set in the environment where the config says nothing, it refuses. An app whose configured endpoints cannot be reached refuses either way.
record Keep each exchange for praecise capture.
registries The indexes praecise search and praecise add read.
plugins Plugins.
ask What /ask may spend and where it reads: quality, mode (list, summarize, generate), agent, limit, store, type. Left out, /ask retrieves and ranks without reaching a model.
ingest How files become text for praecise ingest: using is native, model, mcp or cloud, beside the url and credential of the service that does it.
selves Where selves live.

Edit this page on GitHub · Read it as Markdown

    Type to search. Arrow keys move, Enter opens.