> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.privategpt.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.privategpt.dev/_mcp/server.

# Local with uv

> Run PrivateGPT locally from source using uv — recommended for development and contributors.

This guide installs PrivateGPT from the cloned repository using [uv](https://docs.astral.sh/uv/), a fast Python package manager. Use this if you want to modify the source, run tests, or use hot-reload during development.

For the simplest install, use the [package install](/installation/package) instead.

---

## Core install

The default source install uses `core`:

```bash
uv sync --frozen --extra core
```

Add feature-specific extras only when you need them, for example `uv sync --frozen --extra core --extra queue`.

---

## Auto mode (zero config)

#### macOS

#### Install uv

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

Restart your shell or run `source ~/.zshrc` after installing.

#### Clone and install

```bash
git clone https://github.com/zylon-ai/private-gpt
cd private-gpt
uv sync --frozen --extra core
```

#### Run

```bash
OPENAI_API_BASE=http://localhost:11434/v1 uv run private-gpt serve
```

Open [http://localhost:8080/ui](http://localhost:8080/ui) in your browser.

#### Linux

#### Install uv

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

Restart your shell or run `source ~/.bashrc` after installing.

#### Clone and install

```bash
git clone https://github.com/zylon-ai/private-gpt
cd private-gpt
uv sync --frozen --extra core
```

#### Run

```bash
OPENAI_API_BASE=http://localhost:11434/v1 uv run private-gpt serve
```

Open [http://localhost:8080/ui](http://localhost:8080/ui) in your browser.

#### Windows (PowerShell)

#### Install uv

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

Restart your PowerShell session after installing.

#### Clone and install

```powershell
git clone https://github.com/zylon-ai/private-gpt
cd private-gpt
uv sync --frozen --extra core
```

#### Run

```powershell
$env:OPENAI_API_BASE = "http://localhost:11434/v1"
uv run python -m private_gpt
```

Open [http://localhost:8080/ui](http://localhost:8080/ui) in your browser.

#### Windows (CMD)

#### Install uv

Download and run the official installer from [astral.sh/uv](https://astral.sh/uv).

#### Clone and install

```cmd
git clone https://github.com/zylon-ai/private-gpt
cd private-gpt
uv sync --frozen --extra core
```

#### Run

```cmd
set OPENAI_API_BASE=http://localhost:11434/v1
uv run python -m private_gpt
```

Open [http://localhost:8080/ui](http://localhost:8080/ui) in your browser.

---

## Detailed model settings (custom profile)

Use [Detailed Model Configuration](/configuration/advanced) to generate `settings-model.yaml`, tune model settings in more detail, and run local `uv` with `PGPT_PROFILES=model`.

---

## Development with hot-reload

When working on the source, run with `--reload` to restart automatically on file changes:

#### macOS / Linux

```bash
OPENAI_API_BASE=http://localhost:11434/v1 \
  PGPT_PROFILES=local \
  uv run private-gpt serve --reload
```

#### Windows

```powershell
$env:OPENAI_API_BASE = "http://localhost:11434/v1"
$env:PGPT_PROFILES = "local"
uv run private-gpt serve --reload
```

Or use the Makefile shortcut (Unix only):

```bash
OPENAI_API_BASE=http://localhost:11434/v1 make dev
```