kimo
Kimo docs · v4.8 · updated Oct 9, 2026

Connect, model and ship answers your team trusts.

Guides, references and recipes for every part of Kimo: from your first connector to air-gapped deployments and the REST API.

Popular:Connect PostgreSQLAsk KimoSSO & SCIMREST API
Quick start

Up and running in three guides

New to Kimo? Follow these in order. Each one takes less than ten minutes.

Read the core concepts
  1. 01

    Quickstart

    From an empty workspace to a live, shareable dashboard in about ten minutes.

    6 minStart
  2. 02

    Connect a database

    Create a read-only user, pick tables and choose cached or live queries.

    7 minStart
  3. 03

    Ask your first question

    Plain English in, certified chart out, with the SQL to prove it.

    6 minStart
Browse the docs

Six sections, one straight line

Sources feed models, models power charts, and everything deploys wherever your data has to live.

Get started

3 guides

Create a workspace, learn the vocabulary and ship a first dashboard.

Connect

3 guides

Databases, SaaS tools and streams. Credentials, networking and freshness.

Kimo Bridge

4 guides

Self-hosted package: outbound-only tunnel, live pushdown or cloud sync, per-source policy.

Model

3 guides

Turn tables into a governed semantic layer: grains, measures, joins.

Visualize

3 guides

Ask Kimo in plain English, build charts and get alerted when things move.

Deploy & secure

3 guides

SSO, SCIM, on-premise and air-gapped installs, and the REST API.

Connect your first source

Four steps, about three minutes

This is the exact flow you’ll see in the app. Click a step, or let it play.

app.getkimo.com/connectors/new1/4
Add a source
post
  • PostgreSQL
  • MySQL
  • Stripe
  • HubSpot
  • Google Search Console
  • Snowflake
  • BigQuery
  • Shopify

Can’t find yours? Use the generic SQL, REST or CSV connector, or request one.

Example data. Your schema will differ.Full PostgreSQL guide
Recently updated

Fresh this month

    Oct 9, 2026
    REST API

    Authenticate, query the semantic layer, manage sources and dashboards, and handle pagination, errors and rate limits with the Kimo REST API.

    Oct 8, 2026
    On-premise install

    Run Kimo in your own infrastructure: Kubernetes and Docker requirements, the Helm chart, air-gapped installation with the offline bundle, upgrades and backups.

    Oct 7, 2026
    Ask Kimo

    Ask questions in plain English and get charts backed by certified measures. How Ask Kimo works, writing good questions, reviewing answers and controlling what it can see.

    Oct 6, 2026
    Quickstart

    Go from an empty workspace to a live, shareable dashboard in about ten minutes: connect a source, let Kimo build a model, and ask your first question.

    Oct 5, 2026
    Alerts

    Get notified when a metric crosses a threshold, deviates from normal or goes stale. Conditions, anomaly detection, channels, digests and muting.

REST API

Everything in the app, over HTTPS

Query certified measures, trigger syncs, manage dashboards and wire alerts into your own tools. Official SDKs for JavaScript and Python.

  • POST/v1/queryRun a semantic query
  • POST/v1/askAsk in natural language
  • GET/v1/sourcesList sources & sync status
  • POST/v1/alertsCreate an alert
curl -X POST https://api.getkimo.com/v1/query \  -H "Authorization: Bearer $KIMO_TOKEN" \  -H "Content-Type: application/json" \  -d '{ "model": "subscriptions", "measures": ["mrr"],        "dimensions": ["plan"], "range": "last_6_months" }'
Response · 200 OK · 84 ms
{  "rows": [    { "plan": "Scale", "mrr": 251400 },    { "plan": "Growth", "mrr": 118900 },    { "plan": "Starter", "mrr": 41700 }  ],  "meta": { "measures": [{ "id": "mrr", "certified": true }] }}
Help & community

Stuck? We’ve got you.

Can’t find what you need?

Tell us what’s missing. Docs requests usually ship within two weeks.

Request a guide