Skip to main content

mb.create_branch(name, ...)

Creates a new git branch and switches to it. An exception is raised if the branch already exists, or if the from_branch does not exist.


  • name: str The name of the branch to create. Branch names must be lowercase, start with a letter, and only contain letters, numbers, hyphens, underscores and slashes.
  • from_branch: Optional[str] The name of the branch to use as the base when creating the new branch. If not specified the current branch is used, which is main by default.


Create a new branch


Create a new branch off of old_branch

Using from_branch:

mb.create_branch("my_branch", from_branch="old_branch")

Or similarly, switching to old_branch before creating a new branch:


See also