View as Markdown

Predictabl docs

Predictabl turns a question about your data into a trained, tested model, and serves its predictions. You bring tables (files or a database) and a question in plain words, like "Which customers will stop buying in the next 30 days?". Predictabl reads the tables, writes the features as SQL you can review, keeps out columns that would leak the answer, trains and tests the model, and scores new data with it.

You can do all of it from the web app, from Python, from any language over REST, or from an AI agent over MCP. Everything you build from code also shows up in the web app.

The fastest start

pip install predictabl
export PREDICTABL_API_KEY=pk_...   # Settings → API & MCP → Create token
import predictabl as pb

data = pb.connect("customers.csv")      # a file, a DataFrame, or a database
churn_model = data.predict("Which customers will churn?")

churn_model.predict(customer)
Probability that customer churned: 0.82

That is the whole path: connect your data, ask, get a tested model, predict. The Quickstart walks through it with real output.

Four objects

Object What it is You get it from
Data Your database or files pb.connect(), pb.datasets()
Plan What Predictabl will predict, with which features, and what it excluded data.plan(question)
Model A trained, tested model data.predict(question), plan.train()
Predictions Scores, with what they mean and the date they are for model.predict()

Where to go next

I want to… Read
Build my first model in five minutes Quickstart
Get an API key and understand what it can reach Authentication
Control the plan before training Build a model
Score new data with a trained model Make predictions
Let Claude, Cursor or another agent use my models AI agents and MCP
Call the API from another language REST API
Look up a method or parameter Python reference
Understand an error or a limit Errors and limits

For AI agents

Every page is also plain Markdown: add .md to its address (this page is /docs/index.md). The whole documentation as one file is /docs/llms-full.txt; the index is /docs/llms.txt.