README.md

---
title: Marketing Text Generator
emoji: 🏆
colorFrom: gray
colorTo: pink
sdk: streamlit
sdk_version: 1.40.2
app_file: app.py
pinned: false
license: apache-2.0
short_description: Interactive Marketing Text Generator
---

## Konfiguration und Abhängigkeiten

Das Projekt nutzt `uv` als modernen Python-Paketmanager. Die Abhängigkeiten werden in einer `requirements.in`-Datei definiert:

```txt
# requirements.in
streamlit>=1.40.2
transformers
python-dotenv
```

## Setup und Verwendung mit `uv`

### Voraussetzungen

Vor dem Start muss `uv` im System verfügbar sein. Installation über pip:

```sh
pip3 install uv
```

### Projekt-Setup

1. **Virtuelle Umgebung erstellen und aktivieren**:

   ```sh
   uv venv --python 3.11
   ```
   
   Umgebung aktivieren:
   
   Unter Linux/macOS

   ```sh
   source .venv/bin/activate
   ```

   Unter Windows
   ```sh
   .venv\Scripts\activate
   ```

2. **Abhängigkeiten installieren**:
   ```sh
   uv pip install -r requirements.in
   ```

   Dieser Befehl installiert alle benötigten Pakete in der virtuellen Umgebung.

### Anwendung starten

Nach erfolgreichem Setup lässt sich die Streamlit-Anwendung wie folgt starten:

```sh
streamlit run app.py
```

<!-->

### Entwicklungshinweise

- **Abhängigkeiten aktualisieren**: Aktualisierung der Abhängigkeiten durch:
  ```sh
  uv pip compile requirements.in -o requirements.txt
  uv pip install -r requirements.txt
  ```

- **Neue Abhängigkeiten hinzufügen**: 
  1. Paket zur `requirements.in` hinzufügen
  2. Compile-Befehl ausführen
  3. Aktualisierte Abhängigkeiten installieren

  -->

### Wichtige Hinweise

- Die erste Ausführung kann mehr Zeit in Anspruch nehmen, da alle Abhängigkeiten heruntergeladen und konfiguriert werden müssen.
- Vor der Textgenerierung sollten alle erforderlichen Formularfelder ausgefüllt sein.
- Der generierte Text sollte vor der Verwendung überprüft und bei Bedarf angepasst werden.

Weitere Informationen zu `uv` finden sich in der [offiziellen Dokumentation](https://github.com/astral-sh/uv).