README.md

---
title: RAQIM رقيم
emoji: 📄
colorFrom: yellow
colorTo: red
sdk: docker
pinned: false
app_port: 7860
---

# رقيم — RAQIM

Arabic-first document-to-Markdown conversion platform.

Upload PDFs, Word documents, images, spreadsheets and more — the engine extracts, structures, and converts them to clean Markdown with full RTL Arabic support.

## Features

- PDF conversion with page-range selection
- Word (DOCX), Excel, PowerPoint, HTML, EPUB support
- OCR for scanned images (Arabic + English)
- Folder organization, file sharing, trash management
- JWT authentication with admin panel

## Environment Variables

Set these in your Space **Settings → Variables and secrets**:

| Variable | Description |
|---|---|
| `JWT_SECRET` | Random 64-char secret for signing tokens (`openssl rand -hex 32`) |
| `SESSION_SECRET` | Random 64-char secret for sessions (`openssl rand -hex 32`) |
| `HF_TOKEN` | Your HF write token — enables DB backup to a private HF Dataset |
| `HF_USERNAME` | Your HF username — used for DB backup dataset name |
| `ADMIN_EMAIL` | Override default admin email (default: `admin@raqim.app`) |
| `ADMIN_PASSWORD` | Override default admin password (default: `Admin1234!`) |

> **Note:** The database is SQLite stored at `/data/raqim.db`. No external database service required.