Installation

Two ways to interact with Basilica: a Python SDK and a CLI. Install one or both.

Python SDK: For programmatic control from your Python applications. CLI: For terminal devotees and shell scripts.

Python SDK

The recommended way to deploy and manage workloads. Write Python, get compute.

Requirements

• Python 3.9 or higher
• pip or uv package manager

Install with pip

pip install basilica-sdk

Install with uv (Recommended)

uv pip install basilica-sdk

Verify Installation

import basilica
print(basilica.__version__)

CLI

A standalone binary for managing rentals and deployments from the terminal. Fast and scriptable.

macOS / Linux

curl -sSL https://basilica.ai/install.sh | bash

This script downloads the latest release and installs it to /usr/local/bin/basilica.

From Source (Cargo)

For those who like to build from source. Useful for unreleased features or contributing to the project.

git clone https://github.com/one-covenant/basilica
cd basilica
cargo build --release -p basilica-cli
# Binary at ./target/release/basilica

Verify CLI Installation

basilica --version

Next Steps

You're in. Now authenticate:

• Authentication: Log in to your account
• Quick Start Guide: Deploy your first application