Skip to Content
Baseera Docs

FAQ

Short answers to common questions about models, data, keys, languages and approvals.

Models and cost

Which models can I use?

Anthropic, OpenAI, Google (Gemini) and OpenRouter. You add your own key for a provider, then choose a model per agent. You can also type a model id that is not in the list.

Who pays for model usage?

You do, directly to the provider, because Baseera runs on your key. The dashboard shows estimated cost per key, agent, tenant and session, and you can set a monthly cost or token limit per agent and a default per tenant.

Does Baseera see my provider key after I save it?

The key is checked with the provider, stored encrypted, and never returned by any API. The dashboard shows only the provider, a label and the last four characters. Only the runtime's model gateway reads it, for the agent that owns it.

Knowledge

What can I add as knowledge?

Uploaded files (PDF and DOCX are parsed, up to 50 MB each), websites that Baseera crawls and keeps in sync, and items your server pushes through the ingestion API. An organization can hold up to 1 GB of originals.

Does it work with Arabic documents?

Yes. Search normalizes Arabic text, handles the presentation forms that PDF extraction often returns, and citations render right to left. Scanned documents are flagged as needing OCR when no text can be read.

Can one customer see another customer's documents?

No. Sources carry the tenant they belong to, and search filters by the tenant in the user's token inside the database query. You can also restrict a source to a role or a claim.

Can users open the original document from a citation?

Only if you allow it for that document. By default a citation shows the title and section only.

Actions and approvals

Can the agent change data without asking?

Not through a write or draft tool. Those wait for the user to press Approve. A read tool runs at once, so mark a tool read only if it changes nothing.

Where do my tools run?

In your app, in the user's browser, with the user's own session. Baseera never stores or runs them, and your own API still decides what is allowed.

Integration

Which frameworks does the SDK support?

@baseera/react and @baseera/ui target React, and the quickstart uses Next.js App Router. @baseera/core is framework-free, and @baseera/node runs on your server.

Is there a hosted runtime?

Not yet. Today you run the runtime from the repository and point NEXT_PUBLIC_BASEERA_URL at it. This page will change when a hosted runtime exists.

Are the SDK packages on npm?

Not yet. They are licensed MIT and prepared for a public release, but the first publish has not happened.

Can I use the assistant before I add a user token route?

In development, an agent can allow sessions without a token, but only from localhost. Turn that off before you go live.

Testing and release

Do my edits go live when I save?

No. Saving writes a draft. Production changes only when an owner or admin publishes, and they can roll back to an earlier version.

Can I block a release when tests fail?

Yes. Mark suites as required with a minimum pass rate, and publishing is blocked until they reach it on the draft. Only an owner can publish past failing tests, with a written reason that is kept in the history.

Security

Does Baseera support two-factor sign-in?

Yes. Owners and admins can use an authenticator app, and an owner can require it for the organization.

How do I report a vulnerability?

Do not open a public issue. Use the private vulnerability reporting on the repository's Security tab, and include how to reproduce it and what it could allow. See Support.

Next steps

On this page