---
title: Sheetly
emoji: 📑
colorFrom: green
colorTo: gray
sdk: docker
pinned: false
app_port: 7860
---

# Sheetly

Document intelligence: turn invoices, contracts, and delivery
notes into **structured Excel / JSON** with confidence review.

## How to use

1. Open **Upload** — demo fixtures are seeded on first launch.
2. Review fields on **Validate** (source + confidence scores).
3. Export from **Dashboard** (Excel / CSV / JSON).

You can also upload your own PDF, PNG, JPG, or ZIP batches.

## Space secrets

In **Settings → Variables and secrets**, set:

| Name | Value |
|------|--------|
| `OPENAI_API_KEY` | your OpenAI key (**Secret**) |
| `OPENAI_MODEL` | `gpt-4o-mini` (text / PDF) |
| `OPENAI_VISION_MODEL` | `gpt-4o` (images) |

Without a key, Sheetly runs in **mock mode** (fixtures still
extract and the UI stays demoable).

## Stack

FastAPI · OpenAI vision + text · schema-safe JSON · pandas /
openpyxl · SQLite