# System Requirements

BonzAI runs AI models locally on your hardware. The requirements depend on which models you want to use.

## Minimum Requirements

* **OS**: macOS 12+ (Apple Silicon or Intel)
* **RAM**: 8 GB
* **Storage**: 5 GB for app + models (varies by model)
* **Node.js**: v20 LTS (for development builds)
* **Python**: 3.10+ (for ML inference server)

## Recommended for Full Experience

* **RAM**: 16 GB+
* **GPU**: Apple Silicon (M1/M2/M3/M4) with unified memory, or NVIDIA GPU with 6+ GB VRAM
* **Storage**: 50 GB+ (for multiple models)

## Model VRAM Requirements

### LLM Models (via OpenClaw)

| Model            | Size   | VRAM Required |
| ---------------- | ------ | ------------- |
| DeepSeek R1 1.5B | 1.1 GB | 2 GB          |
| Gemma 3 1B       | 0.8 GB | 2 GB          |
| Phi-3 Mini       | 2.4 GB | 4 GB          |
| Phi-4 Mini       | 2.5 GB | 4 GB          |
| Qwen 2.5 3B      | 2 GB   | 4 GB          |
| LLaMA 2 7B       | 4 GB   | 6 GB          |
| LLaMA 3.1 8B     | 5 GB   | 6 GB          |
| Mistral 7B       | 4.4 GB | 6 GB          |
| DeepSeek R1 7B   | 4.7 GB | 6 GB          |
| GLM-4 7B Flash   | 4.7 GB | 6 GB          |
| Qwen Coder 7B    | 4.7 GB | 6 GB          |
| Yi Coder 9B      | 5.5 GB | 8 GB          |
| MythoMax 13B     | 7.9 GB | 10 GB         |
| Hermes 4 14B     | 9 GB   | 10 GB         |
| Qwen Coder 14B   | 9 GB   | 12 GB         |
| Codestral 22B    | 13 GB  | 16 GB         |
| GPT-OSS 20B      | 12 GB  | 14 GB         |
| DeepSeek R1 32B  | 19 GB  | 24 GB         |
| Qwen Coder 32B   | 19 GB  | 24 GB         |
| Qwen3 Coder 30B  | 18 GB  | 24 GB         |

### Image, Audio, Video Pipelines (via Flask)

| Pipeline                  | Approx. VRAM |
| ------------------------- | ------------ |
| Image Turbo (FLUX Klein)  | 8 GB         |
| Image Standard (SDXL)     | 6 GB         |
| Image Quality (FLUX Krea) | 12 GB        |
| Image Advanced (Z-Image)  | 8 GB         |
| Audio Turbo (Kokoro TTS)  | 2 GB         |
| Audio Quality (Qwen3-TTS) | 4 GB         |
| Music (ACE-Step)          | 6 GB         |
| Video (LTX-2)             | 10 GB        |
| Vision (Qwen3-VL)         | 6 GB         |

## Port Configuration

BonzAI uses the following local ports:

| Service          | Port  | Environment Variable |
| ---------------- | ----- | -------------------- |
| Flask ML Server  | 65000 | `BONZAI_SERVER_PORT` |
| OpenClaw LLM     | 3002  | `OPENCLAW_API_PORT`  |
| OpenClaw Gateway | 18789 | —                    |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bonzai.sh/getting-started/system-requirements.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.