Skip to content

selinachegg/research-grant-craft

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Research Grant Craft

Open-source grant proposal wizard + reviewer report for researchers.

License: MIT GitHub issues


What it does

  • Structured proposal wizard — guides you through objectives, consortium, timeline, and budget using scheme-specific scaffolding, so every required section is present before you write a word.
  • AI-assisted draft generation — generates a Markdown draft from your wizard answers; works in mock mode with no API key, or with any OpenAI-compatible endpoint you configure.
  • Deterministic heuristic reviewer report — analyses your draft against 22 coverage signals aligned to the funding body's evaluation rubric, and produces a scored report with a prioritised action plan. Same draft → same report, every time.

What it does NOT do

  • It does not predict funding outcomes. The reviewer report checks structural completeness, not scientific quality or panel judgement.
  • It does not submit proposals. There is no integration with the EC Funding & Tenders Portal or any other submission system.
  • It does not store your data. All content lives in your browser's local storage. Nothing is sent to servers owned by this project. See PRIVACY.md and docs/LIMITATIONS.md.

Screenshots

Wizard intake Draft editor Reviewer report
Wizard intake Draft editor Reviewer report

Quickstart

Prerequisites: Node.js ≥ 18, npm ≥ 9.

git clone https://github.com/selinachegg/research-grant-craft.git
cd research-grant-craft
npm install
npm run dev

Open http://localhost:3000 in your browser.

npm test            # run the Jest unit test suite
npm run lint        # ESLint
npm run validate-pack   # validate all scheme pack JSON files

AI generation settings

Click AI settings in the top navigation bar to configure how drafts are generated.

AI settings

Two modes are available:

🧪 Mock mode (default — no API key required)

The app works out of the box without any API key. Mock mode generates a structured Markdown scaffold directly from your wizard answers — no outbound network requests, fully offline. This lets you explore the complete wizard → draft → reviewer report flow immediately.

✨ Live AI mode

Connect your own API key for AI-generated proposal text. Select a provider preset or enter a custom endpoint:

Provider Endpoint Notes
OpenAI (gpt-4o, gpt-4o-mini) https://api.openai.com/v1 Get a key at platform.openai.com
OpenRouter https://openrouter.ai/api/v1 Access 100+ models with one key at openrouter.ai
Ollama (local, free) http://localhost:11434/v1 Install Ollama, run ollama pull llama3 — no data leaves your machine
Custom Any URL Any OpenAI-compatible endpoint (/chat/completions)

Use the Test connection button to verify your key before generating a full draft.

Example — OpenRouter + openai/gpt-4o-mini:

AI configuration test with OpenRouter

Privacy: In Live AI mode your draft text and wizard answers are sent to the provider you configure. In Mock mode nothing leaves your browser. See PRIVACY.md for full details.


Privacy

Research Grant Craft is local-first:

  • Proposal drafts are stored in your browser's localStorage only.
  • No telemetry, no analytics, no user accounts.
  • LLM calls are opt-in; in mock mode no data leaves your browser.

Full details: PRIVACY.md


Scheme packs

A scheme pack defines the structure, evaluation criteria, and rubric for one funding programme. The current packs are:

Pack ID Programme Region Status
horizon_europe_ria_ia Horizon Europe RIA / IA EU ✅ Stable

Adding a new scheme pack

  1. Read docs/SCHEME_PACK_SPEC.md for the file layout and JSON schemas.
  2. Open a new scheme pack issue to discuss the pack before starting work.
  3. Submit a pull request with the new directory under scheme_packs/.
  4. Run npm run validate-pack to confirm the JSON is valid before opening the PR.

Output formats

Format Status
Markdown (draft + reviewer report) ✅ v0.1
DOCX Planned — v1.0
LaTeX Planned — v2.0
PDF Planned — v2.0

Contributing

Contributions are welcome — bug reports, feature requests, new scheme packs, documentation improvements, and code.

Please read CONTRIBUTING.md before opening a pull request. All contributors are expected to follow the Code of Conduct.


How to cite

If you use Research Grant Craft in your research workflow or reference it in a publication, please cite it using the metadata in CITATION.cff.

A plain-text citation:

Research Grant Craft Contributors. Research Grant Craft (v0.1.0). MIT Licence. https://github.com/selinachegg/research-grant-craft


Security

To report a vulnerability, please do not open a public issue. Use the GitHub Security Advisory channel described in SECURITY.md.


License

MIT © 2026 Research Grant Craft Contributors

About

No description, website, or topics provided.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors