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 item | What it means | Why it matters |
|---|---|---|
| Add an LLM provider | Add an Anthropic or OpenAI credential. | The agents need an AI provider to plan and write code. |
| Connect a Git provider | Add a GitLab, GitHub, or GitHub App credential. | Bilbis needs repo access to clone, push, and open MRs/PRs. |
| Create a product | Create at least one product. | Products group repositories and shared pipeline settings. |
| Add a repository | Add 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:
| Place | What it does |
|---|---|
| Welcome flow | Guides a new organization through setup one step at a time. |
| Dashboard | Shows setup readiness and points admins to the missing step. |
| New Pipeline form | Blocks 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
- Add an LLM provider in Settings -> Integrations.
- Add a Git provider in Settings -> Integrations.
- Create a product from Products.
- Add a repository inside that product.
- Return to Pipelines -> New pipeline.
How Bilbis decides each item is done
| Item | Done when |
|---|---|
| LLM provider | The organization has an Anthropic or OpenAI credential. |
| Git provider | The organization has a GitLab, GitHub, or GitHub App credential. |
| Product | The organization has at least one product. |
| Repository | The organization has at least one repository. |
Problems and fixes
| Problem | What to check |
|---|---|
| Checklist still says LLM provider is missing | Confirm the credential provider is Anthropic or OpenAI. |
| Checklist still says Git provider is missing | Confirm the credential provider is GitLab, GitHub, or GitHub App. |
| Product is complete but repo is still missing | Open the product and add a repository. A product alone is not enough. |
| User cannot complete a checklist item | Check their role. Owner or admin access is usually required. |
| New Pipeline form stays blocked after setup | Refresh the page and confirm the saved credential, product, and repo are visible in their pages. |