SCI-Necromancer is an open-source academic writing assistant for medical-imaging, cardiovascular, and oncology conference abstracts. It turns source material into structured ISMRM, RSNA, ECR/ER, ESC, ASCO, or ESMO drafts through either standard analysis or the intentionally playful 邪修 / alchemy mode.
The application assists with analysis, wording, formatting, figures, export, and independent blind review. It does not prove that data, ethics approvals, patient de-identification, statistics, citations, or submission compliance are correct. Authors remain responsible for every submission.
Vue 3 provides the shared interface and conference slices. Deterministic conference rules constrain provider prompts and validate outputs. The optional Skills & MCP layer adds a bundled read-only blind-review skill, a member-only MGA research-verification agent with allowlisted PubMed, Semantic Scholar, and Hubble abstract search, plus backend-provisioned CiteCheck and DOI verification. Local storage is the default; Supabase integration is optional.
- Guided standard workflow: source → analysis → type/category selection → generation → save/export.
- 邪修 mode with the shared “一键炼丹” action for idea expansion.
- Conference-specific support for ISMRM, RSNA science/education, ECR/ER, ESC, ASCO, and ESMO.
- Complete English/Chinese application UI and localized errors/accessibility labels.
- Figure generation/editing and Markdown, PDF, JSON, and image export.
- Nine journal-style figure presets and seven explainable schematic layouts, with a user-overridable layout recommendation.
- Public Sci Guide: unlimited static shortcuts plus grounded MGA documentation answers, cited sources, safe navigation, and no member-credit charge.
- Optional member services: GitHub sign-in, five-unit signup bonus, daily check-in, managed Gemini/GPT Image generation, Stripe top-up, and explicit private Supabase saving.
- One managed abstract, one-click creative, regeneration, deep-update, or image task consumes two credits; blind review consumes one. BYOK remains free of platform credit charges.
- Skills & MCP capability switches, safe local JSON-manifest import, and downloadable blind-review skill.
- Structured blind review across ethics, consent, de-identification, data integrity, methods, citations, reporting guidance, and conference rules.
- Fail-closed external verification: unavailable evidence services never count as verified.
Requirements: Node.js 18+ and a Google Gemini or OpenAI-compatible API key.
git clone https://github.com/picspin/Sci-Necromancer.git
cd Sci-Necromancer
npm install
npm run devOpen the local URL printed by Vite, then configure the provider under Models.
- Select ISMRM, RSNA, ECR/ER, ESC, ASCO, or ESMO.
- Paste/upload source material, or switch to 邪修 mode and enter a research idea.
- Analyze, confirm the suggested route, and generate the abstract.
- Save, export, or run the independent blind review.
- Verify every factual, ethical, privacy, statistical, citation, and conference-compliance claim before submission.
Under Skills & MCP, Skills and MCP can be loaded independently. External .json manifests may activate only a named, trusted adapter already built into the deployment; unbound manifests remain registry-only. Browser-side commands and credentials are ignored, and new executable MCP adapters must be provisioned by the backend administrator.
npm run test -- --run
npm run lint
npm run buildDeploy api/ to Vercel and the browser app with the Worker configuration in
wrangler.jsonc, not as unwrapped static files. The Worker keeps /api/* and
Supabase Auth traffic on the application origin, then reaches Vercel/Supabase over Cloudflare's
server network. VITE_API_BASE_URL remains a browser fallback for hosts that cannot run the Worker;
do not make a .vercel.app URL the only production path for mainland-China users. Set
VITE_SUPABASE_PROXY_PATH=/supabase during non-rad-sci.org Cloudflare builds. The committed
.env.production contains browser-public production values so a normal
npm run build && npx wrangler deploy cannot silently compile membership out of the application.
Only Supabase publishable/anon keys belong there; keep service-role and provider secrets in Vercel.
Member Functions run in Vercel yul1, close to the Canada Supabase region; provider-heavy Functions
remain in iad1. Configure Supabase, Turnstile, provider, and Stripe server secrets from
.env.example, apply every migration under supabase/migrations/, and never place
server credentials in VITE_* variables. Provider use must still comply with its supported-region
rules and terms.
After both deployments, this command must return JSON (not the SPA HTML) and include
X-Sci-Proxy: member-api:
curl -i https://www.rad-sci.org/api/healthCreate the Stripe webhook at /api/stripe-webhook, pin it to API version 2026-02-25.clover, and explicitly enable checkout.session.completed, refund.created, refund.updated, charge.dispute.created, and the selection-required charge.dispute.funds_reinstated event. Verify purchase, successful refund, duplicate delivery, dispute, and funds reinstatement with Stripe CLI in test mode before enabling live payments.
For privileged CiteCheck/DOI MCP review, also configure the HTTPS facade variables and trusted edge token described in the backend guide.
- RSNA abstract submission
- RSNA faculty and presenter resources
- ISMRM abstract submission guide
- ECR abstract submission
- ESC abstract rules
- ASCO Annual Meeting submission requirements
- ESMO Congress 2026 abstract regulations
- STARD · TRIPOD
Official rules change. Always verify the current meeting website; internal reference material is a drafting aid, not authority.
- Blank page: use Node 18+, run
npm install, and inspect the browser console. - Provider error: verify the API key, base URL, model name, quota, and provider privacy terms.
- File extraction fails: paste plain text and remove protected/scanned content.
- External reviewer unavailable: confirm the checkbox, backend facade, HTTPS configuration, timeout, and trusted edge header.
- Unexpected output: clear the workflow, regenerate from verified source material, and never submit unreviewed AI text.
MIT licensed. Contributions and evidence-based corrections are welcome.
