GrantFlow

GrantFlow is a governed workflow engine for institutional proposal operations.

It turns program intent into reviewable draft packages with controlled stages, human approvals, traceability, and export-ready deliverables.

Not a generic grant-writing chatbot.

---

What it does

• Multi-stage drafting workflow with donor-aware routing
• Human-in-the-loop checkpoints (pause/approve/resume)
• Critic findings + review workflow + SLA signals
• Traceability across citations, versions, and events
• Export to .docx, .xlsx, and buyer-facing ZIP evidence packs

PMF focus (current)

• Strongest buyer proof: EU, UN
• Conditional: USAID
• Other donor paths exist for evaluation, not positioned as equal-strength proof

30-day pilot offer (default)

• ICP: NGO/implementer teams with recurring EU/UN workflows (USAID conditional)
• Scope: 3-6 representative cases with named owners
• Exit: Go/No-Go based on cycle-time delta, review-loop delta, and trust in traceability

Canonical pilot path: docs/canonical-pilot-path.md

---

Quickstart

make bootstrap-dev
source .venv/bin/activate
uvicorn grantflow.api.app:app --reload
curl -s http://127.0.0.1:8000/health

Open demo UI: http://127.0.0.1:8000/demo

---

5-minute demo flow

1. POST /generate/from-preset
2. GET /status/{job_id}
3. GET /status/{job_id}/pilot-quick-report
4. GET /status/{job_id}/pilot-evidence-pack/export

---

Current boundaries

• Built-in auth is API-key based
• Enterprise IAM/OIDC/SAML/RBAC are expected at gateway/platform layer
• Queue-backed runtime + worker mode supported for production
• Production-oriented compose example: docker-compose.production.example.yml

See also:

• docs/production-boundaries.md
• docs/reference-topology.md
• docs/enterprise-access-layer.md
• SECURITY.md

---

Docs by audience

• Buyers: docs/buyer-one-pager.md, docs/pilot-evaluation-checklist.md, docs/proof-summary.md
• Operators: docs/demo-runbook.md, docs/operations-runbook.md, docs/pilot-day1-checklist.md
• Engineers: docs/README.md, docs/architecture.md, docs/contributor-map.md

---

Pilot artifacts and conversion materials

• docs/commercial-pilot-one-pager-v2.md
• docs/pilot-conversion-decision-memo-template.md
• docs/pilot-conversion-decision-memo-2026-04-13.md
• docs/buyer-facing-send-pack-2026-04-13.md
• docs/pilot-dealflow-operating-system.md

Customer-specific pilot data remains outside this public repository.