Skip to content

BrainAPI is a knowledge graph–powered AI memory layer that transforms unstructured data into structured knowledge, enabling intelligent search, recommendations, and contextual memory for AI agents and applications.

Add hybrid non-interactive flags for brainapi init.

Christianb081bad0d619
diff --git a/tui/README.md b/tui/README.md
index 373c64d..5cd5072 100644
--- a/tui/README.md
+++ b/tui/README.md
@@ -18,6 +18,43 @@ brainapi start # start docker compose services + run the API
brainapi doctor # check Python, Docker, Ollama, and configured services
```
+### Non-interactive / hybrid init
+
+Any value you pass as a flag skips that wizard prompt; everything else is still asked.
+
+```bash
+brainapi init \
+ --vector-db=postgresql \
+ --data-db=postgresql \
+ --graph-db=networkx \
+ --models-mode=remote \
+ --llm-small-provider=openai \
+ --llm-large-provider=openai \
+ --embeddings-provider=openai \
+ --openai-api-key=sk-... \
+ --llm-small=gpt-4o-mini \
+ --llm-large=gpt-4o \
+ --brainpat-token=brainpat_... \
+ --no-plugins \
+ --no-start-services
+```
+
+`brainapi --init ...` is an alias for `brainapi init ...`.
+
+| Flag group | Examples |
+| --- | --- |
+| Defaults / DBs | `--defaults`, `--vector-db`, `--data-db`, `--graph-db` |
+| Pipeline / runtime | `--ocr-mode`, `--services-runtime`, `--start-services`, `--no-start-services` |
+| Models | `--models-mode`, `--llm-small-provider`, `--llm-large-provider`, `--embeddings-provider`, `--llm-small`, `--llm-large`, `--embedding-model`, `--embedding-dimensions` |
+| Ollama | `--ollama-host`, `--ollama-port`, `--ollama-small`, `--ollama-large`, `--ollama-embeddings` |
+| GCP | `--gcp-credentials`, `--gcp-project`, `--gcp-small`, `--gcp-large`, `--gcp-embedding` |
+| Azure | `--azure-endpoint`, `--azure-api-version`, `--azure-key`, `--azure-small`, `--azure-large`, `--azure-embedding-endpoint`, `--azure-embedding-key`, `--azure-embedding` |
+| OpenAI / Anthropic / DeepSeek | `--openai-api-key`, `--openai-base-url`, `--openai-small`, `--openai-large`, `--openai-embedding`, `--anthropic-api-key`, `--anthropic-small`, `--anthropic-large`, `--deepseek-api-key`, `--deepseek-small`, `--deepseek-large` |
+| Bedrock | `--aws-region`, `--aws-access-key-id`, `--aws-secret-access-key`, `--aws-session-token`, `--bedrock-small`, `--bedrock-large`, `--bedrock-embedding` |
+| Connections | `--redis-host`, `--redis-port`, `--postgres-*`, `--neo4j-*`, `--milvus-*`, `--mongo-*` |
+| Auth / plugins | `--brainpat-token`, `--plugin <name[@version]>` (repeatable), `--no-plugins` |
+
+If any config flag is present (or `--defaults`), the “Use default settings?” question is skipped.
## Commands
| Command | Description |
diff --git a/tui/package-lock.json b/tui/package-lock.json
index 5b83b7c..3ff6c98 100644
--- a/tui/package-lock.json
+++ b/tui/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "brainapi-tui",
- "version": "0.2.0",
+ "version": "0.3.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "brainapi-tui",
- "version": "0.2.0",
+ "version": "0.3.0",
"license": "MIT",
"dependencies": {
"@clack/prompts": "^0.7.0",
diff --git a/tui/package.json b/tui/package.json
index 7b8fc38..f4ce04c 100644
--- a/tui/package.json
+++ b/tui/package.json
@@ -1,6 +1,6 @@
{
"name": "brainapi-tui",
- "version": "0.2.0",
+ "version": "0.3.0",
"description": "Interactive installer and runtime CLI for BrainAPI.",
"license": "MIT",
"type": "module",
diff --git a/tui/src/commands/init.ts b/tui/src/commands/init.ts
index f637b44..172bf87 100644
--- a/tui/src/commands/init.ts
+++ b/tui/src/commands/init.ts
@@ -26,6 +26,10 @@ import { bringUpServices, bringUpServicesManually } from "../lib/bring-up.js";
import { targetFromConnections } from "../lib/service-target.js";
import { askConfirm } from "../lib/prompts.js";
import { installLocalPlugin, installRegistryPlugin } from "../lib/plugins.js";
+import {
+ hasConfigOverrides,
+ type InitFlagOverrides,
+} from "../lib/init-flags.js";
import type {
Connections,
DbChoices,
@@ -39,6 +43,7 @@ export interface InitOptions {
repoUrl?: string;
branch?: string;
force?: boolean;
+ flags?: InitFlagOverrides;
}
function intro(): void {
@@ -117,12 +122,13 @@ async function installPhase(extras: string[]): Promise<void> {
p.log.success("Dependencies installed");
}
-async function configurePhase(): Promise<InitChoices> {
+async function configurePhase(flags?: InitFlagOverrides): Promise<InitChoices> {
const draft: SetupDraft = {};
await runSetupWizard(draft, {
firstStepBack: "cancel",
firstStepBackHint: "Cancel setup",
stepBackHint: "Previous step",
+ flags,
});
return toInitChoices(draft);
}
@@ -131,6 +137,7 @@ async function servicesPhase(
dbs: DbChoices,
connections: Connections,
runtime: ServicesRuntime,
+ startServices?: boolean,
): Promise<void> {
const services = pickedServices(dbs);
const items = services.map((service) => ({
@@ -149,10 +156,20 @@ async function servicesPhase(
return;
}
- const startNow = await askConfirm({
- message: "Start docker compose containers now for the services you picked?",
- initialValue: true,
- });
+ let startNow: boolean;
+ if (startServices !== undefined) {
+ startNow = startServices;
+ p.log.info(
+ startNow
+ ? "Starting docker compose containers (--start-services)."
+ : "Skipping docker compose containers (--no-start-services).",
+ );
+ } else {
+ startNow = await askConfirm({
+ message: "Start docker compose containers now for the services you picked?",
+ initialValue: true,
+ });
+ }
if (!startNow) {
p.log.info(
"Skipping. Start them later with " +
@@ -221,6 +238,10 @@ export async function runInit(opts: InitOptions = {}): Promise<void> {
await writeState(defaultState());
}
+ if (opts.flags && hasConfigOverrides(opts.flags)) {
+ p.log.info("Using CLI flags for setup — skipping prompts for provided values.");
+ }
+
let python = await ensurePython();
await clonePhase(opts);
@@ -232,7 +253,7 @@ export async function runInit(opts: InitOptions = {}): Promise<void> {
await ensureVenv(python.bin);
- const choices = await configurePhase();
+ const choices = await configurePhase(opts.flags);
const extras = [
...ocrToExtras(choices.pipeline.ocrMode),
...postgresBackendExtras(choices.dbs),
@@ -250,6 +271,7 @@ export async function runInit(opts: InitOptions = {}): Promise<void> {
choices.dbs,
choices.connections,
choices.servicesRuntime,
+ opts.flags?.startServices,
);
outro();
diff --git a/tui/src/flows/auth.ts b/tui/src/flows/auth.ts
index 01f919d..4ff4411 100644
--- a/tui/src/flows/auth.ts
+++ b/tui/src/flows/auth.ts
@@ -8,15 +8,24 @@ function generateToken(): string {
return `brainpat_${randomBytes(24).toString("hex")}`;
}
-export async function askAuth(opts?: { allowBack?: false }): Promise<AuthChoices>;
+export async function askAuth(opts?: {
+ allowBack?: false;
+ prechosenToken?: string;
+}): Promise<AuthChoices>;
export async function askAuth(opts: {
allowBack: true;
backHint?: string;
+ prechosenToken?: string;
}): Promise<AuthChoices | PromptBack>;
export async function askAuth(opts?: {
allowBack?: boolean;
backHint?: string;
+ prechosenToken?: string;
}): Promise<AuthChoices | PromptBack> {
+ if (opts?.prechosenToken) {
+ return { brainpatToken: opts.prechosenToken };
+ }
+
p.log.step("Authentication token");
const action = opts?.allowBack
diff --git a/tui/src/flows/connections.ts b/tui/src/flows/connections.ts
index 185c93e..9a1f5d4 100644
--- a/tui/src/flows/connections.ts
+++ b/tui/src/flows/connections.ts
@@ -1,5 +1,6 @@
import * as p from "@clack/prompts";
import { SERVICE_DEFAULTS } from "../constants.js";
+import type { InitFlagOverrides } from "../lib/init-flags.js";
import { askPassword, askText, pickOne } from "../lib/prompts.js";
import type {
Connections,
@@ -18,26 +19,31 @@ function portValidator(value: string): string | undefined {
return undefined;
}
-async function askRedis(): Promise<RedisConnection> {
+async function askRedis(flags?: InitFlagOverrides): Promise<RedisConnection> {
p.log.step("Redis (required for cache + Celery)");
- const host = await askText({
- message: "Redis host",
- placeholder: SERVICE_DEFAULTS.redis.host,
- defaultValue: SERVICE_DEFAULTS.redis.host,
- });
- const port = await askText({
- message: "Redis port",
- placeholder: String(SERVICE_DEFAULTS.redis.port),
- defaultValue: String(SERVICE_DEFAULTS.redis.port),
- validate: portValidator,
- });
- return {
- host: host.trim() || SERVICE_DEFAULTS.redis.host,
- port: Number(port) || SERVICE_DEFAULTS.redis.port,
- };
+ let host = flags?.redisHost;
+ if (host === undefined) {
+ const raw = await askText({
+ message: "Redis host",
+ placeholder: SERVICE_DEFAULTS.redis.host,
+ defaultValue: SERVICE_DEFAULTS.redis.host,
+ });
+ host = raw.trim() || SERVICE_DEFAULTS.redis.host;
+ }
+ let port = flags?.redisPort;
+ if (port === undefined) {
+ const raw = await askText({
+ message: "Redis port",
+ placeholder: String(SERVICE_DEFAULTS.redis.port),
+ defaultValue: String(SERVICE_DEFAULTS.redis.port),
+ validate: portValidator,
+ });
+ port = Number(raw) || SERVICE_DEFAULTS.redis.port;
+ }
+ return { host, port };
}
-async function askPostgres(): Promise<PostgresConnection> {
+async function askPostgres(flags?: InitFlagOverrides): Promise<PostgresConnection> {
p.log.step("PostgreSQL");
p.note(
[
@@ -47,162 +53,227 @@ async function askPostgres(): Promise<PostgresConnection> {
].join("\n"),
"Heads up"
);
- const host = await askText({
- message: "Postgres host",
- placeholder: SERVICE_DEFAULTS.postgresql.host,
- defaultValue: SERVICE_DEFAULTS.postgresql.host,
- });
- const port = await askText({
- message: "Postgres port",
- placeholder: String(SERVICE_DEFAULTS.postgresql.port),
- defaultValue: String(SERVICE_DEFAULTS.postgresql.port),
- validate: portValidator,
- });
- const username = await askText({
- message: "Postgres username",
- placeholder: SERVICE_DEFAULTS.postgresql.username,
- defaultValue: SERVICE_DEFAULTS.postgresql.username,
- });
- const password = await askPassword({
- message: "Postgres password (default is 'password')",
- validate: (value) =>
- value.length === 0 ? "Password is required" : undefined,
- });
- const systemDatabase = await askText({
- message: `System database (brains registry, default ${SERVICE_DEFAULTS.postgresql.systemDatabase})`,
- placeholder: SERVICE_DEFAULTS.postgresql.systemDatabase,
- defaultValue: SERVICE_DEFAULTS.postgresql.systemDatabase,
- });
- const maintenanceDatabase = await askText({
- message: `Maintenance database (for CREATE DATABASE, default ${SERVICE_DEFAULTS.postgresql.maintenanceDatabase})`,
- placeholder: SERVICE_DEFAULTS.postgresql.maintenanceDatabase,
- defaultValue: SERVICE_DEFAULTS.postgresql.maintenanceDatabase,
- });
+ let host = flags?.postgresHost;
+ if (host === undefined) {
+ const raw = await askText({
+ message: "Postgres host",
+ placeholder: SERVICE_DEFAULTS.postgresql.host,
+ defaultValue: SERVICE_DEFAULTS.postgresql.host,
+ });
+ host = raw.trim() || SERVICE_DEFAULTS.postgresql.host;
+ }
+ let port = flags?.postgresPort;
+ if (port === undefined) {
+ const raw = await askText({
+ message: "Postgres port",
+ placeholder: String(SERVICE_DEFAULTS.postgresql.port),
+ defaultValue: String(SERVICE_DEFAULTS.postgresql.port),
+ validate: portValidator,
+ });
+ port = Number(raw) || SERVICE_DEFAULTS.postgresql.port;
+ }
+ let username = flags?.postgresUsername;
+ if (username === undefined) {
+ const raw = await askText({
+ message: "Postgres username",
+ placeholder: SERVICE_DEFAULTS.postgresql.username,
+ defaultValue: SERVICE_DEFAULTS.postgresql.username,
+ });
+ username = raw.trim() || SERVICE_DEFAULTS.postgresql.username;
+ }
+ let password = flags?.postgresPassword;
+ if (password === undefined) {
+ password = await askPassword({
+ message: "Postgres password (default is 'password')",
+ validate: (value) =>
+ value.length === 0 ? "Password is required" : undefined,
+ });
+ }
+ let systemDatabase = flags?.postgresSystemDb;
+ if (systemDatabase === undefined) {
+ const raw = await askText({
+ message: `System database (brains registry, default ${SERVICE_DEFAULTS.postgresql.systemDatabase})`,
+ placeholder: SERVICE_DEFAULTS.postgresql.systemDatabase,
+ defaultValue: SERVICE_DEFAULTS.postgresql.systemDatabase,
+ });
+ systemDatabase =
+ raw.trim() || SERVICE_DEFAULTS.postgresql.systemDatabase;
+ }
+ let maintenanceDatabase = flags?.postgresMaintenanceDb;
+ if (maintenanceDatabase === undefined) {
+ const raw = await askText({
+ message: `Maintenance database (for CREATE DATABASE, default ${SERVICE_DEFAULTS.postgresql.maintenanceDatabase})`,
+ placeholder: SERVICE_DEFAULTS.postgresql.maintenanceDatabase,
+ defaultValue: SERVICE_DEFAULTS.postgresql.maintenanceDatabase,
+ });
+ maintenanceDatabase =
+ raw.trim() || SERVICE_DEFAULTS.postgresql.maintenanceDatabase;
+ }
return {
- host: host.trim() || SERVICE_DEFAULTS.postgresql.host,
- port: Number(port) || SERVICE_DEFAULTS.postgresql.port,
- username: username.trim() || SERVICE_DEFAULTS.postgresql.username,
+ host,
+ port,
+ username,
password,
- systemDatabase:
- systemDatabase.trim() || SERVICE_DEFAULTS.postgresql.systemDatabase,
- maintenanceDatabase:
- maintenanceDatabase.trim() ||
- SERVICE_DEFAULTS.postgresql.maintenanceDatabase,
+ systemDatabase,
+ maintenanceDatabase,
};
}
-async function askNeo4j(): Promise<Neo4jConnection> {
+async function askNeo4j(flags?: InitFlagOverrides): Promise<Neo4jConnection> {
p.log.step("Neo4j");
- const host = await askText({
- message: "Neo4j host",
- placeholder: SERVICE_DEFAULTS.neo4j.host,
- defaultValue: SERVICE_DEFAULTS.neo4j.host,
- });
- const port = await askText({
- message: "Neo4j Bolt port",
- placeholder: String(SERVICE_DEFAULTS.neo4j.port),
- defaultValue: String(SERVICE_DEFAULTS.neo4j.port),
- validate: portValidator,
- });
- const username = await askText({
- message: "Neo4j username",
- placeholder: SERVICE_DEFAULTS.neo4j.username,
- defaultValue: SERVICE_DEFAULTS.neo4j.username,
- });
- const password = await askPassword({
- message: "Neo4j password (default is 'your_password')",
- validate: (value) =>
- value.length === 0 ? "Password is required" : undefined,
- });
- return {
- host: host.trim() || SERVICE_DEFAULTS.neo4j.host,
- port: Number(port) || SERVICE_DEFAULTS.neo4j.port,
- username: username.trim() || SERVICE_DEFAULTS.neo4j.username,
- password,
- };
+ let host = flags?.neo4jHost;
+ if (host === undefined) {
+ const raw = await askText({
+ message: "Neo4j host",
+ placeholder: SERVICE_DEFAULTS.neo4j.host,
+ defaultValue: SERVICE_DEFAULTS.neo4j.host,
+ });
+ host = raw.trim() || SERVICE_DEFAULTS.neo4j.host;
+ }
+ let port = flags?.neo4jPort;
+ if (port === undefined) {
+ const raw = await askText({
+ message: "Neo4j Bolt port",
+ placeholder: String(SERVICE_DEFAULTS.neo4j.port),
+ defaultValue: String(SERVICE_DEFAULTS.neo4j.port),
+ validate: portValidator,
+ });
+ port = Number(raw) || SERVICE_DEFAULTS.neo4j.port;
+ }
+ let username = flags?.neo4jUsername;
+ if (username === undefined) {
+ const raw = await askText({
+ message: "Neo4j username",
+ placeholder: SERVICE_DEFAULTS.neo4j.username,
+ defaultValue: SERVICE_DEFAULTS.neo4j.username,
+ });
+ username = raw.trim() || SERVICE_DEFAULTS.neo4j.username;
+ }
+ let password = flags?.neo4jPassword;
+ if (password === undefined) {
+ password = await askPassword({
+ message: "Neo4j password (default is 'your_password')",
+ validate: (value) =>
+ value.length === 0 ? "Password is required" : undefined,
+ });
+ }
+ return { host, port, username, password };
}
-async function askMilvus(): Promise<MilvusConnection> {
+async function askMilvus(flags?: InitFlagOverrides): Promise<MilvusConnection> {
p.log.step("Milvus");
- const target = await pickOne<"local" | "managed">({
- message: "Milvus deployment",
- options: [
- { value: "local", label: "Local docker compose" },
- { value: "managed", label: "Managed (Zilliz Cloud) — uri + token" },
- ],
- initialValue: "local",
- });
- if (target === "managed") {
- const uri = await askText({
- message: "Milvus URI",
- placeholder: "https://your-cluster.api.gcp-us-west1.zillizcloud.com",
- validate: (value) =>
- value.trim().length === 0 ? "URI is required" : undefined,
- });
- const token = await askPassword({
- message: "Milvus token",
- validate: (value) =>
- value.length === 0 ? "Token is required" : undefined,
+ let target = flags?.milvusDeployment;
+ if (flags?.milvusUri || flags?.milvusToken) {
+ target = "managed";
+ }
+ if (target === undefined) {
+ target = await pickOne<"local" | "managed">({
+ message: "Milvus deployment",
+ options: [
+ { value: "local", label: "Local docker compose" },
+ { value: "managed", label: "Managed (Zilliz Cloud) — uri + token" },
+ ],
+ initialValue: "local",
});
+ }
+
+ if (target === "managed") {
+ let uri = flags?.milvusUri;
+ if (uri === undefined) {
+ uri = (
+ await askText({
+ message: "Milvus URI",
+ placeholder: "https://your-cluster.api.gcp-us-west1.zillizcloud.com",
+ validate: (value) =>
+ value.trim().length === 0 ? "URI is required" : undefined,
+ })
+ ).trim();
+ }
+ let token = flags?.milvusToken;
+ if (token === undefined) {
+ token = await askPassword({
+ message: "Milvus token",
+ validate: (value) =>
+ value.length === 0 ? "Token is required" : undefined,
+ });
+ }
return {
- host: SERVICE_DEFAULTS.milvus.host,
- port: SERVICE_DEFAULTS.milvus.port,
- uri: uri.trim(),
+ host: flags?.milvusHost ?? SERVICE_DEFAULTS.milvus.host,
+ port: flags?.milvusPort ?? SERVICE_DEFAULTS.milvus.port,
+ uri,
token,
};
}
- const host = await askText({
- message: "Milvus host",
- placeholder: SERVICE_DEFAULTS.milvus.host,
- defaultValue: SERVICE_DEFAULTS.milvus.host,
- });
- const port = await askText({
- message: "Milvus port",
- placeholder: String(SERVICE_DEFAULTS.milvus.port),
- defaultValue: String(SERVICE_DEFAULTS.milvus.port),
- validate: portValidator,
- });
- return {
- host: host.trim() || SERVICE_DEFAULTS.milvus.host,
- port: Number(port) || SERVICE_DEFAULTS.milvus.port,
- };
+ let host = flags?.milvusHost;
+ if (host === undefined) {
+ const raw = await askText({
+ message: "Milvus host",
+ placeholder: SERVICE_DEFAULTS.milvus.host,
+ defaultValue: SERVICE_DEFAULTS.milvus.host,
+ });
+ host = raw.trim() || SERVICE_DEFAULTS.milvus.host;
+ }
+ let port = flags?.milvusPort;
+ if (port === undefined) {
+ const raw = await askText({
+ message: "Milvus port",
+ placeholder: String(SERVICE_DEFAULTS.milvus.port),
+ defaultValue: String(SERVICE_DEFAULTS.milvus.port),
+ validate: portValidator,
+ });
+ port = Number(raw) || SERVICE_DEFAULTS.milvus.port;
+ }
+ return { host, port };
}
-async function askMongo(): Promise<MongoConnection> {
+async function askMongo(flags?: InitFlagOverrides): Promise<MongoConnection> {
p.log.step("MongoDB");
- const host = await askText({
- message: "Mongo host",
- placeholder: SERVICE_DEFAULTS.mongo.host,
- defaultValue: SERVICE_DEFAULTS.mongo.host,
- });
- const port = await askText({
- message: "Mongo port",
- placeholder: String(SERVICE_DEFAULTS.mongo.port),
- defaultValue: String(SERVICE_DEFAULTS.mongo.port),
- validate: portValidator,
- });
- const username = await askText({
- message: "Mongo username",
- placeholder: SERVICE_DEFAULTS.mongo.username,
- defaultValue: SERVICE_DEFAULTS.mongo.username,
- });
- const password = await askPassword({
- message: "Mongo password (default is 'password')",
- validate: (value) =>
- value.length === 0 ? "Password is required" : undefined,
- });
- return {
- host: host.trim() || SERVICE_DEFAULTS.mongo.host,
- port: Number(port) || SERVICE_DEFAULTS.mongo.port,
- username: username.trim() || SERVICE_DEFAULTS.mongo.username,
- password,
- };
+ let host = flags?.mongoHost;
+ if (host === undefined) {
+ const raw = await askText({
+ message: "Mongo host",
+ placeholder: SERVICE_DEFAULTS.mongo.host,
+ defaultValue: SERVICE_DEFAULTS.mongo.host,
+ });
+ host = raw.trim() || SERVICE_DEFAULTS.mongo.host;
+ }
+ let port = flags?.mongoPort;
+ if (port === undefined) {
+ const raw = await askText({
+ message: "Mongo port",
+ placeholder: String(SERVICE_DEFAULTS.mongo.port),
+ defaultValue: String(SERVICE_DEFAULTS.mongo.port),
+ validate: portValidator,
+ });
+ port = Number(raw) || SERVICE_DEFAULTS.mongo.port;
+ }
+ let username = flags?.mongoUsername;
+ if (username === undefined) {
+ const raw = await askText({
+ message: "Mongo username",
+ placeholder: SERVICE_DEFAULTS.mongo.username,
+ defaultValue: SERVICE_DEFAULTS.mongo.username,
+ });
+ username = raw.trim() || SERVICE_DEFAULTS.mongo.username;
+ }
+ let password = flags?.mongoPassword;
+ if (password === undefined) {
+ password = await askPassword({
+ message: "Mongo password (default is 'password')",
+ validate: (value) =>
+ value.length === 0 ? "Password is required" : undefined,
+ });
+ }
+ return { host, port, username, password };
}
-export async function askConnections(dbs: DbChoices): Promise<Connections> {
- const redis = await askRedis();
+export async function askConnections(
+ dbs: DbChoices,
+ flags?: InitFlagOverrides,
+): Promise<Connections> {
+ const redis = await askRedis(flags);
const result: Connections = { redis };
const needsPostgres =
@@ -210,16 +281,16 @@ export async function askConnections(dbs: DbChoices): Promise<Connections> {
dbs.dataDb === "postgresql" ||
dbs.graphDb === "networkx";
if (needsPostgres) {
- result.postgresql = await askPostgres();
+ result.postgresql = await askPostgres(flags);
}
if (dbs.graphDb === "neo4j") {
- result.neo4j = await askNeo4j();
+ result.neo4j = await askNeo4j(flags);
}
if (dbs.vectorDb === "milvus") {
- result.milvus = await askMilvus();
+ result.milvus = await askMilvus(flags);
}
if (dbs.dataDb === "mongo") {
- result.mongo = await askMongo();
+ result.mongo = await askMongo(flags);
}
return result;
diff --git a/tui/src/flows/embedding-dimensions.ts b/tui/src/flows/embedding-dimensions.ts
index 11da988..d37cae5 100644
--- a/tui/src/flows/embedding-dimensions.ts
+++ b/tui/src/flows/embedding-dimensions.ts
@@ -53,8 +53,13 @@ export async function askEmbeddingDimensions(
allowBack?: boolean;
backHint?: string;
initial?: EmbeddingDimensions;
+ prechosenSize?: number;
},
): Promise<EmbeddingDimensions | PromptBack> {
+ if (opts?.prechosenSize !== undefined) {
+ return dimensionsFromSize(opts.prechosenSize);
+ }
+
p.log.step("Embedding dimensions");
const known = lookupEmbeddingDimensions(embeddingModel);
const initialSize =
@@ -132,6 +137,7 @@ export async function attachEmbeddingDimensions(
allowBack?: boolean;
backHint?: string;
initial?: EmbeddingDimensions;
+ prechosenSize?: number;
},
): Promise<ModelsChoices | PromptBack> {
const embeddingModel = resolveActiveEmbeddingModel(models);
diff --git a/tui/src/flows/models.ts b/tui/src/flows/models.ts
index 5867586..4db2259 100644
--- a/tui/src/flows/models.ts
+++ b/tui/src/flows/models.ts
@@ -23,6 +23,7 @@ import {
OPENAI_DEFAULT_LARGE_MODEL,
OPENAI_DEFAULT_SMALL_MODEL,
} from "../constants.js";
+import type { InitFlagOverrides } from "../lib/init-flags.js";
import {
askPassword,
askText,
@@ -75,10 +76,21 @@ async function inspectGcpCredentials(filePath: string): Promise<GcpCredentialsCh
}
}
-async function askGcp(opts: {
- needLlm: boolean;
- needEmbeddings: boolean;
-}): Promise<GcpChoices> {
+function pickModel(
+ providerSpecific: string | undefined,
+ generic: string | undefined,
+ fallback: string,
+): string {
+ return providerSpecific ?? generic ?? fallback;
+}
+
+async function askGcp(
+ opts: {
+ needLlm: boolean;
+ needEmbeddings: boolean;
+ },
+ flags?: InitFlagOverrides,
+): Promise<GcpChoices> {
p.log.step(
opts.needLlm && opts.needEmbeddings
? "Configure GCP Vertex"
@@ -87,24 +99,36 @@ async function askGcp(opts: {
: "Configure GCP Vertex LLMs",
);
- let credentialsPath = "";
+ let credentialsPath = flags?.gcpCredentials
+ ? expandHome(flags.gcpCredentials)
+ : "";
let projectIdFromFile: string | undefined;
- while (true) {
- const raw = await askText({
- message: "Path to GCP service-account credentials JSON",
- placeholder: "~/.config/gcloud/brainapi.json",
- });
- const result = await inspectGcpCredentials(raw);
- if (!result.error) {
- credentialsPath = expandHome(raw.trim());
- projectIdFromFile = result.projectId;
- break;
+ if (credentialsPath) {
+ const result = await inspectGcpCredentials(credentialsPath);
+ if (result.error) {
+ throw new Error(`--gcp-credentials: ${result.error}`);
+ }
+ projectIdFromFile = result.projectId;
+ } else {
+ while (true) {
+ const raw = await askText({
+ message: "Path to GCP service-account credentials JSON",
+ placeholder: "~/.config/gcloud/brainapi.json",
+ });
+ const result = await inspectGcpCredentials(raw);
+ if (!result.error) {
+ credentialsPath = expandHome(raw.trim());
+ projectIdFromFile = result.projectId;
+ break;
+ }
+ p.log.error(result.error);
}
- p.log.error(result.error);
}
let projectId: string;
- if (projectIdFromFile) {
+ if (flags?.gcpProject) {
+ projectId = flags.gcpProject;
+ } else if (projectIdFromFile) {
projectId = projectIdFromFile;
p.log.info(`Using GCP project ${pc.cyan(projectId)} (from credentials file)`);
} else {
@@ -119,25 +143,37 @@ async function askGcp(opts: {
projectId = entered.trim();
}
- let smallLlmModel = GCP_DEFAULT_SMALL_MODEL;
- let largeLlmModel = GCP_DEFAULT_LARGE_MODEL;
+ let smallLlmModel = pickModel(flags?.gcpSmall, flags?.llmSmall, GCP_DEFAULT_SMALL_MODEL);
+ let largeLlmModel = pickModel(flags?.gcpLarge, flags?.llmLarge, GCP_DEFAULT_LARGE_MODEL);
if (opts.needLlm) {
- const smallModel = await askText({
- message: "GCP small LLM model",
- placeholder: GCP_DEFAULT_SMALL_MODEL,
- defaultValue: GCP_DEFAULT_SMALL_MODEL,
- });
- const largeModel = await askText({
- message: "GCP large LLM model",
- placeholder: GCP_DEFAULT_LARGE_MODEL,
- defaultValue: GCP_DEFAULT_LARGE_MODEL,
- });
- smallLlmModel = smallModel.trim() || GCP_DEFAULT_SMALL_MODEL;
- largeLlmModel = largeModel.trim() || GCP_DEFAULT_LARGE_MODEL;
+ if (flags?.gcpSmall === undefined && flags?.llmSmall === undefined) {
+ const smallModel = await askText({
+ message: "GCP small LLM model",
+ placeholder: GCP_DEFAULT_SMALL_MODEL,
+ defaultValue: GCP_DEFAULT_SMALL_MODEL,
+ });
+ smallLlmModel = smallModel.trim() || GCP_DEFAULT_SMALL_MODEL;
+ }
+ if (flags?.gcpLarge === undefined && flags?.llmLarge === undefined) {
+ const largeModel = await askText({
+ message: "GCP large LLM model",
+ placeholder: GCP_DEFAULT_LARGE_MODEL,
+ defaultValue: GCP_DEFAULT_LARGE_MODEL,
+ });
+ largeLlmModel = largeModel.trim() || GCP_DEFAULT_LARGE_MODEL;
+ }
}
- let embeddingModel = GCP_DEFAULT_EMBEDDING_MODEL;
- if (opts.needEmbeddings) {
+ let embeddingModel = pickModel(
+ flags?.gcpEmbedding,
+ flags?.embeddingModel,
+ GCP_DEFAULT_EMBEDDING_MODEL,
+ );
+ if (
+ opts.needEmbeddings &&
+ flags?.gcpEmbedding === undefined &&
+ flags?.embeddingModel === undefined
+ ) {
const embedding = await askText({
message: "GCP embedding model",
placeholder: GCP_DEFAULT_EMBEDDING_MODEL,
@@ -155,10 +191,13 @@ async function askGcp(opts: {
};
}
-async function askAzure(opts: {
- needLlm: boolean;
- needEmbeddings: boolean;
-}): Promise<AzureChoices> {
+async function askAzure(
+ opts: {
+ needLlm: boolean;
+ needEmbeddings: boolean;
+ },
+ flags?: InitFlagOverrides,
+): Promise<AzureChoices> {
p.log.step(
opts.needLlm && opts.needEmbeddings
? "Configure Azure OpenAI"
@@ -167,80 +206,101 @@ async function askAzure(opts: {
: "Configure Azure OpenAI LLMs",
);
- let llmEndpoint = "";
- let llmApiVersion = AZURE_DEFAULT_LARGE_API_VERSION;
- let llmSubscriptionKey = "";
- let smallLlmModel = AZURE_DEFAULT_SMALL_MODEL;
- let largeLlmModel = AZURE_DEFAULT_LARGE_MODEL;
+ let llmEndpoint = flags?.azureEndpoint ?? "";
+ let llmApiVersion = flags?.azureApiVersion ?? AZURE_DEFAULT_LARGE_API_VERSION;
+ let llmSubscriptionKey = flags?.azureKey ?? "";
+ let smallLlmModel = pickModel(flags?.azureSmall, flags?.llmSmall, AZURE_DEFAULT_SMALL_MODEL);
+ let largeLlmModel = pickModel(flags?.azureLarge, flags?.llmLarge, AZURE_DEFAULT_LARGE_MODEL);
if (opts.needLlm) {
- llmEndpoint = (
- await askText({
- message: "Azure LLM endpoint",
- placeholder: "https://yourproject.openai.azure.com",
- validate: (value) =>
- value.trim().length === 0 ? "Endpoint is required" : undefined,
- })
- ).trim();
- llmApiVersion = (
- await askText({
- message: "Azure LLM API version",
- placeholder: AZURE_DEFAULT_LARGE_API_VERSION,
- defaultValue: AZURE_DEFAULT_LARGE_API_VERSION,
- })
- ).trim() || AZURE_DEFAULT_LARGE_API_VERSION;
- llmSubscriptionKey = (
- await askPassword({
- message: "Azure LLM subscription key",
- validate: (value) =>
- value.trim().length === 0 ? "API key is required" : undefined,
- })
- ).trim();
- smallLlmModel =
- (
+ if (flags?.azureEndpoint === undefined) {
+ llmEndpoint = (
await askText({
- message: "Azure small LLM deployment/model",
- placeholder: AZURE_DEFAULT_SMALL_MODEL,
- defaultValue: AZURE_DEFAULT_SMALL_MODEL,
+ message: "Azure LLM endpoint",
+ placeholder: "https://yourproject.openai.azure.com",
+ validate: (value) =>
+ value.trim().length === 0 ? "Endpoint is required" : undefined,
})
- ).trim() || AZURE_DEFAULT_SMALL_MODEL;
- largeLlmModel =
- (
- await askText({
- message: "Azure large LLM deployment/model",
- placeholder: AZURE_DEFAULT_LARGE_MODEL,
- defaultValue: AZURE_DEFAULT_LARGE_MODEL,
+ ).trim();
+ }
+ if (flags?.azureApiVersion === undefined) {
+ llmApiVersion =
+ (
+ await askText({
+ message: "Azure LLM API version",
+ placeholder: AZURE_DEFAULT_LARGE_API_VERSION,
+ defaultValue: AZURE_DEFAULT_LARGE_API_VERSION,
+ })
+ ).trim() || AZURE_DEFAULT_LARGE_API_VERSION;
+ }
+ if (flags?.azureKey === undefined) {
+ llmSubscriptionKey = (
+ await askPassword({
+ message: "Azure LLM subscription key",
+ validate: (value) =>
+ value.trim().length === 0 ? "API key is required" : undefined,
})
- ).trim() || AZURE_DEFAULT_LARGE_MODEL;
+ ).trim();
+ }
+ if (flags?.azureSmall === undefined && flags?.llmSmall === undefined) {
+ smallLlmModel =
+ (
+ await askText({
+ message: "Azure small LLM deployment/model",
+ placeholder: AZURE_DEFAULT_SMALL_MODEL,
+ defaultValue: AZURE_DEFAULT_SMALL_MODEL,
+ })
+ ).trim() || AZURE_DEFAULT_SMALL_MODEL;
+ }
+ if (flags?.azureLarge === undefined && flags?.llmLarge === undefined) {
+ largeLlmModel =
+ (
+ await askText({
+ message: "Azure large LLM deployment/model",
+ placeholder: AZURE_DEFAULT_LARGE_MODEL,
+ defaultValue: AZURE_DEFAULT_LARGE_MODEL,
+ })
+ ).trim() || AZURE_DEFAULT_LARGE_MODEL;
+ }
}
- let embeddingEndpoint = "";
- let embeddingKey = "";
- let embeddingModel = AZURE_DEFAULT_EMBEDDING_MODEL;
+ let embeddingEndpoint = flags?.azureEmbeddingEndpoint ?? "";
+ let embeddingKey = flags?.azureEmbeddingKey ?? "";
+ let embeddingModel = pickModel(
+ flags?.azureEmbedding,
+ flags?.embeddingModel,
+ AZURE_DEFAULT_EMBEDDING_MODEL,
+ );
if (opts.needEmbeddings) {
- embeddingEndpoint = (
- await askText({
- message: "Azure embeddings endpoint URL",
- placeholder:
- "https://yourproject.openai.azure.com/openai/deployments/text-embedding-3-large/embeddings?api-version=2023-05-15",
- validate: (value) =>
- value.trim().length === 0 ? "Endpoint URL is required" : undefined,
- })
- ).trim();
- embeddingKey = (
- await askPassword({
- message: "Azure embeddings API key",
- validate: (value) =>
- value.trim().length === 0 ? "API key is required" : undefined,
- })
- ).trim();
- embeddingModel =
- (
+ if (flags?.azureEmbeddingEndpoint === undefined) {
+ embeddingEndpoint = (
await askText({
- message: "Azure embedding model/deployment",
- placeholder: AZURE_DEFAULT_EMBEDDING_MODEL,
- defaultValue: AZURE_DEFAULT_EMBEDDING_MODEL,
+ message: "Azure embeddings endpoint URL",
+ placeholder:
+ "https://yourproject.openai.azure.com/openai/deployments/text-embedding-3-large/embeddings?api-version=2023-05-15",
+ validate: (value) =>
+ value.trim().length === 0 ? "Endpoint URL is required" : undefined,
+ })
+ ).trim();
+ }
+ if (flags?.azureEmbeddingKey === undefined) {
+ embeddingKey = (
+ await askPassword({
+ message: "Azure embeddings API key",
+ validate: (value) =>
+ value.trim().length === 0 ? "API key is required" : undefined,
})
- ).trim() || AZURE_DEFAULT_EMBEDDING_MODEL;
+ ).trim();
+ }
+ if (flags?.azureEmbedding === undefined && flags?.embeddingModel === undefined) {
+ embeddingModel =
+ (
+ await askText({
+ message: "Azure embedding model/deployment",
+ placeholder: AZURE_DEFAULT_EMBEDDING_MODEL,
+ defaultValue: AZURE_DEFAULT_EMBEDDING_MODEL,
+ })
+ ).trim() || AZURE_DEFAULT_EMBEDDING_MODEL;
+ }
}
return {
@@ -255,10 +315,13 @@ async function askAzure(opts: {
};
}
-async function askBedrock(opts: {
- needLlm: boolean;
- needEmbeddings: boolean;
-}): Promise<BedrockChoices> {
+async function askBedrock(
+ opts: {
+ needLlm: boolean;
+ needEmbeddings: boolean;
+ },
+ flags?: InitFlagOverrides,
+): Promise<BedrockChoices> {
p.log.step(
opts.needLlm && opts.needEmbeddings
? "Configure Amazon Bedrock"
@@ -266,49 +329,91 @@ async function askBedrock(opts: {
? "Configure Amazon Bedrock embeddings"
: "Configure Amazon Bedrock LLMs",
);
- const region = await askText({
- message: "AWS region",
- placeholder: BEDROCK_DEFAULT_REGION,
- defaultValue: BEDROCK_DEFAULT_REGION,
- });
- const accessKeyId = await askText({
- message: "AWS access key id",
- validate: (value) =>
- value.trim().length === 0 ? "Access key id is required" : undefined,
- });
- const secretAccessKey = await askPassword({
- message: "AWS secret access key",
- validate: (value) =>
- value.trim().length === 0 ? "Secret access key is required" : undefined,
- });
- const sessionToken = await askPassword({
- message: "AWS session token (optional)",
- validate: () => undefined,
- });
- let smallLlmModel = BEDROCK_DEFAULT_SMALL_MODEL;
- let largeLlmModel = BEDROCK_DEFAULT_LARGE_MODEL;
+ let region = flags?.awsRegion ?? BEDROCK_DEFAULT_REGION;
+ if (flags?.awsRegion === undefined) {
+ const raw = await askText({
+ message: "AWS region",
+ placeholder: BEDROCK_DEFAULT_REGION,
+ defaultValue: BEDROCK_DEFAULT_REGION,
+ });
+ region = raw.trim() || BEDROCK_DEFAULT_REGION;
+ }
+
+ let accessKeyId = flags?.awsAccessKeyId ?? "";
+ if (flags?.awsAccessKeyId === undefined) {
+ accessKeyId = (
+ await askText({
+ message: "AWS access key id",
+ validate: (value) =>
+ value.trim().length === 0 ? "Access key id is required" : undefined,
+ })
+ ).trim();
+ }
+
+ let secretAccessKey = flags?.awsSecretAccessKey ?? "";
+ if (flags?.awsSecretAccessKey === undefined) {
+ secretAccessKey = (
+ await askPassword({
+ message: "AWS secret access key",
+ validate: (value) =>
+ value.trim().length === 0 ? "Secret access key is required" : undefined,
+ })
+ ).trim();
+ }
+
+ let sessionToken = flags?.awsSessionToken;
+ if (flags?.awsSessionToken === undefined) {
+ const raw = await askPassword({
+ message: "AWS session token (optional)",
+ validate: () => undefined,
+ });
+ sessionToken = raw.trim() || undefined;
+ }
+
+ let smallLlmModel = pickModel(
+ flags?.bedrockSmall,
+ flags?.llmSmall,
+ BEDROCK_DEFAULT_SMALL_MODEL,
+ );
+ let largeLlmModel = pickModel(
+ flags?.bedrockLarge,
+ flags?.llmLarge,
+ BEDROCK_DEFAULT_LARGE_MODEL,
+ );
if (opts.needLlm) {
- smallLlmModel =
- (
- await askText({
- message: "Bedrock small LLM model id",
- placeholder: BEDROCK_DEFAULT_SMALL_MODEL,
- defaultValue: BEDROCK_DEFAULT_SMALL_MODEL,
- })
- ).trim() || BEDROCK_DEFAULT_SMALL_MODEL;
- largeLlmModel =
- (
- await askText({
- message: "Bedrock large LLM model id",
- placeholder: BEDROCK_DEFAULT_LARGE_MODEL,
- defaultValue: BEDROCK_DEFAULT_LARGE_MODEL,
- })
- ).trim() || BEDROCK_DEFAULT_LARGE_MODEL;
+ if (flags?.bedrockSmall === undefined && flags?.llmSmall === undefined) {
+ smallLlmModel =
+ (
+ await askText({
+ message: "Bedrock small LLM model id",
+ placeholder: BEDROCK_DEFAULT_SMALL_MODEL,
+ defaultValue: BEDROCK_DEFAULT_SMALL_MODEL,
+ })
+ ).trim() || BEDROCK_DEFAULT_SMALL_MODEL;
+ }
+ if (flags?.bedrockLarge === undefined && flags?.llmLarge === undefined) {
+ largeLlmModel =
+ (
+ await askText({
+ message: "Bedrock large LLM model id",
+ placeholder: BEDROCK_DEFAULT_LARGE_MODEL,
+ defaultValue: BEDROCK_DEFAULT_LARGE_MODEL,
+ })
+ ).trim() || BEDROCK_DEFAULT_LARGE_MODEL;
+ }
}
- let embeddingModel = BEDROCK_DEFAULT_EMBEDDING_MODEL;
- if (opts.needEmbeddings) {
+ let embeddingModel = pickModel(
+ flags?.bedrockEmbedding,
+ flags?.embeddingModel,
+ BEDROCK_DEFAULT_EMBEDDING_MODEL,
+ );
+ if (
+ opts.needEmbeddings &&
+ flags?.bedrockEmbedding === undefined &&
+ flags?.embeddingModel === undefined
+ ) {
embeddingModel =
(
await askText({
@@ -320,20 +425,23 @@ async function askBedrock(opts: {
}
return {
- region: region.trim() || BEDROCK_DEFAULT_REGION,
- accessKeyId: accessKeyId.trim(),
- secretAccessKey: secretAccessKey.trim(),
- sessionToken: sessionToken.trim() || undefined,
+ region,
+ accessKeyId,
+ secretAccessKey,
+ sessionToken,
smallLlmModel,
largeLlmModel,
embeddingModel,
};
}
-async function askOpenAI(opts: {
- needLlm: boolean;
- needEmbeddings: boolean;
-}): Promise<OpenAIChoices> {
+async function askOpenAI(
+ opts: {
+ needLlm: boolean;
+ needEmbeddings: boolean;
+ },
+ flags?: InitFlagOverrides,
+): Promise<OpenAIChoices> {
p.log.step(
opts.needLlm && opts.needEmbeddings
? "Configure OpenAI"
@@ -342,36 +450,66 @@ async function askOpenAI(opts: {
: "Configure OpenAI LLMs",
);
- const apiKey = await askPassword({
- message: "OpenAI API key",
- validate: (value) =>
- value.trim().length === 0 ? "API key is required" : undefined,
- });
- const baseUrl = await askText({
- message: "OpenAI base URL (optional)",
- placeholder: "https://api.openai.com/v1",
- defaultValue: "",
- });
+ let apiKey = flags?.openaiApiKey ?? "";
+ if (flags?.openaiApiKey === undefined) {
+ apiKey = (
+ await askPassword({
+ message: "OpenAI API key",
+ validate: (value) =>
+ value.trim().length === 0 ? "API key is required" : undefined,
+ })
+ ).trim();
+ }
- let smallLlmModel = OPENAI_DEFAULT_SMALL_MODEL;
- let largeLlmModel = OPENAI_DEFAULT_LARGE_MODEL;
- if (opts.needLlm) {
- const small = await askText({
- message: "OpenAI small LLM model",
- placeholder: OPENAI_DEFAULT_SMALL_MODEL,
- defaultValue: OPENAI_DEFAULT_SMALL_MODEL,
- });
- const large = await askText({
- message: "OpenAI large LLM model",
- placeholder: OPENAI_DEFAULT_LARGE_MODEL,
- defaultValue: OPENAI_DEFAULT_LARGE_MODEL,
+ let baseUrl = flags?.openaiBaseUrl;
+ if (flags?.openaiBaseUrl === undefined) {
+ const raw = await askText({
+ message: "OpenAI base URL (optional)",
+ placeholder: "https://api.openai.com/v1",
+ defaultValue: "",
});
- smallLlmModel = small.trim() || OPENAI_DEFAULT_SMALL_MODEL;
- largeLlmModel = large.trim() || OPENAI_DEFAULT_LARGE_MODEL;
+ baseUrl = raw.trim() || undefined;
}
- let embeddingModel = OPENAI_DEFAULT_EMBEDDING_MODEL;
- if (opts.needEmbeddings) {
+ let smallLlmModel = pickModel(
+ flags?.openaiSmall,
+ flags?.llmSmall,
+ OPENAI_DEFAULT_SMALL_MODEL,
+ );
+ let largeLlmModel = pickModel(
+ flags?.openaiLarge,
+ flags?.llmLarge,
+ OPENAI_DEFAULT_LARGE_MODEL,
+ );
+ if (opts.needLlm) {
+ if (flags?.openaiSmall === undefined && flags?.llmSmall === undefined) {
+ const small = await askText({
+ message: "OpenAI small LLM model",
+ placeholder: OPENAI_DEFAULT_SMALL_MODEL,
+ defaultValue: OPENAI_DEFAULT_SMALL_MODEL,
+ });
+ smallLlmModel = small.trim() || OPENAI_DEFAULT_SMALL_MODEL;
+ }
+ if (flags?.openaiLarge === undefined && flags?.llmLarge === undefined) {
+ const large = await askText({
+ message: "OpenAI large LLM model",
+ placeholder: OPENAI_DEFAULT_LARGE_MODEL,
+ defaultValue: OPENAI_DEFAULT_LARGE_MODEL,
+ });
+ largeLlmModel = large.trim() || OPENAI_DEFAULT_LARGE_MODEL;
+ }
+ }
+
+ let embeddingModel = pickModel(
+ flags?.openaiEmbedding,
+ flags?.embeddingModel,
+ OPENAI_DEFAULT_EMBEDDING_MODEL,
+ );
+ if (
+ opts.needEmbeddings &&
+ flags?.openaiEmbedding === undefined &&
+ flags?.embeddingModel === undefined
+ ) {
const embedding = await askText({
message: "OpenAI embedding model",
placeholder: OPENAI_DEFAULT_EMBEDDING_MODEL,
@@ -381,63 +519,100 @@ async function askOpenAI(opts: {
}
return {
- apiKey: apiKey.trim(),
- baseUrl: baseUrl.trim() || undefined,
+ apiKey,
+ baseUrl,
smallLlmModel,
largeLlmModel,
embeddingModel,
};
}
-async function askAnthropic(): Promise<AnthropicChoices> {
+async function askAnthropic(flags?: InitFlagOverrides): Promise<AnthropicChoices> {
p.log.step("Configure Anthropic");
- const apiKey = await askPassword({
- message: "Anthropic API key",
- validate: (value) =>
- value.trim().length === 0 ? "API key is required" : undefined,
- });
- const smallLlmModel = await askText({
- message: "Anthropic small LLM model",
- placeholder: ANTHROPIC_DEFAULT_SMALL_MODEL,
- defaultValue: ANTHROPIC_DEFAULT_SMALL_MODEL,
- });
- const largeLlmModel = await askText({
- message: "Anthropic large LLM model",
- placeholder: ANTHROPIC_DEFAULT_LARGE_MODEL,
- defaultValue: ANTHROPIC_DEFAULT_LARGE_MODEL,
- });
- return {
- apiKey: apiKey.trim(),
- smallLlmModel: smallLlmModel.trim() || ANTHROPIC_DEFAULT_SMALL_MODEL,
- largeLlmModel: largeLlmModel.trim() || ANTHROPIC_DEFAULT_LARGE_MODEL,
- };
+ let apiKey = flags?.anthropicApiKey ?? "";
+ if (flags?.anthropicApiKey === undefined) {
+ apiKey = (
+ await askPassword({
+ message: "Anthropic API key",
+ validate: (value) =>
+ value.trim().length === 0 ? "API key is required" : undefined,
+ })
+ ).trim();
+ }
+ let smallLlmModel = pickModel(
+ flags?.anthropicSmall,
+ flags?.llmSmall,
+ ANTHROPIC_DEFAULT_SMALL_MODEL,
+ );
+ let largeLlmModel = pickModel(
+ flags?.anthropicLarge,
+ flags?.llmLarge,
+ ANTHROPIC_DEFAULT_LARGE_MODEL,
+ );
+ if (flags?.anthropicSmall === undefined && flags?.llmSmall === undefined) {
+ const raw = await askText({
+ message: "Anthropic small LLM model",
+ placeholder: ANTHROPIC_DEFAULT_SMALL_MODEL,
+ defaultValue: ANTHROPIC_DEFAULT_SMALL_MODEL,
+ });
+ smallLlmModel = raw.trim() || ANTHROPIC_DEFAULT_SMALL_MODEL;
+ }
+ if (flags?.anthropicLarge === undefined && flags?.llmLarge === undefined) {
+ const raw = await askText({
+ message: "Anthropic large LLM model",
+ placeholder: ANTHROPIC_DEFAULT_LARGE_MODEL,
+ defaultValue: ANTHROPIC_DEFAULT_LARGE_MODEL,
+ });
+ largeLlmModel = raw.trim() || ANTHROPIC_DEFAULT_LARGE_MODEL;
+ }
+ return { apiKey, smallLlmModel, largeLlmModel };
}
-async function askDeepSeek(): Promise<DeepSeekChoices> {
+async function askDeepSeek(flags?: InitFlagOverrides): Promise<DeepSeekChoices> {
p.log.step("Configure DeepSeek");
- const apiKey = await askPassword({
- message: "DeepSeek API key",
- validate: (value) =>
- value.trim().length === 0 ? "API key is required" : undefined,
- });
- const smallLlmModel = await askText({
- message: "DeepSeek small LLM model",
- placeholder: DEEPSEEK_DEFAULT_SMALL_MODEL,
- defaultValue: DEEPSEEK_DEFAULT_SMALL_MODEL,
- });
- const largeLlmModel = await askText({
- message: "DeepSeek large LLM model",
- placeholder: DEEPSEEK_DEFAULT_LARGE_MODEL,
- defaultValue: DEEPSEEK_DEFAULT_LARGE_MODEL,
- });
- return {
- apiKey: apiKey.trim(),
- smallLlmModel: smallLlmModel.trim() || DEEPSEEK_DEFAULT_SMALL_MODEL,
- largeLlmModel: largeLlmModel.trim() || DEEPSEEK_DEFAULT_LARGE_MODEL,
- };
+ let apiKey = flags?.deepseekApiKey ?? "";
+ if (flags?.deepseekApiKey === undefined) {
+ apiKey = (
+ await askPassword({
+ message: "DeepSeek API key",
+ validate: (value) =>
+ value.trim().length === 0 ? "API key is required" : undefined,
+ })
+ ).trim();
+ }
+ let smallLlmModel = pickModel(
+ flags?.deepseekSmall,
+ flags?.llmSmall,
+ DEEPSEEK_DEFAULT_SMALL_MODEL,
+ );
+ let largeLlmModel = pickModel(
+ flags?.deepseekLarge,
+ flags?.llmLarge,
+ DEEPSEEK_DEFAULT_LARGE_MODEL,
+ );
+ if (flags?.deepseekSmall === undefined && flags?.llmSmall === undefined) {
+ const raw = await askText({
+ message: "DeepSeek small LLM model",
+ placeholder: DEEPSEEK_DEFAULT_SMALL_MODEL,
+ defaultValue: DEEPSEEK_DEFAULT_SMALL_MODEL,
+ });
+ smallLlmModel = raw.trim() || DEEPSEEK_DEFAULT_SMALL_MODEL;
+ }
+ if (flags?.deepseekLarge === undefined && flags?.llmLarge === undefined) {
+ const raw = await askText({
+ message: "DeepSeek large LLM model",
+ placeholder: DEEPSEEK_DEFAULT_LARGE_MODEL,
+ defaultValue: DEEPSEEK_DEFAULT_LARGE_MODEL,
+ });
+ largeLlmModel = raw.trim() || DEEPSEEK_DEFAULT_LARGE_MODEL;
+ }
+ return { apiKey, smallLlmModel, largeLlmModel };
}
-async function askLlmProvider(message: string, initialValue: ModelProvider): Promise<ModelProvider> {
+async function askLlmProvider(
+ message: string,
+ initialValue: ModelProvider,
+): Promise<ModelProvider> {
return pickOne<ModelProvider>({
message,
options: [
@@ -474,20 +649,24 @@ export async function askModels(options?: {
prechosenMode?: ModelsMode;
allowBack?: false;
initialMode?: ModelsMode;
+ flags?: InitFlagOverrides;
}): Promise<ModelsChoices>;
export async function askModels(options: {
prechosenMode?: ModelsMode;
allowBack: true;
backHint?: string;
initialMode?: ModelsMode;
+ flags?: InitFlagOverrides;
}): Promise<ModelsChoices | PromptBack>;
export async function askModels(options?: {
prechosenMode?: ModelsMode;
allowBack?: boolean;
backHint?: string;
initialMode?: ModelsMode;
+ flags?: InitFlagOverrides;
}): Promise<ModelsChoices | PromptBack> {
- let mode = options?.prechosenMode;
+ const flags = options?.flags;
+ let mode = options?.prechosenMode ?? flags?.modelsMode;
if (!mode) {
const picked = options?.allowBack
? await pickOne<ModelsMode>({
@@ -515,7 +694,7 @@ export async function askModels(options?: {
}
if (mode === "local") {
- const ollama = await askOllama();
+ const ollama = await askOllama(flags);
return attachEmbeddingDimensions(
{
mode,
@@ -527,13 +706,20 @@ export async function askModels(options?: {
{
allowBack: options?.allowBack,
backHint: options?.backHint,
+ prechosenSize: flags?.embeddingDimensions,
},
);
}
- const llmSmallProvider = await askLlmProvider("Small LLM provider", "gcp_vertex");
- const llmLargeProvider = await askLlmProvider("Large LLM provider", "azure");
- const embeddingsProvider = await askEmbeddingsProvider("Embeddings provider", "azure");
+ const llmSmallProvider =
+ flags?.llmSmallProvider ??
+ (await askLlmProvider("Small LLM provider", "gcp_vertex"));
+ const llmLargeProvider =
+ flags?.llmLargeProvider ??
+ (await askLlmProvider("Large LLM provider", "azure"));
+ const embeddingsProvider =
+ flags?.embeddingsProvider ??
+ (await askEmbeddingsProvider("Embeddings provider", "azure"));
const providers = new Set([llmSmallProvider, llmLargeProvider, embeddingsProvider]);
@@ -546,40 +732,52 @@ export async function askModels(options?: {
let bedrock = undefined;
if (providers.has("ollama")) {
- ollama = await askOllama();
+ ollama = await askOllama(flags);
}
if (providers.has("gcp_vertex")) {
- gcp = await askGcp({
- needLlm:
- llmSmallProvider === "gcp_vertex" || llmLargeProvider === "gcp_vertex",
- needEmbeddings: embeddingsProvider === "gcp_vertex",
- });
+ gcp = await askGcp(
+ {
+ needLlm:
+ llmSmallProvider === "gcp_vertex" || llmLargeProvider === "gcp_vertex",
+ needEmbeddings: embeddingsProvider === "gcp_vertex",
+ },
+ flags,
+ );
}
if (providers.has("azure")) {
- azure = await askAzure({
- needLlm: llmSmallProvider === "azure" || llmLargeProvider === "azure",
- needEmbeddings: embeddingsProvider === "azure",
- });
+ azure = await askAzure(
+ {
+ needLlm: llmSmallProvider === "azure" || llmLargeProvider === "azure",
+ needEmbeddings: embeddingsProvider === "azure",
+ },
+ flags,
+ );
}
if (providers.has("openai")) {
- openai = await askOpenAI({
- needLlm: llmSmallProvider === "openai" || llmLargeProvider === "openai",
- needEmbeddings: embeddingsProvider === "openai",
- });
+ openai = await askOpenAI(
+ {
+ needLlm: llmSmallProvider === "openai" || llmLargeProvider === "openai",
+ needEmbeddings: embeddingsProvider === "openai",
+ },
+ flags,
+ );
}
if (providers.has("anthropic")) {
- anthropic = await askAnthropic();
+ anthropic = await askAnthropic(flags);
}
if (providers.has("deepseek")) {
- deepseek = await askDeepSeek();
+ deepseek = await askDeepSeek(flags);
}
if (providers.has("amazon_bedrock")) {
- bedrock = await askBedrock({
- needLlm:
- llmSmallProvider === "amazon_bedrock" ||
- llmLargeProvider === "amazon_bedrock",
- needEmbeddings: embeddingsProvider === "amazon_bedrock",
- });
+ bedrock = await askBedrock(
+ {
+ needLlm:
+ llmSmallProvider === "amazon_bedrock" ||
+ llmLargeProvider === "amazon_bedrock",
+ needEmbeddings: embeddingsProvider === "amazon_bedrock",
+ },
+ flags,
+ );
}
return attachEmbeddingDimensions(
@@ -599,6 +797,7 @@ export async function askModels(options?: {
{
allowBack: options?.allowBack,
backHint: options?.backHint,
+ prechosenSize: flags?.embeddingDimensions,
},
);
}
diff --git a/tui/src/flows/ollama.ts b/tui/src/flows/ollama.ts
index 2019ca9..e4a07f2 100644
--- a/tui/src/flows/ollama.ts
+++ b/tui/src/flows/ollama.ts
@@ -8,6 +8,7 @@ import {
OLLAMA_DEFAULT_SMALL_MODEL,
EMBEDDINGS_DEFAULTS,
} from "../constants.js";
+import type { InitFlagOverrides } from "../lib/init-flags.js";
import {
hasOllamaModel,
isOllamaRunning,
@@ -106,54 +107,80 @@ async function askEmbeddingsLocal(defaultModel: string): Promise<string> {
return raw.trim() || defaultModel;
}
-export async function askOllama(): Promise<OllamaChoices> {
+export async function askOllama(
+ flags?: InitFlagOverrides,
+): Promise<OllamaChoices> {
p.log.step("Configure Ollama");
- const hostRaw = await askText({
- message: "Ollama host",
- placeholder: OLLAMA_DEFAULT_HOST,
- defaultValue: OLLAMA_DEFAULT_HOST,
- });
- const portRaw = await askText({
- message: "Ollama port",
- placeholder: String(OLLAMA_DEFAULT_PORT),
- defaultValue: String(OLLAMA_DEFAULT_PORT),
- validate: (value) => {
- const n = Number(value);
- if (!Number.isInteger(n) || n <= 0 || n > 65535) return "Port must be 1-65535";
- return undefined;
- },
- });
- const target: OllamaTarget = {
- host: hostRaw.trim() || OLLAMA_DEFAULT_HOST,
- port: Number(portRaw) || OLLAMA_DEFAULT_PORT,
- };
+ let host = flags?.ollamaHost;
+ if (host === undefined) {
+ const hostRaw = await askText({
+ message: "Ollama host",
+ placeholder: OLLAMA_DEFAULT_HOST,
+ defaultValue: OLLAMA_DEFAULT_HOST,
+ });
+ host = hostRaw.trim() || OLLAMA_DEFAULT_HOST;
+ }
+
+ let port = flags?.ollamaPort;
+ if (port === undefined) {
+ const portRaw = await askText({
+ message: "Ollama port",
+ placeholder: String(OLLAMA_DEFAULT_PORT),
+ defaultValue: String(OLLAMA_DEFAULT_PORT),
+ validate: (value) => {
+ const n = Number(value);
+ if (!Number.isInteger(n) || n <= 0 || n > 65535) return "Port must be 1-65535";
+ return undefined;
+ },
+ });
+ port = Number(portRaw) || OLLAMA_DEFAULT_PORT;
+ }
+
+ const target: OllamaTarget = { host, port };
await waitForRunning(target);
- const smallModelRaw = await askText({
- message: "Small LLM model name (Ollama tag)",
- placeholder: OLLAMA_DEFAULT_SMALL_MODEL,
- defaultValue: OLLAMA_DEFAULT_SMALL_MODEL,
- });
- const smallModel = await waitForModel(
- target,
- smallModelRaw.trim() || OLLAMA_DEFAULT_SMALL_MODEL,
- "small",
- );
-
- const largeModelRaw = await askText({
- message: "Large LLM model name (Ollama tag)",
- placeholder: OLLAMA_DEFAULT_LARGE_MODEL,
- defaultValue: OLLAMA_DEFAULT_LARGE_MODEL,
- });
- const largeModel = await waitForModel(
- target,
- largeModelRaw.trim() || OLLAMA_DEFAULT_LARGE_MODEL,
- "large",
- );
+ let smallModel =
+ flags?.ollamaSmall ?? flags?.llmSmall ?? OLLAMA_DEFAULT_SMALL_MODEL;
+ if (
+ flags?.ollamaSmall === undefined &&
+ flags?.llmSmall === undefined
+ ) {
+ const smallModelRaw = await askText({
+ message: "Small LLM model name (Ollama tag)",
+ placeholder: OLLAMA_DEFAULT_SMALL_MODEL,
+ defaultValue: OLLAMA_DEFAULT_SMALL_MODEL,
+ });
+ smallModel = smallModelRaw.trim() || OLLAMA_DEFAULT_SMALL_MODEL;
+ }
+ smallModel = await waitForModel(target, smallModel, "small");
- const embeddingsLocalModel = await askEmbeddingsLocal(EMBEDDINGS_DEFAULTS.localModel);
+ let largeModel =
+ flags?.ollamaLarge ?? flags?.llmLarge ?? OLLAMA_DEFAULT_LARGE_MODEL;
+ if (
+ flags?.ollamaLarge === undefined &&
+ flags?.llmLarge === undefined
+ ) {
+ const largeModelRaw = await askText({
+ message: "Large LLM model name (Ollama tag)",
+ placeholder: OLLAMA_DEFAULT_LARGE_MODEL,
+ defaultValue: OLLAMA_DEFAULT_LARGE_MODEL,
+ });
+ largeModel = largeModelRaw.trim() || OLLAMA_DEFAULT_LARGE_MODEL;
+ }
+ largeModel = await waitForModel(target, largeModel, "large");
+
+ let embeddingsLocalModel =
+ flags?.ollamaEmbeddings ??
+ flags?.embeddingModel ??
+ EMBEDDINGS_DEFAULTS.localModel;
+ if (
+ flags?.ollamaEmbeddings === undefined &&
+ flags?.embeddingModel === undefined
+ ) {
+ embeddingsLocalModel = await askEmbeddingsLocal(EMBEDDINGS_DEFAULTS.localModel);
+ }
return {
host: target.host,
diff --git a/tui/src/flows/plugins.ts b/tui/src/flows/plugins.ts
index 089e706..a1aaf91 100644
--- a/tui/src/flows/plugins.ts
+++ b/tui/src/flows/plugins.ts
@@ -7,6 +7,9 @@ interface AskPluginsOptions {
allowBack?: boolean;
backHint?: string;
initial?: PluginChoice[];
+ /** When set, skip the interactive plugin search UI. */
+ prechosen?: PluginChoice[];
+ skip?: boolean;
}
function pluginLabel(plugin: {
@@ -22,6 +25,10 @@ function pluginLabel(plugin: {
export async function askPlugins(
opts: AskPluginsOptions = {},
): Promise<PluginChoice[] | typeof PROMPT_BACK> {
+ if (opts.skip || opts.prechosen !== undefined) {
+ return opts.prechosen ?? [];
+ }
+
const selections = new Map<string, PluginChoice>();
for (const plugin of opts.initial ?? []) {
selections.set(`${plugin.source}:${plugin.name}:${plugin.path ?? ""}`, plugin);
diff --git a/tui/src/flows/services-runtime.ts b/tui/src/flows/services-runtime.ts
index 67c4247..356096b 100644
--- a/tui/src/flows/services-runtime.ts
+++ b/tui/src/flows/services-runtime.ts
@@ -20,7 +20,11 @@ function nonRedisPicked(dbs: DbChoices): string[] {
export async function askServicesRuntime(
dbs: DbChoices,
- opts?: { allowBack?: false; initialValue?: ServicesRuntime },
+ opts?: {
+ allowBack?: false;
+ initialValue?: ServicesRuntime;
+ prechosen?: ServicesRuntime;
+ },
): Promise<ServicesRuntime>;
export async function askServicesRuntime(
dbs: DbChoices,
@@ -28,6 +32,7 @@ export async function askServicesRuntime(
allowBack: true;
backHint?: string;
initialValue?: ServicesRuntime;
+ prechosen?: ServicesRuntime;
},
): Promise<ServicesRuntime | PromptBack>;
export async function askServicesRuntime(
@@ -36,8 +41,13 @@ export async function askServicesRuntime(
allowBack?: boolean;
backHint?: string;
initialValue?: ServicesRuntime;
+ prechosen?: ServicesRuntime;
},
): Promise<ServicesRuntime | PromptBack> {
+ if (opts?.prechosen) {
+ return opts.prechosen;
+ }
+
const sidecars = ["Redis", ...nonRedisPicked(dbs)];
p.note(
[
diff --git a/tui/src/flows/services.ts b/tui/src/flows/services.ts
index b9ec497..f6b6c91 100644
--- a/tui/src/flows/services.ts
+++ b/tui/src/flows/services.ts
@@ -1,30 +1,37 @@
import * as p from "@clack/prompts";
import { isPromptBack, pickOne, type PromptBack } from "../lib/prompts.js";
-import type { DbChoices } from "../types.js";
+import type { DbChoices, VectorDb, DataDb, GraphDb } from "../types.js";
export async function askDatabases(opts?: {
allowBack?: false;
initial?: Partial<DbChoices>;
+ prechosen?: Partial<DbChoices>;
}): Promise<DbChoices>;
export async function askDatabases(opts: {
allowBack: true;
backHint?: string;
initial?: Partial<DbChoices>;
+ prechosen?: Partial<DbChoices>;
}): Promise<DbChoices | PromptBack>;
export async function askDatabases(opts?: {
allowBack?: boolean;
backHint?: string;
initial?: Partial<DbChoices>;
+ prechosen?: Partial<DbChoices>;
}): Promise<DbChoices | PromptBack> {
p.log.step("Pick your databases");
- let vectorDb = opts?.initial?.vectorDb ?? "postgresql";
- let dataDb = opts?.initial?.dataDb ?? "postgresql";
- let graphDb = opts?.initial?.graphDb ?? "networkx";
+ let vectorDb: VectorDb = opts?.prechosen?.vectorDb ?? opts?.initial?.vectorDb ?? "postgresql";
+ let dataDb: DataDb = opts?.prechosen?.dataDb ?? opts?.initial?.dataDb ?? "postgresql";
+ let graphDb: GraphDb = opts?.prechosen?.graphDb ?? opts?.initial?.graphDb ?? "networkx";
let step = 0;
while (step < 3) {
if (step === 0) {
+ if (opts?.prechosen?.vectorDb) {
+ step = 1;
+ continue;
+ }
const picked = opts?.allowBack
? await pickOne<"postgresql" | "milvus">({
message: "Vector database",
@@ -50,6 +57,10 @@ export async function askDatabases(opts?: {
continue;
}
if (step === 1) {
+ if (opts?.prechosen?.dataDb) {
+ step = 2;
+ continue;
+ }
const picked = await pickOne<"postgresql" | "mongo">({
message: "Data database (text chunks, observations, structured data)",
options: [
@@ -68,6 +79,9 @@ export async function askDatabases(opts?: {
step = 2;
continue;
}
+ if (opts?.prechosen?.graphDb) {
+ return { vectorDb, dataDb, graphDb };
+ }
const picked = await pickOne<"networkx" | "neo4j">({
message: "Graph database",
options: [
diff --git a/tui/src/flows/setup-wizard.ts b/tui/src/flows/setup-wizard.ts
index b3e6690..e54993d 100644
--- a/tui/src/flows/setup-wizard.ts
+++ b/tui/src/flows/setup-wizard.ts
@@ -8,6 +8,10 @@ import { askAuth } from "./auth.js";
import { askServicesRuntime } from "./services-runtime.js";
import { askPlugins } from "./plugins.js";
import { isPromptBack } from "../lib/prompts.js";
+import {
+ hasConfigOverrides,
+ type InitFlagOverrides,
+} from "../lib/init-flags.js";
import type {
AuthChoices,
Connections,
@@ -34,6 +38,7 @@ export interface RunSetupWizardOptions {
firstStepBack?: "return" | "cancel";
stepBackHint?: string;
firstStepBackHint?: string;
+ flags?: InitFlagOverrides;
}
export function toInitChoices(draft: SetupDraft): InitChoices {
@@ -49,16 +54,78 @@ export function toInitChoices(draft: SetupDraft): InitChoices {
};
}
+function seedDraftFromFlags(
+ draft: SetupDraft,
+ flags: InitFlagOverrides | undefined,
+): void {
+ if (!flags) return;
+
+ if (flags.defaults) {
+ draft.usedDefaults = true;
+ draft.dbs = { ...DEFAULT_DBS };
+ draft.pipeline = { ocrMode: flags.ocrMode ?? "docparser" };
+ }
+
+ if (
+ flags.vectorDb !== undefined ||
+ flags.dataDb !== undefined ||
+ flags.graphDb !== undefined
+ ) {
+ draft.dbs = {
+ vectorDb: flags.vectorDb ?? draft.dbs?.vectorDb ?? DEFAULT_DBS.vectorDb,
+ dataDb: flags.dataDb ?? draft.dbs?.dataDb ?? DEFAULT_DBS.dataDb,
+ graphDb: flags.graphDb ?? draft.dbs?.graphDb ?? DEFAULT_DBS.graphDb,
+ };
+ }
+
+ if (flags.ocrMode) {
+ draft.pipeline = { ocrMode: flags.ocrMode };
+ }
+
+ if (flags.servicesRuntime) {
+ draft.servicesRuntime = flags.servicesRuntime;
+ }
+
+ if (flags.brainpatToken) {
+ draft.auth = { brainpatToken: flags.brainpatToken };
+ }
+
+ if (flags.noPlugins) {
+ draft.plugins = [];
+ } else if (flags.plugins) {
+ draft.plugins = flags.plugins;
+ }
+}
+
export async function runSetupWizard(
draft: SetupDraft,
opts: RunSetupWizardOptions = {},
): Promise<boolean> {
+ const flags = opts.flags;
+ seedDraftFromFlags(draft, flags);
+
const stepBackHint = opts.stepBackHint ?? "Previous step";
const firstStepBackHint = opts.firstStepBackHint ?? stepBackHint;
let step = 0;
+ const skipUseDefaults =
+ Boolean(flags?.defaults) || (flags !== undefined && hasConfigOverrides(flags));
+
while (step >= 0) {
if (step === 0) {
+ if (skipUseDefaults) {
+ if (flags?.defaults) {
+ draft.usedDefaults = true;
+ draft.dbs = draft.dbs ?? { ...DEFAULT_DBS };
+ draft.pipeline = draft.pipeline ?? { ocrMode: "docparser" };
+ step = 2;
+ continue;
+ }
+ draft.usedDefaults = false;
+ step = 1;
+ continue;
+ }
+
const useDefaults = await askUseDefaults({
allowBack: true,
backHint: firstStepBackHint,
@@ -82,10 +149,25 @@ export async function runSetupWizard(
}
if (step === 1) {
+ const allDbsPrechosen =
+ flags?.vectorDb !== undefined &&
+ flags?.dataDb !== undefined &&
+ flags?.graphDb !== undefined;
+ if (allDbsPrechosen && draft.dbs) {
+ step = 2;
+ continue;
+ }
const dbs = await askDatabases({
allowBack: true,
backHint: stepBackHint,
initial: draft.dbs,
+ prechosen: flags
+ ? {
+ vectorDb: flags.vectorDb,
+ dataDb: flags.dataDb,
+ graphDb: flags.graphDb,
+ }
+ : undefined,
});
if (isPromptBack(dbs)) {
step = 0;
@@ -101,10 +183,16 @@ export async function runSetupWizard(
step = 1;
continue;
}
+ if (flags?.servicesRuntime) {
+ draft.servicesRuntime = flags.servicesRuntime;
+ step = 3;
+ continue;
+ }
const runtime = await askServicesRuntime(draft.dbs, {
allowBack: true,
backHint: stepBackHint,
initialValue: draft.servicesRuntime,
+ prechosen: flags?.servicesRuntime,
});
if (isPromptBack(runtime)) {
step = draft.usedDefaults ? 0 : 1;
@@ -118,13 +206,16 @@ export async function runSetupWizard(
if (step === 3) {
const models = draft.usedDefaults
? await askModels({
- prechosenMode: "remote",
+ prechosenMode: flags?.modelsMode ?? "remote",
initialMode: draft.models?.mode,
+ flags,
})
: await askModels({
allowBack: true,
backHint: stepBackHint,
initialMode: draft.models?.mode,
+ prechosenMode: flags?.modelsMode,
+ flags,
});
if (isPromptBack(models)) {
step = 2;
@@ -140,6 +231,7 @@ export async function runSetupWizard(
allowBack: true,
backHint: stepBackHint,
initialOcrMode: draft.pipeline?.ocrMode,
+ prechosenOcrMode: flags?.ocrMode,
});
if (isPromptBack(pipeline)) {
step = 3;
@@ -155,15 +247,21 @@ export async function runSetupWizard(
step = draft.usedDefaults ? 0 : 1;
continue;
}
- draft.connections = await askConnections(draft.dbs);
+ draft.connections = await askConnections(draft.dbs, flags);
step = 6;
continue;
}
if (step === 6) {
+ if (flags?.brainpatToken) {
+ draft.auth = { brainpatToken: flags.brainpatToken };
+ step = 7;
+ continue;
+ }
const auth = await askAuth({
allowBack: true,
backHint: stepBackHint,
+ prechosenToken: flags?.brainpatToken,
});
if (isPromptBack(auth)) {
step = 5;
@@ -175,10 +273,16 @@ export async function runSetupWizard(
}
if (step === 7) {
+ if (flags?.noPlugins || flags?.plugins !== undefined) {
+ draft.plugins = flags.noPlugins ? [] : (flags.plugins ?? []);
+ return true;
+ }
const plugins = await askPlugins({
allowBack: true,
backHint: stepBackHint,
initial: draft.plugins,
+ prechosen: flags?.plugins,
+ skip: flags?.noPlugins,
});
if (isPromptBack(plugins)) {
step = 6;
diff --git a/tui/src/index.ts b/tui/src/index.ts
index e8d5c8e..048c574 100644
--- a/tui/src/index.ts
+++ b/tui/src/index.ts
@@ -8,6 +8,10 @@ import { runUpdate } from "./commands/update.js";
import { runPlugins, type PluginsOptions, type PluginsSubcommand } from "./commands/plugins.js";
import { runReset, type ResetCommandOptions } from "./commands/reset.js";
import { readState } from "./lib/state.js";
+import {
+ tryApplyInitFlag,
+ type InitFlagOverrides,
+} from "./lib/init-flags.js";
import { isPipelineMode, type PipelineMode } from "./types.js";
type Command =
@@ -34,6 +38,8 @@ interface ParsedArgs {
invalidPipeline?: string;
plugins?: PluginsOptions;
reset?: ResetCommandOptions;
+ initFlags?: InitFlagOverrides;
+ initFlagError?: string;
unknown: string[];
}
@@ -54,6 +60,7 @@ function parseArgs(argv: string[]): ParsedArgs {
let command: Command = "help";
const unknown: string[] = [];
const out: ParsedArgs = { command, unknown };
+ let initFlags: InitFlagOverrides | undefined;
while (args.length > 0) {
const arg = args.shift()!;
@@ -96,6 +103,8 @@ function parseArgs(argv: string[]): ParsedArgs {
} else if (arg === "--version" || arg === "-v") {
printVersion();
process.exit(0);
+ } else if (arg === "--init") {
+ out.command = "init";
} else if (out.command === "help" && !arg.startsWith("-")) {
switch (arg) {
case "init":
@@ -111,6 +120,16 @@ function parseArgs(argv: string[]): ParsedArgs {
default:
unknown.push(arg);
}
+ } else if (out.command === "init") {
+ if (!initFlags) initFlags = {};
+ const result = tryApplyInitFlag(arg, args, initFlags);
+ if (result.kind === "error") {
+ out.initFlagError = result.error;
+ return out;
+ }
+ if (result.kind === "unknown") {
+ unknown.push(arg);
+ }
} else if (out.command === "reset") {
if (!out.reset) out.reset = {};
const reset = out.reset;
@@ -156,6 +175,10 @@ function parseArgs(argv: string[]): ParsedArgs {
unknown.push(arg);
}
}
+
+ if (initFlags && Object.keys(initFlags).length > 0) {
+ out.initFlags = initFlags;
+ }
return out;
}
@@ -179,6 +202,7 @@ function printHelp(): void {
" -r, --repo <url> Git repo to clone (default $BRAINAPI_REPO_URL or upstream)",
" -b, --branch <ref> Branch to checkout (default $BRAINAPI_BRANCH or 'main')",
" -f, --force Re-run init even if state exists",
+ " --init Alias for the init command",
" --no-services For 'start': skip bringing backing services up",
" --no-api For 'start': skip the API server",
" --no-mcp For 'start': skip the MCP server",
@@ -194,6 +218,13 @@ function printHelp(): void {
" -v, --version Print the CLI version",
" -h, --help Show this message",
"",
+ pc.bold("Init flags:") + " " + pc.dim("(provided values skip that wizard prompt)"),
+ " --defaults Use default DB stack (Postgres + pgvector + NetworkX)",
+ " --vector-db|--data-db|--graph-db|--ocr-mode|--services-runtime",
+ " --models-mode|--llm-*-provider|--llm-small|--llm-large|--embedding-model",
+ " --start-services|--no-start-services|--brainpat-token|--plugin|--no-plugins",
+ " …plus connection + provider credential flags (see README)",
+ "",
pc.dim("Environment overrides: BRAINAPI_HOME, BRAINAPI_REPO_URL, BRAINAPI_BRANCH"),
];
console.log(lines.join("\n"));
@@ -215,6 +246,10 @@ async function autoInitIfNeeded(command: Command): Promise<Command> {
async function main(): Promise<void> {
const parsed = parseArgs(process.argv.slice(2));
+ if (parsed.initFlagError) {
+ p.log.error(parsed.initFlagError);
+ process.exit(1);
+ }
if (parsed.invalidPipeline !== undefined) {
p.log.error(
`Invalid --pipeline value "${parsed.invalidPipeline}". Use accurate or lightweight.`,
@@ -244,6 +279,7 @@ async function main(): Promise<void> {
repoUrl: parsed.repo,
branch: parsed.branch,
force: parsed.force,
+ flags: parsed.initFlags,
});
return;
case "start": {
diff --git a/tui/src/lib/init-flags.ts b/tui/src/lib/init-flags.ts
new file mode 100644
index 0000000..4e9c899
--- /dev/null
+++ b/tui/src/lib/init-flags.ts
@@ -0,0 +1,507 @@
+import type {
+ DataDb,
+ GraphDb,
+ ModelProvider,
+ ModelsMode,
+ OcrMode,
+ PluginChoice,
+ ServicesRuntime,
+ VectorDb,
+} from "../types.js";
+
+export interface InitFlagOverrides {
+ defaults?: boolean;
+ vectorDb?: VectorDb;
+ dataDb?: DataDb;
+ graphDb?: GraphDb;
+ ocrMode?: OcrMode;
+ servicesRuntime?: ServicesRuntime;
+ startServices?: boolean;
+
+ modelsMode?: ModelsMode;
+ llmSmallProvider?: ModelProvider;
+ llmLargeProvider?: ModelProvider;
+ embeddingsProvider?: Exclude<ModelProvider, "anthropic" | "deepseek">;
+ llmSmall?: string;
+ llmLarge?: string;
+ embeddingModel?: string;
+ embeddingDimensions?: number;
+
+ ollamaHost?: string;
+ ollamaPort?: number;
+ ollamaSmall?: string;
+ ollamaLarge?: string;
+ ollamaEmbeddings?: string;
+
+ gcpCredentials?: string;
+ gcpProject?: string;
+ gcpSmall?: string;
+ gcpLarge?: string;
+ gcpEmbedding?: string;
+
+ azureEndpoint?: string;
+ azureApiVersion?: string;
+ azureKey?: string;
+ azureSmall?: string;
+ azureLarge?: string;
+ azureEmbeddingEndpoint?: string;
+ azureEmbeddingKey?: string;
+ azureEmbedding?: string;
+
+ openaiApiKey?: string;
+ openaiBaseUrl?: string;
+ openaiSmall?: string;
+ openaiLarge?: string;
+ openaiEmbedding?: string;
+
+ anthropicApiKey?: string;
+ anthropicSmall?: string;
+ anthropicLarge?: string;
+
+ deepseekApiKey?: string;
+ deepseekSmall?: string;
+ deepseekLarge?: string;
+
+ awsRegion?: string;
+ awsAccessKeyId?: string;
+ awsSecretAccessKey?: string;
+ awsSessionToken?: string;
+ bedrockSmall?: string;
+ bedrockLarge?: string;
+ bedrockEmbedding?: string;
+
+ redisHost?: string;
+ redisPort?: number;
+ postgresHost?: string;
+ postgresPort?: number;
+ postgresUsername?: string;
+ postgresPassword?: string;
+ postgresSystemDb?: string;
+ postgresMaintenanceDb?: string;
+ neo4jHost?: string;
+ neo4jPort?: number;
+ neo4jUsername?: string;
+ neo4jPassword?: string;
+ milvusDeployment?: "local" | "managed";
+ milvusHost?: string;
+ milvusPort?: number;
+ milvusUri?: string;
+ milvusToken?: string;
+ mongoHost?: string;
+ mongoPort?: number;
+ mongoUsername?: string;
+ mongoPassword?: string;
+
+ brainpatToken?: string;
+ plugins?: PluginChoice[];
+ noPlugins?: boolean;
+}
+
+const VECTOR_DBS = new Set<VectorDb>(["postgresql", "milvus"]);
+const DATA_DBS = new Set<DataDb>(["postgresql", "mongo"]);
+const GRAPH_DBS = new Set<GraphDb>(["networkx", "neo4j"]);
+const OCR_MODES = new Set<OcrMode>(["docparser", "docling"]);
+const RUNTIMES = new Set<ServicesRuntime>(["docker", "manual"]);
+const MODELS_MODES = new Set<ModelsMode>(["local", "remote"]);
+const LLM_PROVIDERS = new Set<ModelProvider>([
+ "ollama",
+ "openai",
+ "anthropic",
+ "deepseek",
+ "azure",
+ "gcp_vertex",
+ "amazon_bedrock",
+]);
+const EMBEDDING_PROVIDERS = new Set<Exclude<ModelProvider, "anthropic" | "deepseek">>([
+ "ollama",
+ "openai",
+ "azure",
+ "gcp_vertex",
+ "amazon_bedrock",
+]);
+
+function splitFlag(arg: string): { name: string; inline?: string } {
+ const eq = arg.indexOf("=");
+ if (eq === -1) return { name: arg };
+ return { name: arg.slice(0, eq), inline: arg.slice(eq + 1) };
+}
+
+function takeValue(
+ inline: string | undefined,
+ args: string[],
+ flag: string,
+): { ok: true; value: string } | { ok: false; error: string } {
+ if (inline !== undefined) {
+ if (inline.length === 0) {
+ return { ok: false, error: `${flag} requires a value` };
+ }
+ return { ok: true, value: inline };
+ }
+ const next = args.shift();
+ if (next === undefined || next.startsWith("-")) {
+ if (next !== undefined) args.unshift(next);
+ return { ok: false, error: `${flag} requires a value` };
+ }
+ return { ok: true, value: next };
+}
+
+function parsePort(
+ raw: string,
+ flag: string,
+): { ok: true; value: number } | { ok: false; error: string } {
+ const n = Number(raw);
+ if (!Number.isInteger(n) || n <= 0 || n > 65535) {
+ return { ok: false, error: `${flag} must be an integer port 1-65535` };
+ }
+ return { ok: true, value: n };
+}
+
+function parsePositiveInt(
+ raw: string,
+ flag: string,
+): { ok: true; value: number } | { ok: false; error: string } {
+ const n = Number(raw);
+ if (!Number.isInteger(n) || n <= 0) {
+ return { ok: false, error: `${flag} must be a positive integer` };
+ }
+ return { ok: true, value: n };
+}
+
+function parsePluginSpec(raw: string): PluginChoice {
+ const at = raw.lastIndexOf("@");
+ if (at > 0) {
+ return {
+ name: raw.slice(0, at),
+ source: "registry",
+ version: raw.slice(at + 1),
+ };
+ }
+ return { name: raw, source: "registry" };
+}
+
+/** True when any wizard-config flag is present (skips “use defaults?”). */
+export function hasConfigOverrides(flags: InitFlagOverrides): boolean {
+ const {
+ defaults: _defaults,
+ startServices: _start,
+ ...rest
+ } = flags;
+ return Object.values(rest).some((v) => v !== undefined);
+}
+
+export type ApplyInitFlagResult =
+ | { kind: "applied" }
+ | { kind: "unknown" }
+ | { kind: "error"; error: string };
+
+/** Apply a single init flag. Mutates `flags` and may shift `args` for the value. */
+export function tryApplyInitFlag(
+ raw: string,
+ args: string[],
+ flags: InitFlagOverrides,
+): ApplyInitFlagResult {
+ if (!raw.startsWith("-")) return { kind: "unknown" };
+
+ const { name, inline } = splitFlag(raw);
+
+ const setString = (key: keyof InitFlagOverrides, flagName: string): ApplyInitFlagResult => {
+ const taken = takeValue(inline, args, flagName);
+ if (!taken.ok) return { kind: "error", error: taken.error };
+ (flags as Record<string, unknown>)[key] = taken.value;
+ return { kind: "applied" };
+ };
+
+ const setPort = (key: keyof InitFlagOverrides, flagName: string): ApplyInitFlagResult => {
+ const taken = takeValue(inline, args, flagName);
+ if (!taken.ok) return { kind: "error", error: taken.error };
+ const port = parsePort(taken.value, flagName);
+ if (!port.ok) return { kind: "error", error: port.error };
+ (flags as Record<string, unknown>)[key] = port.value;
+ return { kind: "applied" };
+ };
+
+ switch (name) {
+ case "--defaults":
+ flags.defaults = true;
+ return { kind: "applied" };
+ case "--vector-db": {
+ const taken = takeValue(inline, args, name);
+ if (!taken.ok) return { kind: "error", error: taken.error };
+ const v = taken.value.toLowerCase() as VectorDb;
+ if (!VECTOR_DBS.has(v)) {
+ return {
+ kind: "error",
+ error: `Invalid --vector-db "${taken.value}". Use postgresql or milvus.`,
+ };
+ }
+ flags.vectorDb = v;
+ return { kind: "applied" };
+ }
+ case "--data-db": {
+ const taken = takeValue(inline, args, name);
+ if (!taken.ok) return { kind: "error", error: taken.error };
+ const v = taken.value.toLowerCase() as DataDb;
+ if (!DATA_DBS.has(v)) {
+ return {
+ kind: "error",
+ error: `Invalid --data-db "${taken.value}". Use postgresql or mongo.`,
+ };
+ }
+ flags.dataDb = v;
+ return { kind: "applied" };
+ }
+ case "--graph-db": {
+ const taken = takeValue(inline, args, name);
+ if (!taken.ok) return { kind: "error", error: taken.error };
+ const v = taken.value.toLowerCase() as GraphDb;
+ if (!GRAPH_DBS.has(v)) {
+ return {
+ kind: "error",
+ error: `Invalid --graph-db "${taken.value}". Use networkx or neo4j.`,
+ };
+ }
+ flags.graphDb = v;
+ return { kind: "applied" };
+ }
+ case "--ocr-mode": {
+ const taken = takeValue(inline, args, name);
+ if (!taken.ok) return { kind: "error", error: taken.error };
+ const v = taken.value.toLowerCase() as OcrMode;
+ if (!OCR_MODES.has(v)) {
+ return {
+ kind: "error",
+ error: `Invalid --ocr-mode "${taken.value}". Use docparser or docling.`,
+ };
+ }
+ flags.ocrMode = v;
+ return { kind: "applied" };
+ }
+ case "--services-runtime": {
+ const taken = takeValue(inline, args, name);
+ if (!taken.ok) return { kind: "error", error: taken.error };
+ const v = taken.value.toLowerCase() as ServicesRuntime;
+ if (!RUNTIMES.has(v)) {
+ return {
+ kind: "error",
+ error: `Invalid --services-runtime "${taken.value}". Use docker or manual.`,
+ };
+ }
+ flags.servicesRuntime = v;
+ return { kind: "applied" };
+ }
+ case "--start-services":
+ flags.startServices = true;
+ return { kind: "applied" };
+ case "--no-start-services":
+ flags.startServices = false;
+ return { kind: "applied" };
+ case "--models-mode": {
+ const taken = takeValue(inline, args, name);
+ if (!taken.ok) return { kind: "error", error: taken.error };
+ const v = taken.value.toLowerCase() as ModelsMode;
+ if (!MODELS_MODES.has(v)) {
+ return {
+ kind: "error",
+ error: `Invalid --models-mode "${taken.value}". Use local or remote.`,
+ };
+ }
+ flags.modelsMode = v;
+ return { kind: "applied" };
+ }
+ case "--llm-small-provider": {
+ const taken = takeValue(inline, args, name);
+ if (!taken.ok) return { kind: "error", error: taken.error };
+ const v = taken.value.toLowerCase() as ModelProvider;
+ if (!LLM_PROVIDERS.has(v)) {
+ return {
+ kind: "error",
+ error: `Invalid --llm-small-provider "${taken.value}".`,
+ };
+ }
+ flags.llmSmallProvider = v;
+ return { kind: "applied" };
+ }
+ case "--llm-large-provider": {
+ const taken = takeValue(inline, args, name);
+ if (!taken.ok) return { kind: "error", error: taken.error };
+ const v = taken.value.toLowerCase() as ModelProvider;
+ if (!LLM_PROVIDERS.has(v)) {
+ return {
+ kind: "error",
+ error: `Invalid --llm-large-provider "${taken.value}".`,
+ };
+ }
+ flags.llmLargeProvider = v;
+ return { kind: "applied" };
+ }
+ case "--embeddings-provider": {
+ const taken = takeValue(inline, args, name);
+ if (!taken.ok) return { kind: "error", error: taken.error };
+ const v = taken.value.toLowerCase() as Exclude<
+ ModelProvider,
+ "anthropic" | "deepseek"
+ >;
+ if (!EMBEDDING_PROVIDERS.has(v)) {
+ return {
+ kind: "error",
+ error: `Invalid --embeddings-provider "${taken.value}".`,
+ };
+ }
+ flags.embeddingsProvider = v;
+ return { kind: "applied" };
+ }
+ case "--llm-small":
+ return setString("llmSmall", name);
+ case "--llm-large":
+ return setString("llmLarge", name);
+ case "--embedding-model":
+ return setString("embeddingModel", name);
+ case "--embedding-dimensions": {
+ const taken = takeValue(inline, args, name);
+ if (!taken.ok) return { kind: "error", error: taken.error };
+ const n = parsePositiveInt(taken.value, name);
+ if (!n.ok) return { kind: "error", error: n.error };
+ flags.embeddingDimensions = n.value;
+ return { kind: "applied" };
+ }
+ case "--ollama-host":
+ return setString("ollamaHost", name);
+ case "--ollama-port":
+ return setPort("ollamaPort", name);
+ case "--ollama-small":
+ return setString("ollamaSmall", name);
+ case "--ollama-large":
+ return setString("ollamaLarge", name);
+ case "--ollama-embeddings":
+ return setString("ollamaEmbeddings", name);
+ case "--gcp-credentials":
+ return setString("gcpCredentials", name);
+ case "--gcp-project":
+ return setString("gcpProject", name);
+ case "--gcp-small":
+ return setString("gcpSmall", name);
+ case "--gcp-large":
+ return setString("gcpLarge", name);
+ case "--gcp-embedding":
+ return setString("gcpEmbedding", name);
+ case "--azure-endpoint":
+ return setString("azureEndpoint", name);
+ case "--azure-api-version":
+ return setString("azureApiVersion", name);
+ case "--azure-key":
+ return setString("azureKey", name);
+ case "--azure-small":
+ return setString("azureSmall", name);
+ case "--azure-large":
+ return setString("azureLarge", name);
+ case "--azure-embedding-endpoint":
+ return setString("azureEmbeddingEndpoint", name);
+ case "--azure-embedding-key":
+ return setString("azureEmbeddingKey", name);
+ case "--azure-embedding":
+ return setString("azureEmbedding", name);
+ case "--openai-api-key":
+ return setString("openaiApiKey", name);
+ case "--openai-base-url":
+ return setString("openaiBaseUrl", name);
+ case "--openai-small":
+ return setString("openaiSmall", name);
+ case "--openai-large":
+ return setString("openaiLarge", name);
+ case "--openai-embedding":
+ return setString("openaiEmbedding", name);
+ case "--anthropic-api-key":
+ return setString("anthropicApiKey", name);
+ case "--anthropic-small":
+ return setString("anthropicSmall", name);
+ case "--anthropic-large":
+ return setString("anthropicLarge", name);
+ case "--deepseek-api-key":
+ return setString("deepseekApiKey", name);
+ case "--deepseek-small":
+ return setString("deepseekSmall", name);
+ case "--deepseek-large":
+ return setString("deepseekLarge", name);
+ case "--aws-region":
+ return setString("awsRegion", name);
+ case "--aws-access-key-id":
+ return setString("awsAccessKeyId", name);
+ case "--aws-secret-access-key":
+ return setString("awsSecretAccessKey", name);
+ case "--aws-session-token":
+ return setString("awsSessionToken", name);
+ case "--bedrock-small":
+ return setString("bedrockSmall", name);
+ case "--bedrock-large":
+ return setString("bedrockLarge", name);
+ case "--bedrock-embedding":
+ return setString("bedrockEmbedding", name);
+ case "--redis-host":
+ return setString("redisHost", name);
+ case "--redis-port":
+ return setPort("redisPort", name);
+ case "--postgres-host":
+ return setString("postgresHost", name);
+ case "--postgres-port":
+ return setPort("postgresPort", name);
+ case "--postgres-username":
+ return setString("postgresUsername", name);
+ case "--postgres-password":
+ return setString("postgresPassword", name);
+ case "--postgres-system-db":
+ return setString("postgresSystemDb", name);
+ case "--postgres-maintenance-db":
+ return setString("postgresMaintenanceDb", name);
+ case "--neo4j-host":
+ return setString("neo4jHost", name);
+ case "--neo4j-port":
+ return setPort("neo4jPort", name);
+ case "--neo4j-username":
+ return setString("neo4jUsername", name);
+ case "--neo4j-password":
+ return setString("neo4jPassword", name);
+ case "--milvus-deployment": {
+ const taken = takeValue(inline, args, name);
+ if (!taken.ok) return { kind: "error", error: taken.error };
+ const v = taken.value.toLowerCase();
+ if (v !== "local" && v !== "managed") {
+ return {
+ kind: "error",
+ error: `Invalid --milvus-deployment "${taken.value}". Use local or managed.`,
+ };
+ }
+ flags.milvusDeployment = v;
+ return { kind: "applied" };
+ }
+ case "--milvus-host":
+ return setString("milvusHost", name);
+ case "--milvus-port":
+ return setPort("milvusPort", name);
+ case "--milvus-uri":
+ return setString("milvusUri", name);
+ case "--milvus-token":
+ return setString("milvusToken", name);
+ case "--mongo-host":
+ return setString("mongoHost", name);
+ case "--mongo-port":
+ return setPort("mongoPort", name);
+ case "--mongo-username":
+ return setString("mongoUsername", name);
+ case "--mongo-password":
+ return setString("mongoPassword", name);
+ case "--brainpat-token":
+ return setString("brainpatToken", name);
+ case "--plugin": {
+ const taken = takeValue(inline, args, name);
+ if (!taken.ok) return { kind: "error", error: taken.error };
+ if (!flags.plugins) flags.plugins = [];
+ flags.plugins.push(parsePluginSpec(taken.value));
+ return { kind: "applied" };
+ }
+ case "--no-plugins":
+ flags.noPlugins = true;
+ return { kind: "applied" };
+ default:
+ return { kind: "unknown" };
+ }
+}