---
title: GrantForge API
emoji: 🏢
colorFrom: blue
colorTo: red
sdk: docker
app_port: 7860
pinned: false
---

# GrantForge AI (DotacjeAI)

> **Hugging Face Space** — `sdk: docker`, port **7860** (Gunicorn → FastAPI `backend/server:app`).  
> Nie usuwaj bloku YAML powyżej — bez niego Space zgłasza *config error*.

Platforma B2B: **katalog naborów** (aktualne, z kontrolą linków i regulaminów) → **dopasowanie do firmy** → **generacja wniosku** → **audyt / quality loop** → **eksport PDF/DOCX**.

## Szybki start

| Warstwa | Stack |
|---------|--------|
| Frontend | React + TypeScript (Vite), Clerk, Vercel |
| Backend | FastAPI, PostgreSQL, Neo4j, Pinecone/RAG, HF Space |
| AI | Router Gemini / xAI, LangGraph autopilot |

```bash
# Backend
cd backend && pip install -r requirements.txt
# ustaw .env (DB, Clerk, LLM keys) — patrz DEPLOYMENT.md
uvicorn server:app --reload --port 8000

# Frontend
cd frontend-react && npm install && npm run dev
```

## Dokumentacja użytkownika i testów

| Plik | Opis |
|------|------|
| [docs/PLAN_ECOSYSTEM_2026_IMPLEMENTATION.md](docs/PLAN_ECOSYSTEM_2026_IMPLEMENTATION.md) | **Roadmap ekosystemu 2026** (eligibility → strategy → tax → instruments) |
| [docs/PLAN_INSTRUMENT_FIRST_PIPELINE.md](docs/PLAN_INSTRUMENT_FIRST_PIPELINE.md) | Warstwa instrument-first (schema, readiness) |
| [docs/USER_GUIDE.md](docs/USER_GUIDE.md) | Instrukcja obsługi |
| [docs/TEST_PATH_NEW_ENTITY.md](docs/TEST_PATH_NEW_ENTITY.md) | **Pełna ścieżka testowa** nowego podmiotu |
| [docs/agents/ROLE_MAP.md](docs/agents/ROLE_MAP.md) | Role GSD → `backend/agents` |
| [backend/gsd/README.md](backend/gsd/README.md) | Orkiestracja GSD (jednolity runtime) |
| [docs/CREDIBILITY_PIPELINE.md](docs/CREDIBILITY_PIPELINE.md) | Wiarygodność firm i naborów |
| [docs/workflow-reports/GRANT_SYSTEM_RESCUE.md](docs/workflow-reports/GRANT_SYSTEM_RESCUE.md) | Raport naprawy katalogu/jakości |
| [DEPLOYMENT.md](DEPLOYMENT.md) | Deploy |

**GSD / swarm:** cała logika w `backend/gsd/` + `backend/agents/`. Folder `antigravity_grantforge_swarm/` to tylko re-export (deprecated).

W aplikacji: **O programie** (`/about`), **Pomoc** (`/help`), **Beta** (`/beta`).

## Jakość katalogu naborów (skrót)

- Domyślnie `require_certainty=true` — bez starych/martwych programów i bez śmieciowych linków.
- Regulamin ≠ RODO/privacy/listing; RAG nie wektoryzuje strony naboru zamiast regulaminu.
- Import WYSZUKIWARKA + verify URL + close grantów poza snapshotem.
- Quality loop: celowana korekta sekcji (checklist, cytowania), soft-export z grounding.

## Testy

```bash
cd backend && python3 -m pytest tests/ -q --ignore=tests/test_deepeval_rag.py
```

## Licencja / kontakt

Użycie produkcyjne zgodnie z regulaminem aplikacji i polityką prywatności w UI.