Initial clean commit

DEPLOY.md

@@ -0,0 +1,54 @@
+# Deployment Guide
+
+This guide describes how to deploy the application to a new server.
+
+## Prerequisites
+
+*   **Linux Server** (Ubuntu 22.04+ recommended)
+*   **NVIDIA GPU**: Required for translation, embeddings, and NER services.
+*   **NVIDIA Container Toolkit**: Must be installed to allow Docker to access the GPU.
+*   **Docker** & **Docker Compose**: Latest versions.
+*   **Git**: To clone the repository.
+*   **External Service**: An instance of [AllTalk](https://github.com/erew123/alltalk_tts) running externally or on the host (port 7851 by default).
+
+## Deployment Steps
+
+1.  **Clone the Repository**
+    ```bash
+    git clone <your-repo-url>
+    cd <your-repo-name>
+    ```
+
+2.  **Configure Environment Variables**
+    Copy the example configuration file:
+    ```bash
+    cp .env.example .env
+    ```
+    Edit `.env` and set secure passwords and configuration:
+    ```bash
+    nano .env
+    ```
+    *   Change `POSTGRES_PASSWORD` and `DB_PASS` to a strong unique password.
+    *   Change `SECRET_KEY` to a long random string.
+    *   Verify `ALLTALK_URL` points to your AllTalk instance (default assumes host machine access).
+
+3.  **Start the Services**
+    Run the following command to build and start the application:
+    ```bash
+    docker compose up -d --build
+    ```
+
+4.  **Database Initialization**
+    The database will automatically initialize on the first run using the scripts in `init-db/`. This may take a few minutes. Check logs with:
+    ```bash
+    docker compose logs -f db
+    ```
+
+5.  **Verify Deployment**
+    Access the application at `http://<your-server-ip>:8001`.
+
+## Important Notes
+
+*   **Models**: The application mounts `./models` and `./hf_cache` to persist AI models. On the first run, it will attempt to download necessary models (NLLB, BERT, etc.), which requires significant bandwidth and time.
+*   **Data Persistence**: Database data is stored in `./pgdata` (mapped in docker-compose). Ensure this directory is backed up.
+*   **Security**: Ensure port 5432 (Postgres) and 6379 (Redis) are firewall-protected and not exposed to the public internet unless intended (Docker maps them to the host network).