# Quick Start

## Prerequisites

- Python 3.12+
- `uv` (required)

## Option 1: Windows bootstrap script (Recommended)

From PowerShell in the repo root:

```powershell
.\START_HERE.ps1
```

This script handles everything:

- Checks for `uv` and Python versions
- Syncs dependencies
- Discovers local models (Ollama/LM Studio)
- Starts the Grinta terminal CLI

## Option 2: Manual start

### 1) Sync dependencies and create local settings

```powershell
uv sync
uv run python -m backend.cli.entry init
```

### 2) Start the CLI

```powershell
uv run python -m backend.cli.entry
```

This is the canonical local startup path.

## Common issues

### uv not found

Install `uv` via the official installer:

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

### Locally hosted models

Ensure **Ollama** or **LM Studio** is running. Grinta auto-discovers them on startup.

### Port already in use

For the CLI itself, this usually points to another local tool, not Grinta.
