> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blackbox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started

Follow these simple steps to get up and running with the BLACKBOX AI Desktop App.

### 1. Download

Visit the official website [blackbox.ai](https://app.blackbox.ai/) and get the installer for your operating system or use the direct download links below based on your platform..

<div style={{ display: 'flex', justifyContent: 'center', gap: '40px', margin: '30px 0', flexWrap: 'wrap' }}>
  <a href="https://storage.googleapis.com/workspace-0f70711f-8b4e-4d94-86f1-2a93ccde5887/BLACKBOXAI-Agent-install-arm64-v1.2.4.dmg" className="download-button text-white">
    <Icon icon="apple" size="20" color="#fff" />

    Apple Silicon
  </a>

  <a href="https://storage.googleapis.com/workspace-0f70711f-8b4e-4d94-86f1-2a93ccde5887/BLACKBOXAI-Agent-install-x64-v1.2.3.dmg" className="download-button text-white">
    <Icon icon="apple" size="20" color="#fff" />

    Apple Intel Chip
  </a>

  <a href="https://storage.googleapis.com/workspace-0f70711f-8b4e-4d94-86f1-2a93ccde5887/BLACKBOXAI-Agent-install-win32-v1.2.4.exe" className="download-button text-white">
    <Icon icon="windows" size="20" color="#fff" />

    Windows
  </a>
</div>

<img src="https://mintcdn.com/blackboxai-3b9e98f8/NblK4XteAom4_6bn/images/desktop-app/desktop_app-download-button.png?fit=max&auto=format&n=NblK4XteAom4_6bn&q=85&s=96cc1f214decb3004d424d6de10185c3" alt="Download Button" width="636" height="1022" data-path="images/desktop-app/desktop_app-download-button.png" />

**Supported Platforms:**

* Windows 10/11 (64-bit)
* macOS 10.15+ (Intel and Apple Silicon)
* Linux distributions (Ubuntu, Fedora, Debian, etc.)

### 2. Install

Run the installer and follow the on-screen instructions:

**Windows:**

1. Double-click the `.exe` installer
2. Follow the installation wizard
3. Choose installation directory (optional)
4. Complete the installation

**macOS:**

1. Open the `.dmg` file
2. Drag BLACKBOX AI to the Applications folder
   <img src="https://mintcdn.com/blackboxai-3b9e98f8/NblK4XteAom4_6bn/images/desktop-app/desktop_app-drag-drop-to-applications.png?fit=max&auto=format&n=NblK4XteAom4_6bn&q=85&s=ed03271ad2edb3defd95cbf49366771c" alt="Drag and Drop" width="1024" height="784" data-path="images/desktop-app/desktop_app-drag-drop-to-applications.png" />
3. Launch from Applications

**Linux:**

1. Install using your package manager
2. Or run the AppImage directly
3. Or use the provided `.deb`/`.rpm` packages

### 3. Launch & Sign In

1. Open the BLACKBOX AI app from your applications folder
2. Log in with your existing BLACKBOX AI account
3. If you don't have an account, create one for free

<img src="https://mintcdn.com/blackboxai-3b9e98f8/aaZ8826iyH7kvPCe/images/desktop-app/desktop_app-Home.jpeg?fit=max&auto=format&n=aaZ8826iyH7kvPCe&q=85&s=d69df370b10dd81710c55855da116770" alt="Desktop App Home Screen" width="2048" height="1153" data-path="images/desktop-app/desktop_app-Home.jpeg" />

### 4. Start Working

Automate your daily tasks and workflows with the full power of BLACKBOX AI. Whether you're managing files, organizing documents, or working on projects, BlackBox is ready to help.

**Ways to start:**

* **Open Folder:** Connect to any folder to manage files and documents
* **New Project:** Create fresh projects for any type of work
* **Add Extensions:** Enhance capabilities with additional tools and integrations
* **Start Chatting:** Simply describe what you want to accomplish in plain language.

### Chat and Code Assistance

<img src="https://mintcdn.com/blackboxai-3b9e98f8/NblK4XteAom4_6bn/images/desktop-app/desktop_app-chat-features.png?fit=max&auto=format&n=NblK4XteAom4_6bn&q=85&s=6c41a6cce392146943ca7b6edeb9d412" alt="Chat Features" width="2546" height="212" data-path="images/desktop-app/desktop_app-chat-features.png" />