# Local Development Setup

> Comprehensive guide for setting up and running Opik locally for development

This guide provides detailed instructions for setting up your local Opik development environment. We offer multiple development modes optimized for different workflows.

## Quick Start

Choose the approach that best fits your development needs:

| Development Mode       | Use Case                                  | Command                                   | Speed  |
| ---------------------- | ----------------------------------------- | ----------------------------------------- | ------ |
| **Docker Mode**        | Testing full stack, closest to production | `./opik.sh --build`                       | Slow   |
| **Local Process Mode** | Fast BE + FE development                  | `scripts/dev-runner.sh`                   | Fast   |
| **BE-Only Mode**       | Backend development only                  | `scripts/dev-runner.sh --be-only-restart` | Fast   |
| **Infrastructure**     | Manual with IDE development               | `./opik.sh --infra --port-mapping`        | Medium |

## Prerequisites

### Required Tools

* **Docker** and **Docker Compose** - For running infrastructure services
* **Java 21** and **Maven** - For backend development
* **Node.js 18+** and **npm** - For frontend development
* **Python 3.8+** and **pip** - For SDK development

### Verify Installation

```bash