Create or join a project

Tutorial · Getting Started

1. 1Project
2. 2Load
3. 3Transform
4. 4Explore
5. 5App
6. 6Flow
7. 7Check

Everything you build lives inside a project: the data you load, the SQL you write, the flow that runs them. This page gets you one.

Before you start

Where you are nothing exists yet.

→

When you finish a project you can sign in to, and you know where its Storage, Jobs and Components live.

You need

• An email address for your Keboola account, or an invite to your company’s Keboola project if it already has one.

No Prompt tab here. Kai works inside a project, so this one page is yours. Every step page after it offers three ways to do the same task.

Choose a way in

Quickest first:

1. Free Plan: sign up and create a free project right now, with up to 60 minutes of job runtime a month. That is enough for this guide; we ran its Prompt path end to end on one.
2. Join an existing project: ask an admin of your company’s Keboola organization to invite you, from Users & Settings → Invite User in the project.
3. Talk to us: for a trial of a full project with a chosen stack and no Free Plan limits, contact Keboola.

The Free Plan’s limits, and what a project and a stack are

The free minutes each month are capped at what the project used the month before (a project that used 30 minutes gets 30 free the next month), and the Free Plan gives you one project and no choice of stack.

Pay As You Go has the full list of limits.

A project is a self-contained workspace with its own data storage, configurations, users and billing. Nothing leaks between projects unless you deliberately share it through the Data Catalog. Each project lives on one stack, a full instance of Keboola in one cloud region. You do not pick one here: Free Plan projects are always created on Google Cloud us-east4, at https://connection.us-east4.gcp.keboola.com. The list of stacks is in the platform overview.

Find your way around

After signing in you land on the project dashboard. Six places matter for this guide:

• Components: every data source connector, data destination connector and application you can add; how data gets in and out.
• Transformations: the code that reshapes your data, in SQL, Python, R or dbt. The Create Transformation dialog lists what this project can run.
• Storage: every table and file, organized into buckets.
• Conditional Flows: what runs, in what order, on what schedule. Older projects may call it Flows.
• Apps: the apps you build and publish.
• Jobs: the log of everything that has run, successfully or not.

What else is in Storage

Its tabs cover Tables & Buckets, Files, Data Streams, Storage Jobs and Events.

Ask Kai to orient you

In Kai Agent (the top bar), on a project you inherit rather than create, the first question is usually (Data Exploration):

Prompt

I'm new to this project. Give me an overview of the data structure and what each bucket contains.

Check it worked

• Storage shows the project’s bucket list. Empty is fine; that is what you are about to change.
• Kai Agent, the button in the project’s top bar, opens a chat panel. A new Free Plan project has it from the start. If it asks you to switch the feature on, an organization admin does it, and anyone else asks them or Support (Get started with Kai). No button means your stack does not offer Kai.
• What Kai does counts against the project, and an organization admin can cap how much it spends; Kai pricing and limits holds the current rules.

On the next pages, the Prompt tab works like this: open Kai Agent, paste the prompt, send it, and approve each change Kai asks about. The app’s prompt is the one exception: it goes into the field on the Apps page. Here it is in a new Free Plan project, with the first prompt of the next page, Load data into Storage:

Not having Kai does not block the build: the loading, the SQL and the flow each carry a UI path and a CLI path in full, and the questions can be asked in SQL in a workspace. Without Kai the app is your own code in a Git repository; its page links where that is covered.

Next: Load data into Storage.

If it goes wrong

The sign-up email never arrives

Check spam, then try again. A half-finished registration does not block a retry with the same address.

You sign in and see no project

You are on the wrong stack, or your invite is still pending. The Login button on keboola.com opens a sign-in page whose stack picker starts on AWS · United States · us-east-1. A Free Plan project is under Google Cloud · United States · us-east4, so pick that one, or open https://connection.us-east4.gcp.keboola.com directly, and sign in with the account you signed up with. For a project you were invited to, confirm the exact URL with whoever invited you.

Your company uses SSO

Sign in through your organization’s link rather than creating a new account; a fresh Free Plan project will not have access to your team’s data.