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.