Ask your data anything.
Get answers in plain language.

What to prepare

• Company name and contact email - how we reach you and label your data.
• Database type - PostgreSQL, MySQL / MariaDB, SQL Server or SQLite.
• Your views and columns - each table you want answerable, and each column with a short description.
• Nothing else - no database credentials, no data exports, no firewall openings.

Column descriptions are what make answers accurate: "salary - annual salary in USD" beats "salary".

curl -X POST {API_BASE}/api/v1/onboard \
  -H "Content-Type: application/json" \
  -H "X-Onboard-Secret: your-onboard-secret" \
  -d '{
    "company_name": "Acme Corp",
    "contact_email": "admin@acmecorp.com",
    "database_type": "postgresql",
    "views": [
      {
        "view_name": "employees",
        "columns": [
          { "name": "employee_id", "type": "integer",
            "description": "Unique employee identifier" },
          { "name": "department", "type": "varchar",
            "description": "Department (IT, Sales, HR...)" }
        ]
      }
    ]
  }'

The response contains your api_key (format comp_...) and a jwt_secret - save both immediately, they are shown once.

from fourbot import FouribotClient

client = FouribotClient(
    api_key="comp_your_api_key",
    db_type="postgresql",
    db_config={
        "host": "db.yourcompany.com",
        "port": 5432,
        "database": "company_db",
        "user": "readonly_user",
        "password": "your_password",
    },
)

result = client.ask("How many employees do we have?")
print(result.friendly_response)  # "You have 30 employees in total."

const { FouribotClient } = require("4ibot-sdk");

const client = new FouribotClient({
  apiKey: "comp_your_api_key",
  dbType: "postgresql",
  dbConfig: {
    host: "db.yourcompany.com",
    port: 5432,
    database: "company_db",
    user: "readonly_user",
    password: "your_password",
  },
});

const result = await client.ask("How many employees do we have?");
console.log(result.friendlyResponse); // "You have 30 employees in total."