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

# Installation

This page gets ByGone Spoofer onto your machine. There are two ways to run it: the **pre-built EXE** (easiest) or **from Python source** (for developers).

{% hint style="danger" %}
🎯 Reminder: this tool is for **Roblox only**. It is not built or supported for any other game.
{% endhint %}

## ✅ Requirements

| Requirement              | Details                                                                             |
| ------------------------ | ----------------------------------------------------------------------------------- |
| **OS**                   | Windows 10 or Windows 11 (64-bit)                                                   |
| **Privileges**           | **Administrator** — required for every operation                                    |
| **Python** (source only) | Python 3.8 or newer                                                                 |
| **Internet**             | Needed to download tools and reinstall Roblox                                       |
| **VPN**                  | Strongly recommended — see [Use a VPN](/bygonespoofer-docs/important-guides/vpn.md) |

## 🅰️ Option A — Pre-built EXE (recommended for most users)

1. Go to the [Releases page](https://github.com/nitaybl/ByGoneSpoofer/releases/latest).
2. Download the latest `ByGoneSpoofer.exe`.
3. **Right-click → Run as administrator.**

That's it — skip to [First Run](/bygonespoofer-docs/getting-started/first-run.md).

{% hint style="warning" %}
⚠️ Windows SmartScreen or your antivirus may flag the EXE. This is common for HWID tools because of the low-level registry and driver operations they perform. Only download from the official [GitHub Releases](https://github.com/nitaybl/ByGoneSpoofer/releases) page, and add an exclusion if you trust the source.
{% endhint %}

## 🅱️ Option B — Run from Python source

1. **Install Python 3.8+** from [python.org](https://www.python.org/downloads/) and tick *"Add Python to PATH"* during setup.
2. **Download the source** — clone or download the repo:

   ```bash
   git clone https://github.com/nitaybl/ByGoneSpoofer.git
   cd ByGoneSpoofer
   ```
3. **Install dependencies:**

   ```bash
   pip install -r requirements.txt
   ```

   This installs `colorama`, `requests`, and `pywin32`.
4. **Run as administrator.** Open an **elevated** terminal (right-click Command Prompt → *Run as administrator*), then:

   ```bash
   python ByGoneSpoofer.py
   ```

{% hint style="info" %}
If you launch it without admin rights, the tool automatically tries to relaunch itself through a UAC prompt. Click **Yes** when Windows asks.
{% endhint %}

## 🛠️ Option C — Build your own EXE

If you want to compile the source into a standalone EXE:

```bash
scripts\compile_bygone_spoofer.bat
```

The finished executable lands in the `dist/` folder.

## ➡️ Next

Head to [First Run](/bygonespoofer-docs/getting-started/first-run.md) to see what happens the first time you launch it.


---

# 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://bygonespoofer.gitbook.io/bygonespoofer-docs/getting-started/installation.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.