Getting Started

Setup Checklist

Understand the readiness checks Bilbis uses before pipelines can run.

What this means

The setup checklist tells you whether an organization is ready to dispatch pipelines.

Bilbis uses the same readiness checks on the dashboard, in the welcome flow, and on the New Pipeline form. If any required item is missing, pipeline creation can be blocked because Bilbis would not have enough access or configuration to complete the work.

Checklist items

Checklist itemWhat it meansWhy it matters
Add an LLM providerAdd an Anthropic or OpenAI credential.The agents need an AI provider to plan and write code.
Connect a Git providerAdd a GitLab, GitHub, or GitHub App credential.Bilbis needs repo access to clone, push, and open MRs/PRs.
Create a productCreate at least one product.Products group repositories and shared pipeline settings.
Add a repositoryAdd at least one repo under a product.Pipelines need a target codebase.

The checklist is considered ready only when all four items are complete.

Where you see it

You may see the checklist in three places:

PlaceWhat it does
Welcome flowGuides a new organization through setup one step at a time.
DashboardShows setup readiness and points admins to the missing step.
New Pipeline formBlocks pipeline creation until the required setup exists.

Before you start

You usually need owner or admin access to complete checklist items because they change organization-wide credentials and configuration.

Developers or viewers may see that setup is incomplete, but they may not have permission to fix every missing item.

Steps

  1. Add an LLM provider in Settings -> Integrations.
  2. Add a Git provider in Settings -> Integrations.
  3. Create a product from Products.
  4. Add a repository inside that product.
  5. Return to Pipelines -> New pipeline.

How Bilbis decides each item is done

ItemDone when
LLM providerThe organization has an Anthropic or OpenAI credential.
Git providerThe organization has a GitLab, GitHub, or GitHub App credential.
ProductThe organization has at least one product.
RepositoryThe organization has at least one repository.

Problems and fixes

ProblemWhat to check
Checklist still says LLM provider is missingConfirm the credential provider is Anthropic or OpenAI.
Checklist still says Git provider is missingConfirm the credential provider is GitLab, GitHub, or GitHub App.
Product is complete but repo is still missingOpen the product and add a repository. A product alone is not enough.
User cannot complete a checklist itemCheck their role. Owner or admin access is usually required.
New Pipeline form stays blocked after setupRefresh the page and confirm the saved credential, product, and repo are visible in their pages.

On this page