Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.predibase.com/llms.txt

Use this file to discover all available pages before exploring further.

The Repositories API provides methods for creating and retrieving adapter repositories, which are used to organize and track your fine-tuning experiments.

​
Create Repository

pb.repos.create(
    name: str,                    # Name for the repository
    description: str = None,      # Description for the repository
    exists_ok: bool = False       # If True, doesn't raise error if exists
) -> Repository
Create a new adapter repository to track your fine-tuning experiments. Parameters
  • name: str - Name for the repository
  • description: str, optional - Description for the repository
  • exists_ok: bool, default False - If True, doesn’t raise an error if the repository already exists
Returns
  • Repository - The created repository object
Example 1: Create a new repository 
# Create a new adapter repository
repo = pb.repos.create(
    name="text-summarization",
    description="Experiments for fine-tuning summarization models"
)
Example 2: Create or get existing repository 
# Create a repository or get it if it already exists
repo = pb.repos.create(
    name="customer-support-bot",
    description="Models for customer support automation",
    exists_ok=True
)

​
Get Repository

pb.repos.get(
    name: str                    # Name of the repository
) -> Repository
Fetch an adapter repository by name. Parameters
  • name: str - Name of the repository
Returns
  • Repository - The requested repository object
Example 
# Get a repository by name
repo = pb.repos.get("text-summarization")

# Print repository details
print(f"Repository: {repo.name}")
print(f"Description: {repo.description}")

​
List Repositories

pb.repos.list(
    limit: int = 10,           # Maximum number of repos to return
) -> list[Repository]
List the last limit repositories.

​
Working with Repository Objects

After you’ve created or retrieved a repository, you can use it to manage adapters. Create an Adapter in a Repository 
from predibase import SFTConfig

# Create a repository
repo = pb.repos.create(name="my-experiments", description="My fine-tuning experiments", exists_ok=True)

# Create an adapter in the repository
adapter = pb.adapters.create(
    config=SFTConfig(
        base_model="qwen3-8b"
    ),
    dataset="my-dataset",
    repo=repo.name,  # Use the repository name
    description="First fine-tuning experiment"
)