Skip to main content

Get started in 30 seconds

Prerequisites:
  • A terminal (Command Prompt, PowerShell, or Bash)
  • A BLACKBOX AI account to login.
For Unix/Linux/macOS (Bash)
curl -fsSL https://blackbox.ai/install.sh | bash
For Windows (PowerShell)
Invoke-WebRequest -Uri "https://blackbox.ai/install.ps1" -OutFile "install.ps1"; .\install.ps1
If you get an execution policy error on Windows
To fix this, run the following command first in the same PowerShell session:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
Then re-run the install command:
Invoke-WebRequest -Uri "https://blackbox.ai/install.ps1" -OutFile "install.ps1"; .\install.ps1
Configuring BlackBox CLI
Once the BLACKBOX CLI is installed user has to configure it before the first use. You can also use the configure command to set up your providers at any time:
blackbox configure
# You'll be prompted to configure providers and enter your API key on first use
Select Configuration
Select the configuration that you wish to change. For the initial setup, select Configure Providers. Screenshot 2025-10-22 at 22.43.51.png
Choose Model Provider
Select your preferred AI model provider from the available options. BLACKBOX CLI supports multiple providers to give you flexibility.
Enter API Key
Provide your BLACKBOX API key when prompted. You can get your API key from the BLACKBOX Dashboard.
  • Navigate to your dashboard
  • Copy your API key
  • Paste it in the terminal when prompted
Select Your Model
Choose the specific AI model you want to use from your chosen provider. You can select from the best closed-source or open-source models available. Look at the full list of BLACKBOX AI supported models Here.
You can reconfigure your settings at any time by running blackbox configure again.
Start Using BLACKBOX CLI
# Configure and start
blackbox
# You'll be prompted to configure providers and enter your API key on first use
That’s it! You’re ready to start coding with BLACKBOX CLI. Continue with Getting Started

What BLACKBOX CLI does for you

  • Natural Language Coding: Describe what you want to build in plain English. BLACKBOX CLI will make a plan, write the code, and ensure it works.
  • Complete Project Management: Create, organize, search, and manage files effortlessly through intelligent AI guidance.
  • Smart Debugging: Detect errors, run commands, and iterate through debugging cycles autonomously with real-time feedback.
  • Automated Setup: Handle project initialization, dependency installation, and environment configuration automatically.
  • File Operations: Create, modify, and organize files through AI guidance with batch operations support.
  • Build & Deployment: Automate compilation, bundling, packaging, and CI/CD pipeline setup.

Next steps

Additional resources