# SQAI

## SQAI

- [Overview](https://docs.sqai.com/getting-started/readme.md): SQAI is the governed, read-only structured-data tool for AI agents — typed, policy-checked plans run on a SQAI runtime, every answer carrying replayable hashes.
- [Installation](https://docs.sqai.com/getting-started/installation.md): Install the SQAI SDKs, AI SDK tools, and CLI — the query plane runs in-process immediately, and the compute runtime provisions once, then stays warm.
- [Quickstart — TypeScript](https://docs.sqai.com/getting-started/quickstart-ts.md): Install the SQAI TypeScript SDK, create a client, connect a CSV, ask a deterministic query, and compute a hashed result — from a clean machine to a verifiable answer.
- [Quickstart — Python](https://docs.sqai.com/getting-started/quickstart-python.md): Install the SQAI Python SDK, connect a source, ask a deterministic query, and run a finance.npv computation whose value and hashes are byte-identical to the TypeScript SDK.
- [Overview](https://docs.sqai.com/connect-your-data/connect-data.md): Connect any data source to SQAI — files and SQLite in-process with no key; live databases through a private SQAI deployment. Local bytes stay local, and deployment credentials stay on your infrastruct
- [Files & SQLite](https://docs.sqai.com/connect-your-data/files.md): Connect CSV, TSV, JSON, in-memory rows, and SQLite files entirely in-process — no key, no network, no separate service. The bytes never leave your machine.
- [Databases (your deployment)](https://docs.sqai.com/connect-your-data/databases.md): Connect PostgreSQL, MySQL, Oracle, SQL Server, and the warehouses to SQAI through a private SQAI deployment you run — credentials stay on your infrastructure, no data copied to any SQAI cloud.
- [Object storage, NoSQL, REST & repos](https://docs.sqai.com/connect-your-data/object-stores-and-apis.md): Connect S3/GCS/Azure object storage, Redis/Neo4j/Elasticsearch, REST APIs, and Git repos through a private SQAI deployment you run — credentials stay on your infrastructure, no data copied to any SQAI
- [Compute & filtering](https://docs.sqai.com/capabilities-by-topic/compute-and-filtering.md): 6,084 read-only capabilities across every quantitative domain, with 5,790 exposed to the SDKs — installed as a signed bundle compiled for exactly the modules you filter to.
- [Statistics, probability & distributions](https://docs.sqai.com/capabilities-by-topic/statistics.md): 195 read-only capabilities for descriptive statistics, probability, distributions, and Bayesian inference — each a hash-pinned function that runs on the signed on-device runtime and returns its value
- [Hypothesis testing & inference](https://docs.sqai.com/capabilities-by-topic/hypothesis-testing.md): 66 read-only capabilities for turning samples into decisions — parametric and nonparametric tests, A/B experiment design, and Bayesian updates — each returning its statistic, p-value, and reproducible
- [Finance, risk & accounting](https://docs.sqai.com/capabilities-by-topic/finance.md): 59 deterministic capabilities for time-value-of-money, portfolio risk, actuarial annuities, accounting ratios, and behavioral economics — every call hash-pinned and reproducible in TypeScript and Pyth
- [Option pricing & derivatives](https://docs.sqai.com/capabilities-by-topic/option-pricing.md): 10 read-only, deterministic capabilities for pricing European options, computing their Greeks, and inverting the market for implied volatility — every quote hashed and reproducible.
- [Linear algebra & tensors](https://docs.sqai.com/capabilities-by-topic/linear-algebra.md): 128 read-only capabilities for tensors, matrices, decompositions, and vector search — every call typed, deterministic, and hash-pinned, on your machine.
- [Optimization & operations research](https://docs.sqai.com/capabilities-by-topic/optimization.md): 92 read-only, deterministic capabilities for optimization and operations research — LP and constraint solving, EOQ and queueing, line-search and gradient steps, and serving/search tuning — across 10 m
- [Time series & forecasting](https://docs.sqai.com/capabilities-by-topic/time-series.md): 18 read-only capabilities for sequential data — decompose, test for stationarity, measure autocorrelation, smooth, and forecast — every one deterministic and byte-identical across TypeScript and Pytho
- [Signal processing & DSP](https://docs.sqai.com/capabilities-by-topic/signal-dsp.md): 92 read-only capabilities for the frequency and time domains — FFT, windowing, wavelets, audio, acoustics, psychoacoustics, and signal timing — every transform deterministic and hash-pinned.
- [Machine learning & metrics](https://docs.sqai.com/capabilities-by-topic/machine-learning.md): 114 read-only capabilities for embeddings, classifiers, clustering, model-evaluation metrics, and psychometrics — every score hash-pinned and byte-identical across the TypeScript and Python SDKs.
- [Text, crypto & data utilities](https://docs.sqai.com/capabilities-by-topic/text-crypto.md): 213 read-only capabilities for text similarity, information theory, bit and byte manipulation, AES primitives, compression, JSON parsing, and transformer positional encoding — every call deterministic
- [Graphs, trees & number theory](https://docs.sqai.com/capabilities-by-topic/graph.md): 192 discrete-structure capabilities across 17 modules — graph traversal and shortest paths, heaps, interval arithmetic, Petri nets, and number theory — each an exact, hash-pinned result.
- [100+ science & engineering packs](https://docs.sqai.com/capabilities-by-topic/science-domains.md): 3,645 read-only capabilities across 353 named domain packs — aerospace, cardiology, seismology, pharmacokinetics, and hundreds more — each a hash-pinned function, not a formula an agent typed.
- [Vercel AI SDK tool](https://docs.sqai.com/guides/ai-sdk-tools.md): Expose SQAI to a Vercel AI SDK agent as three governed, deterministic, read-only tools — createSQAI, sqai.tools(), and a replayable hash on every answer.
- [Building agents](https://docs.sqai.com/guides/building-agents.md): Build a real agent on SQAI end to end — the discover → plan → execute loop, a system prompt that uses the tools well, streaming, clarifications, provenance capture, policy, and a Next.js route handler
- [Policy & governance](https://docs.sqai.com/guides/policy.md): How SQAI enforces read-only, pre-execution allow-lists for sources, fields, and functions that model tool input can never widen.
- [Errors & typed results](https://docs.sqai.com/guides/errors-and-results.md): Every SQAI result is a typed, discriminated union and every failure is a typed SqaiError — how to branch on status, kind, code, source, and retryable across both SDKs and the AI SDK tools.
- [Performance & the two planes](https://docs.sqai.com/guides/performance.md): Where SQAI spends time — an in-process query plane at sub-millisecond, a compute runtime that provisions once then stays warm, and the knobs that keep both fast without ever touching a cloud.
- [Python ↔ TypeScript parity](https://docs.sqai.com/guides/parity.md): The same logical operation returns the same value and byte-identical plan\_hash / invocation\_hash / computation\_hash in the TypeScript and Python SDKs — one contract, one canonical serializer, two idio
- [Recipes](https://docs.sqai.com/guides/recipes.md): Task-first snippets for SQAI — query a source, compute a hashed value, bind columns, discover capabilities, capture provenance, govern reach, and wire an agent. TypeScript and Python, byte-identical.
- [How it works](https://docs.sqai.com/concepts/concepts.md): How SQAI turns a model's typed intent into a contract-validated, policy-checked, deterministically executed result with cross-language provenance — never SQL, never code.
- [Architecture](https://docs.sqai.com/concepts/architecture.md): The parts SQAI is built from and the boundaries between them — a thin in-process control plane, a hash-pinned contract, and a signed on-device runtime, with one canonical serializer across both SDKs a
- [Determinism & provenance](https://docs.sqai.com/concepts/determinism.md): Every SQAI result is reproducible within its declared execution scope — one determinism envelope, three domain-separated hashes, and byte-identical output across the TypeScript and Python SDKs.
- [Security & privacy](https://docs.sqai.com/concepts/security-privacy.md): SQAI runs on your machine — no cloud, no query-time network, read-only by construction, and a signed on-device runtime you can verify. What crosses the network, and what never does.
- [CLI reference](https://docs.sqai.com/reference/cli.md): Every sqai CLI command — doctor, runtime provisioning, and contract inspection — with real output, --json everywhere, and scriptable exit codes.
- [Licensing & accounts](https://docs.sqai.com/reference/licensing.md): SQAI local mode runs on your machine. Free on 1 machine with one device login; sign in to manage your device or unlock more machines, seats, and commercial use.
- [Troubleshooting](https://docs.sqai.com/reference/troubleshooting.md): Every SqaiError code and its one-line fix, plus the sqai doctor and runtime diagnostics.
- [FAQ](https://docs.sqai.com/reference/faq.md): Short answers on read-only guarantees, what leaves your machine, keys, speed, determinism, platforms, data sources, and cost.
- [Changelog](https://docs.sqai.com/reference/changelog.md): Release history for SQAI — every version pins one tested substrate pair of SDKs, the SQAI runtime, the signed runtime bundle, and the capability-contract hash.