> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enferno.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Get up and running with Enferno

## Prerequisites

* Python 3.11+
* [uv](https://docs.astral.sh/uv/) (fast Python package manager)

**Optional:**

* Redis (for background tasks with Celery)
* PostgreSQL (SQLite works by default)

## Local Setup

```bash theme={null}
# Install uv
pip install uv  # or: curl -sSf https://astral.sh/uv/install.sh | bash

# Clone and setup
git clone git@github.com:level09/enferno.git
cd enferno
./setup.sh                # Installs deps + generates secure .env
uv run flask create-db    # Setup database
uv run flask install      # Create admin user
uv run flask run          # Start server
```

Visit `http://localhost:5000` to see your application.

## Adding Background Tasks

When you need Celery for async jobs:

```bash theme={null}
uv sync --extra full      # Adds Redis + Celery
# Set REDIS_URL, CELERY_BROKER_URL in .env
```

## Docker Setup

Full production stack with one command:

```bash theme={null}
docker compose up --build
```

Includes Redis, PostgreSQL, Nginx, and Celery.

## Environment Configuration

Key variables in `.env`:

```bash theme={null}
SECRET_KEY=your_secret_key
FLASK_APP=run.py
FLASK_DEBUG=1                    # 0 in production

# PostgreSQL (optional - SQLite works by default)
# SQLALCHEMY_DATABASE_URI=postgresql://user:pass@localhost/dbname

# Background tasks (optional)
# REDIS_URL=redis://localhost:6379/1
# CELERY_BROKER_URL=redis://localhost:6379/2
```

## Next Steps

* [Authentication](/authentication) - User management and OAuth setup
* [Deployment](/deployment) - Production deployment guide
* [Development](/development) - Development guidelines and best practices