# Kom igång

Den här guiden hjälper dig att installera allt som behövs för att köra LrPy på din dator.

## 1. Installera uv

`uv` är ett verktyg som hanterar Python och alla paket som projektet behöver. Du behöver bara installera det en gång.

Öppna en terminal och kör följande kommando:

**Linux / macOS:**

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

**Windows (PowerShell):**

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

Stäng och öppna terminalen efter installationen så att kommandot `uv` blir tillgängligt.

Du kan kontrollera att installationen lyckades genom att köra:

```bash
uv --version
```

Om ett versionsnummer skrivs ut är allt klart.

## 2. Klona projektet

Om du inte redan har projektets kod på din dator, klona det från Git:

```bash
git clone <projektets-url>
cd LrPy
```

Byt ut `<projektets-url>` mot den faktiska adressen till projektet.

## 3. Skapa en virtuell miljö och installera beroenden

En virtuell miljö är en isolerad Python-installation som inte påverkar resten av din dator. `uv sync` skapar den automatiskt och installerar alla paket som projektet behöver.

Kör följande i projektmappen:

```bash
uv sync
```

Det här kommandot gör tre saker åt dig:

1. Laddar ned rätt version av Python (om den saknas).
2. Skapar en virtuell miljö i mappen `.venv`.
3. Installerar alla paket som projektet behöver.

## 4. Köra programmet

LrPy startas med en konfigurationsfil (en `.yaml`-fil) som beskriver vilka moduler som ska köras.

Kör följande kommando:

```bash
uv run python -m lrpy run test.yaml
```

Förklaring av kommandot:

- **`uv run`** — ser till att den virtuella miljön används.
- **`python -m lrpy`** — startar LrPy.
- **`run test.yaml`** — anger att programmet ska köras med konfigurationsfilen `test.yaml`.

Programmet fortsätter köra tills du stoppar det med `Ctrl+C`.

## Vanliga problem

### `uv: command not found`

Terminalen hittar inte `uv`. Prova att stänga och öppna terminalen igen. Om det fortfarande inte fungerar, kontrollera att installationen i steg 1 gick igenom utan fel.

### `No such file or directory: test.yaml`

Du står troligtvis i fel mapp. Se till att du befinner dig i projektmappen (`LrPy`) innan du kör kommandot.