# Installation

> Setup guide for ML Bridge

Category: BRIDGE · Source: https://miciomods.it/docs/ml-bridge-installation · Last updated: 2026-07-23

## Overview

Universal abstraction layer for the ML Series. `ml_bridge` auto-detects your framework, inventory, target system, and 9 other subsystems, exposing a single unified API for all ML scripts. It also provides a multi-provider logging engine and a DUI-based 3D waypoints system.

## Quick Start

1. Download from [CFX Portal](https://portal.cfx.re)
2. Extract to your `resources` folder as `ml_bridge`
3. Add to `server.cfg`:

**server.cfg**

```cfg
ensure ox_lib
ensure ml_bridge
```

> **WARNING:** Load Order
>
> `ml_bridge` must start BEFORE any `ml_*` script that depends on it.

## Database

> **INFO:** No Database
>
> `ml_bridge` does not create any database tables. It is a stateless abstraction layer.

## Verify

After starting, the console will print:

```lua
[ml_bridge] Detection Results:
  Framework: qbox
  Inventory: ox
  Target: ox
  Notify: ox
  ...
[ml_bridge] Server bridge ready
```

Each detected system is printed with its resolved provider. If `Config.Debug = true`, additional debug output is shown.

**Troubleshooting**

- Script not starting. Ensure `ox_lib` is loaded before `ml_bridge`.
- Detection shows `unknown`: The target resource is not started. Check your ensure order.
- ML scripts fail to load, `ml_bridge` must be ensured before any `ml_*` script.