asd

README.md

@@ -1 +1,115 @@
-запускай давай пробуй 
+# Trans for Doctors - Установка и использование
+
+## Быстрый старт
+
+### 1. Установка с помощью UV (рекомендуется)
+
+#### Предварительные требования:
+- Python 3.8+
+- Git
+
+#### Шаги установки:
+
+1. **Установите `uv` (если еще не установлен)**
+   ```bash
+   # На macOS/Linux
+   curl -LsSf https://astral.sh/uv/install.sh | sh
+   
+   # На Windows (PowerShell)
+   powershell -ExecutionPolicy BypassUser -c "irm https://astral.sh/uv/install.ps1 | iex"
+   ```
+
+2. **Клонируйте репозиторий**
+   ```bash
+   git clone <ваш-репозиторий>
+   cd Trans_for_doctors
+   ```
+
+3. **Создайте виртуальное окружение и установите зависимости**
+   ```bash
+   uv venv
+   source .venv/bin/activate  # На Windows: .venv\Scripts\activate
+   uv pip install -r requirements.txt
+   ```
+
+### 2. Скачивание моделей с Hugging Face
+
+#### Вариант A: Автоматическое скачивание (встроено в скрипт)
+Скрипт `run_demo.py` автоматически скачает необходимые модели с Hugging Face при первом запуске.
+
+#### Вариант B: Ручное скачивание
+
+1. **Установите `huggingface-hub`**
+   ```bash
+   uv pip install huggingface-hub
+   ```
+
+2. **Скачайте модель для текстового трансляра**
+   ```bash
+   huggingface-cli download <модель-название> --local-dir ./models/translator
+   ```
+
+3. **Скачайте модель для распознавания речи (Whisper)**
+   ```bash
+   huggingface-cli download openai/whisper-base --local-dir ./models/whisper
+   ```
+
+### 3. Запуск проекта
+
+```bash
+# Убедитесь, что виртуальное окружение активно
+source .venv/bin/activate  # На Windows: .venv\Scripts\activate
+
+# Запустите демо
+uv run python run_demo.py
+```
+
+## Структура проекта
+
+- `run_demo.py` - основной скрипт для запуска
+- `requirements.txt` - зависимости проекта
+- Папка `models/` - где хранятся скачанные модели (создается автоматически)
+- Конфигурационные файлы (`config.json`, `generation_config.json` и т.д.)
+- `medical_terms.txt` - медицинская терминология
+- `vocab.json`, `merges.txt` - файлы токенайзера
+
+## Необходимые пакеты
+
+- **transformers** - работа с трансформер моделями
+- **accelerate** - оптимизация при работе с GPU
+- **librosa** - обработка аудио
+- **soundfile** - сохранение аудио файлов
+- **huggingface_hub** - скачивание моделей с Hugging Face
+- **numpy** - численные вычисления
+
+## Альтернатива: PIP вместо UV
+
+Если вы предпочитаете использовать стандартный pip:
+
+```bash
+python -m venv venv
+source venv/bin/activate  # На Windows: venv\Scripts\activate
+pip install -r requirements.txt
+python run_demo.py
+```
+
+## Решение проблем
+
+### Проблема: "Model not found on Hugging Face"
+**Решение:** Проверьте интернет соединение и убедитесь, что вы вошли в свой аккаунт:
+```bash
+huggingface-cli login
+```
+
+### Проблема: "CUDA out of memory"
+**Решение:** Используйте CPU вместо GPU или снизьте размер batch:
+```bash
+export CUDA_VISIBLE_DEVICES=""  # Принудительно использовать CPU
+python run_demo.py
+```
+
+### Проблема: "Нет прав для записи в папку models"
+**Решение:** Убедитесь, что у вас есть права на запись в текущую директорию
+```bash
+chmod -R 755 ./
+```