# Pierwsze kroki

Witaj w BentoPDF! Ten przewodnik pomoże Ci szybko zacząć.

## Czym jest BentoPDF?

BentoPDF to darmowy zestaw narzędzi PDF o otwartym kodzie, stworzony z myślą o prywatności, który działa **w całości w przeglądarce**. Twoje pliki nigdy nie opuszczają urządzenia: całe przetwarzanie odbywa się lokalnie dzięki technologii WebAssembly (WASM).

## Szybki start

### Opcja 1: Użyj wersji hostowanej

Odwiedź [bentopdf.com](https://www.bentopdf.com), aby od razu korzystać z BentoPDF, bez instalacji.

### Opcja 2: Samodzielny hosting z Dockerem

> [!IMPORTANT]
> Konwersja plików Office wymaga `SharedArrayBuffer`, a do tego potrzebne są oba nagłówki:
>
> - `Cross-Origin-Opener-Policy: same-origin`
> - `Cross-Origin-Embedder-Policy: require-corp`
> - bezpieczny kontekst
>
> `http://localhost` działa do testów lokalnych, ponieważ przeglądarki traktują adres pętli zwrotnej jako zaufany. `http://192.168.x.x` i inne adresy LAN zwykle nie są traktowane jako zaufane, więc konwersje Word/Excel/PowerPoint będą wymagały HTTPS przy dostępie z innych urządzeń w sieci.

```bash
# Pull and run the Docker image (self-hosted build)
docker run -d -p 3000:8080 ghcr.io/alam00000/bentopdf-simple:latest

# Or use Docker Compose
curl -O https://raw.githubusercontent.com/alam00000/bentopdf/main/docker-compose.yml
docker compose up -d
```

> [!TIP]
> BentoPDF jest dostępny w dwóch wersjach: **wersja do samodzielnego hostingu** (`bentopdf-simple`, użyta powyżej) do wdrożeń wewnętrznych, zespołowych i organizacyjnych oraz **wersja komercyjna** (`bentopdf:latest`), używana przez samo bentopdf.com i przez posiadaczy licencji komercyjnej z publicznymi wdrożeniami. Obie zawierają te same narzędzia PDF, a wersja komercyjna dodaje sekcję hero, FAQ, opinie i stopkę z bentopdf.com. W razie wątpliwości użyj wersji do samodzielnego hostingu.

Następnie otwórz `http://localhost:3000` w przeglądarce.

> [!NOTE]
> Jeśli przygotowujesz wdrożenie OCR w środowisku odciętym od sieci (air-gapped), oprócz workera Tesseract, środowiska uruchomieniowego i plików traineddata musisz hostować wewnętrznie także czcionki warstwy tekstowej OCR. Pełna konfiguracja jest opisana w [Samodzielny hosting](/pl/self-hosting/), wraz z `VITE_OCR_FONT_BASE_URL` i dołączonym katalogiem `ocr-fonts/`.

### Opcja 3: Zbuduj ze źródeł

```bash
# Clone the repository
git clone https://github.com/alam00000/bentopdf.git
cd bentopdf

# Install dependencies
npm install

# Start development server
npm run dev
```

## Funkcje w skrócie

| Kategoria              | Narzędzia                                                                           |
| ---------------------- | ----------------------------------------------------------------------------------- |
| **Konwersja do PDF**   | Word, Excel, PowerPoint, obrazy, Markdown, EPUB, MOBI i więcej                      |
| **Konwersja z PDF**    | JPG, PNG, tekst, Excel, SVG i więcej                                                |
| **Edycja i adnotacje** | Podpisywanie, zakreślanie, redagowanie, wypełnianie formularzy, dodawanie pieczątek |
| **Organizacja**        | Łączenie, dzielenie, obracanie, usuwanie stron, zmiana kolejności                   |
| **Optymalizacja**      | Kompresja, naprawa, spłaszczanie, OCR                                               |
| **Bezpieczeństwo**     | Szyfrowanie, odszyfrowywanie, usuwanie ograniczeń                                   |

## Obsługiwane przeglądarki

BentoPDF działa najlepiej w nowoczesnych przeglądarkach:

- ✅ Chrome/Edge 90+
- ✅ Firefox 90+
- ✅ Safari 15+

## Dalsze kroki

- [Poznaj wszystkie narzędzia](/pl/tools/)
- [Hostuj BentoPDF samodzielnie](/pl/self-hosting/)
- [Współtwórz projekt](/pl/contributing)