> For the complete documentation index, see [llms.txt](https://docs.zer0.build/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zer0.build/getting-started/system-requirements.md).

# System Requirements

Ensure your system meets the requirements for optimal zer0 Browser performance.

***

## 🖥️ Minimum Requirements

To run zer0 Browser, your system must meet these baseline specifications:

| Component            | Requirement                                        |
| -------------------- | -------------------------------------------------- |
| **Operating System** | Windows 10 (64-bit), macOS 10.13+, or Linux 64-bit |
| **Processor**        | Intel Core i3 / AMD Ryzen 3 or equivalent          |
| **Memory (RAM)**     | 4 GB                                               |
| **Storage**          | 500 MB available space                             |
| **Internet**         | Broadband connection                               |
| **Display**          | 1280x720 resolution                                |

{% hint style="warning" %}
**Note:** These are minimum specs. For the best experience with AI agents, see Recommended Requirements below.
{% endhint %}

***

## ⚡ Recommended Requirements

For smooth performance with AI agents and multiple tabs:

| Component            | Requirement                                      |
| -------------------- | ------------------------------------------------ |
| **Operating System** | Windows 11 (64-bit), macOS 12+, or Ubuntu 22.04+ |
| **Processor**        | Intel Core i5 / AMD Ryzen 5 or better (4+ cores) |
| **Memory (RAM)**     | 8 GB or more                                     |
| **Storage**          | 2 GB available space (for agents and cache)      |
| **Internet**         | Stable broadband (5+ Mbps)                       |
| **Display**          | 1920x1080 resolution or higher                   |
| **GPU**              | Dedicated GPU recommended for AI agents          |

***

## 🪟 Windows Requirements

### Supported Versions

| Version                 | Status             | Notes                   |
| ----------------------- | ------------------ | ----------------------- |
| **Windows 11**          | ✅ Fully Supported  | Recommended             |
| **Windows 10 (64-bit)** | ✅ Fully Supported  | Version 1809 or later   |
| **Windows 8.1**         | ⚠️ Limited Support | May work but not tested |
| **Windows 7**           | ❌ Not Supported    | EOL, security risks     |

### Windows-Specific Requirements

**Additional Dependencies:**

* .NET Framework 4.7.2 or later (usually pre-installed)
* Visual C++ Redistributable 2015-2022 (auto-installed with zer0)

**Hardware Considerations:**

* **TPM 2.0** recommended for wallet encryption
* **Secure Boot** compatible
* **Windows Defender** exclusion recommended for Tor components

***

## 🍎 macOS Requirements

### Supported Versions

| Version                    | Status             | Notes           |
| -------------------------- | ------------------ | --------------- |
| **macOS 14 (Sonoma)**      | ✅ Fully Supported  | Latest features |
| **macOS 13 (Ventura)**     | ✅ Fully Supported  | Recommended     |
| **macOS 12 (Monterey)**    | ✅ Fully Supported  | Full support    |
| **macOS 11 (Big Sur)**     | ✅ Supported        | Tested          |
| **macOS 10.15 (Catalina)** | ✅ Supported        | Tested          |
| **macOS 10.13-10.14**      | ⚠️ Limited Support | May work        |
| **macOS 10.12 or older**   | ❌ Not Supported    | Too old         |

### macOS-Specific Requirements

**Processor Architecture:**

* ✅ **Apple Silicon (M1/M2/M3)** - Native support, best performance
* ✅ **Intel x86\_64** - Full support via Rosetta 2 or native

**Additional:**

* **Xcode Command Line Tools** may be required (auto-prompted)
* **Gatekeeper** must allow zer0 (see [Installation Guide](/getting-started/installation.md))

***

## 🐧 Linux Requirements

### Supported Distributions

| Distribution          | Status             | Notes            |
| --------------------- | ------------------ | ---------------- |
| **Ubuntu 22.04+**     | ✅ Fully Supported  | Recommended      |
| **Debian 11+**        | ✅ Fully Supported  | Stable           |
| **Fedora 36+**        | ✅ Supported        | Tested           |
| **Arch Linux**        | ✅ Supported        | Community tested |
| **Linux Mint 21+**    | ✅ Supported        | Ubuntu-based     |
| **Pop!\_OS 22.04+**   | ✅ Supported        | Ubuntu-based     |
| **openSUSE Leap 15+** | ⚠️ Limited Support | May work         |
| **CentOS/RHEL 8+**    | ⚠️ Limited Support | May work         |

### Linux-Specific Requirements

**Dependencies (usually auto-installed):**

```bash
# Debian/Ubuntu
libappindicator3-1
libnotify4
libnss3
libxss1
libxtst6
xdg-utils

# Fedora
libappindicator-gtk3
libnotify
nss
libXScrnSaver
libXtst
```

**Display Server:**

* ✅ **X11** - Fully supported
* ✅ **Wayland** - Fully supported

**Desktop Environments:**

* ✅ GNOME, KDE Plasma, XFCE, Cinnamon, MATE, etc.

***

## 🤖 AI Agent Requirements

AI agents have additional requirements for optimal performance:

### For Basic Agents (Research, Writing)

| Component   | Requirement                        |
| ----------- | ---------------------------------- |
| **RAM**     | 6 GB minimum, 8 GB recommended     |
| **CPU**     | 4+ cores recommended               |
| **Storage** | 1 GB for agent models              |
| **GPU**     | Optional (CPU execution supported) |

### For Advanced Agents (DeFi, Data Analysis)

| Component   | Requirement                        |
| ----------- | ---------------------------------- |
| **RAM**     | 8 GB minimum, 16 GB recommended    |
| **CPU**     | 6+ cores recommended               |
| **Storage** | 2 GB for agent models              |
| **GPU**     | Dedicated GPU strongly recommended |

### Supported GPUs for Acceleration

**NVIDIA:**

* GTX 1060 or better
* CUDA 11.0+ support
* 4 GB VRAM minimum

**AMD:**

* RX 580 or better
* ROCm 4.0+ support
* 4 GB VRAM minimum

**Apple Silicon:**

* M1/M2/M3 (Metal acceleration)
* 8 GB unified memory minimum

{% hint style="info" %}
**GPU acceleration is optional.** AI agents work on CPU-only systems, just slower (2-3x slower for complex tasks).
{% endhint %}

***

## 🌐 Network Requirements

### Bandwidth

| Activity            | Minimum | Recommended |
| ------------------- | ------- | ----------- |
| **Basic Browsing**  | 1 Mbps  | 5 Mbps      |
| **With AI Agents**  | 3 Mbps  | 10 Mbps     |
| **Running Mixnode** | 5 Mbps  | 25 Mbps+    |

### Ports & Protocols

**Required:**

* **HTTPS (443)** - Web browsing
* **Tor (9001, 9030)** - Tor network connection

**Optional (for mixnodes):**

* **Custom port** - Configurable for mixnode operation

### Firewall Considerations

Ensure your firewall allows:

* ✅ Outbound connections on ports 443, 9001, 9030
* ✅ Inbound connections for mixnode (if running one)
* ✅ zer0 Browser application access

***

## 💾 Storage Requirements

### Disk Space Breakdown

| Component                | Size          | Purpose                 |
| ------------------------ | ------------- | ----------------------- |
| **Browser Installation** | 150 MB        | Core application        |
| **Tor Bundle**           | 50 MB         | Tor network components  |
| **AI Agent Models**      | 500 MB - 2 GB | On-device LLMs          |
| **Wallet Data**          | 10-50 MB      | Blockchain sync         |
| **Cache (optional)**     | 100-500 MB    | Temporary browsing data |
| **Total Recommended**    | 2 GB          | Safe buffer             |

### Storage Type

**Recommended:**

* ✅ **SSD** - Much faster agent loading and browsing
* ⚠️ **HDD** - Works but slower, 5400+ RPM recommended

***

## 🔒 Security Requirements

### Hardware Security Features

**Recommended but optional:**

* **TPM 2.0** - Enhanced wallet encryption
* **Secure Enclave** (macOS) - Keychain integration
* **Hardware Security Module** - For enterprise deployments

### Software Security

**Required:**

* ✅ Up-to-date operating system
* ✅ Latest security patches installed

**Recommended:**

* ✅ Antivirus with zer0 whitelisted
* ✅ Firewall properly configured

***

## ⚙️ Performance Benchmarks

Real-world performance on different systems:

### Budget System

```
CPU: Intel i3-10100 / Ryzen 3 3200G
RAM: 4 GB
Storage: HDD

Performance:
- Browser launch: 5-8 seconds
- Tab loading: 2-4 seconds
- Basic agents: 45-60 seconds
- Earning: ✅ Full speed
```

### Mid-Range System

```
CPU: Intel i5-12400 / Ryzen 5 5600X
RAM: 8 GB
Storage: SSD

Performance:
- Browser launch: 2-3 seconds
- Tab loading: 1-2 seconds
- Basic agents: 15-25 seconds
- Advanced agents: 35-50 seconds
- Earning: ✅ Full speed
```

### High-End System

```
CPU: Intel i7-13700K / Ryzen 7 7700X
RAM: 16 GB
GPU: RTX 3060 / RX 6600 XT
Storage: NVMe SSD

Performance:
- Browser launch: 1-2 seconds
- Tab loading: <1 second
- Basic agents: 5-10 seconds
- Advanced agents: 10-20 seconds
- Earning: ✅ Full speed
- Mixnode capable: ✅ Yes
```

***

## 🧪 Compatibility Checker

### Quick Test Commands

**Check your system specifications:**

{% tabs %}
{% tab title="Windows" %}

```powershell
# System info
systeminfo | findstr /B /C:"OS Name" /C:"OS Version" /C:"System Type"

# CPU info
wmic cpu get name

# RAM info
wmic memorychip get capacity

# Disk space
wmic logicaldisk get size,freespace,caption
```

{% endtab %}

{% tab title="macOS" %}

```bash
# System info
sw_vers

# CPU info
sysctl -n machdep.cpu.brand_string

# RAM info
sysctl hw.memsize

# Disk space
df -h
```

{% endtab %}

{% tab title="Linux" %}

```bash
# System info
uname -a
lsb_release -a

# CPU info
lscpu | grep "Model name"

# RAM info
free -h

# Disk space
df -h
```

{% endtab %}
{% endtabs %}

***

## ❓ FAQ

<details>

<summary>Can I run zer0 on a Chromebook?</summary>

**Not officially supported** at this time. Chromebooks with Linux (Crostini) enabled may work, but this is untested. We're exploring Chrome OS support for future releases.

</details>

<details>

<summary>Will zer0 work on ARM processors?</summary>

**Yes!**

* ✅ Apple Silicon (M1/M2/M3) - Native support
* ✅ ARM64 Linux - AppImage available
* ❌ Windows on ARM - Not yet supported

</details>

<details>

<summary>Can I run zer0 on a virtual machine?</summary>

**Yes, but with caveats:**

* Tor may have connectivity issues in some VM configurations
* Performance will be slower
* GPU acceleration unlikely to work
* Not recommended for mixnode operation

</details>

<details>

<summary>My system doesn't meet requirements. Will it work?</summary>

**Possibly, but with limitations:**

* Below 4 GB RAM: May crash with AI agents
* Single-core CPU: Very slow agent execution
* HDD storage: Slower overall experience
* No GPU: CPU-only agent execution (slower)

Try it anyway! The browser itself has low requirements.

</details>

***

## 📊 Performance Tips

**Optimize zer0 on lower-spec systems:**

1. **Disable GPU Acceleration** (if causing issues)
   * Settings → Advanced → Disable hardware acceleration
2. **Limit Concurrent Tabs**
   * Close unused tabs
   * Each tab uses \~50-100 MB RAM
3. **Reduce Agent Usage**
   * Use lightweight agents only
   * Avoid concurrent agent execution
4. **Clear Cache Periodically**
   * Settings → Privacy → Clear browsing data
5. **Upgrade RAM** (best investment)
   * 4 GB → 8 GB makes huge difference
   * Agents will run much faster

***

## 🔄 Upgrade Path

**Thinking of upgrading? Priority order:**

1. **RAM** (4 GB → 8 GB) - Biggest impact for zer0
2. **SSD** - Faster browser/agent loading
3. **CPU** - Better agent performance
4. **GPU** - Optional, helps advanced agents

***

{% hint style="success" %}
**System meets requirements?** Great! Head to the [Installation Guide](/getting-started/installation.md) to get started! 🚀
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.zer0.build/getting-started/system-requirements.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.