How to Use Medic Oath

#What Is Medic Oath

Medic Oath is an open AI platform that discovers, validates, and publishes treatments for diseases the pharmaceutical industry has abandoned. 95% of known diseases have no approved treatment — not because cures are impossible, but because there is no commercial incentive to find them.

The platform uses AI to analyse millions of biomedical papers, generate novel therapeutic hypotheses, validate them through automated safety and ethics review, and publish every discovery free — for anyone in the world to use, manufacture, and distribute.

Built by one developer. Licensed AGPL-3.0. Live at medicoath.com. Every discovery made on Medic Oath is published free — no patents, no paywalls, no restrictions. The discoveries belong to humanity. Forever.

#Account & API Key

Medic Oath has two access levels: browsing (free, no account needed) and AI generation features (requires account + your own Anthropic API key).

What works without an account

• Browse all diseases, conditions, and neglect scores
• View existing AI-generated hypotheses and discovery reports
• Read disease briefs, patient stories, intelligence reports
• Explore the knowledge graph, cure pipeline, and manufacturing data
• Use the patent cliff timeline, drug alternatives, and interaction checker
• Chat with MO (the AI assistant) — uses the platform API key, free for everyone
• View all accountability, intelligence, and tools pages

What requires an account + API key

• Generate new hypotheses via the Hypothesis Engine
• Run Prometheus (8-agent autonomous discovery pipeline)
• Submit peer reviews
• Submit research

How to set up

#Navigating the Platform

The sidebar is organised into 9 colour-coded sections. Each section groups related pages and tools.

Blue Info Strip

Below the header on every page, a blue info strip shows the current page's title, goal, and description. Click the ? button on the right for detailed help about what the page does and how to use it. Click the MO button to open the AI assistant, which can answer questions about the page, the data, or anything on the platform.

MO Chat Assistant

MO is the platform's AI assistant, accessible from the MO button in the info strip on every page. MO uses the platform's own API key — no user key needed. Ask MO about any disease, any page, any feature. MO has full context about the platform and can help you navigate, understand data, and find what you need.

Data Sources Footer

Every page shows its data sources in the footer. This tells you exactly where each number comes from — whether it is from the Supabase database, the AI-generated intelligence cache (refreshed daily), or live external APIs like PubMed, ClinicalTrials.gov, or WHO.

#The 9 Sections — What Each One Does

Every page in the sidebar is described below, grouped by section.

• Hypothesis Engine — Browse, search, and generate AI-powered therapeutic hypotheses. Each hypothesis is scored across 7 dimensions: confidence, mechanistic plausibility, evidence convergence, unexplored, tractability, impact, and cost. Submit a disease name to trigger a new generation run (requires API key).
• Prometheus — The autonomous AI Cure Engine. 8 specialist agents work in sequence: Literature Synthesis → Hypothesis Generation → Safety Gate → Bioinformatics → Conflict of Interest → Experiment Design → Drug Repurposing → Ethics Review. Start a full discovery run for any disease (requires API key).
• Cure Pipeline — Live tracker showing all discoveries as they move through the 8-stage pipeline from hypothesis to manufacturing protocol. Filter by disease, status, or confidence score.
• Mortality Clock — Real-time counter showing estimated deaths from neglected diseases since you loaded the page. AI-generated from WHO and IHME data, refreshed daily.
• Neglect Score — Ranks diseases by how commercially ignored they are — the ratio of global disease burden (DALYs) to research investment. Scores of 90+ indicate diseases with enormous suffering and near-zero funding.
• Cure Journey — Visual timeline showing how a single hypothesis moves from AI generation through safety review, peer review, trial design, and manufacturing. An educational walkthrough of the discovery process.
• Manufacturing — Synthesis protocols for validated compounds. Published openly so any generic manufacturer worldwide can produce treatments. Includes reagent lists, step-by-step procedures, and quality control specifications.

• Outbreak Detection — AI-monitored surveillance of emerging disease outbreaks worldwide. Aggregates signals from WHO, ProMED, and published literature. Refreshed daily at 3am UTC.
• Suppression Impact — Tracks where published literature disagrees or where evidence has been suppressed. Paper A says a compound works, Paper B says it does not — these contradictions are flagged as opportunities for new research.
• Pharma Accountability — AI-generated reports on pharmaceutical industry practices: price gouging, withdrawn drugs, lobbying spend, and research funding gaps. All data sources cited in footer.
• Suppressed Research — Repository of research that was conducted but never published, trials that were registered but never reported results, and studies where negative findings were buried.
• Evidence Gap — Maps where clinical evidence is missing. Shows disease-intervention pairs with insufficient research, highlighting where new studies are most needed.

• All Diseases — Searchable index of all diseases tracked by the platform. Each disease page shows linked hypotheses, neglect score, burden data, known genes and pathways, active trials, and patient stories.
• Conditions — Browse and search conditions by name, ICD code, or symptom. See all linked interventions, studies, and genomic data for any condition.
• Knowledge Graph — Interactive graph visualisation of relationships between diseases, genes, compounds, pathways, and proteins. Search any entity to see its connections. Search any entity to see its connections across the corpus.
• Patient Stories — First-person accounts from patients living with neglected conditions. Provides human context alongside the data and helps researchers understand real-world impact.
• Disease Briefs — AI-generated summaries for each disease covering epidemiology, current treatments, research gaps, and Medic Oath hypotheses. Refreshed daily at 3am UTC.

• Studies — Browse all version-controlled research studies. Each study has a full version history with SHA-256 commit hashes. Fork any study to build on prior work with full attribution.
• Genomics — Gene and protein data linked to diseases and interventions. Explore CRISPR targets, gene expression data, and pathway analysis.
• ProofChain — Blockchain verification layer on Arbitrum L2. Every discovery is minted as an immutable on-chain record with an IPFS evidence link, creating permanent prior art that prevents patents.
• Research Board — Overview of active research activity across the platform: recent submissions, peer reviews in progress, and trending hypotheses.
• Submit Research — Submit your own study for open peer review. Fill in the structured form with title, abstract, methodology, results, and conclusions. Attach datasets and supplementary materials.
• Clinical Trials — Browse trial protocol designs generated by the platform, including eligibility criteria, arms, endpoints, and sample size calculations. Also links to external trials on ClinicalTrials.gov.

• Bounty Board — Disease-specific research bounties. Community members post bounties for diseases they want investigated. Researchers claim bounties by generating validated hypotheses.
• Funding Campaigns — Active funding campaigns sorted by disease neglect score. Contribute to specific disease research. All funding is tracked transparently.
• Children Index — Focused view of paediatric disease neglect. Shows which childhood conditions receive the least research funding relative to their burden.

• Pharma vs M.O. — Side-by-side comparison of pharmaceutical industry drug development costs, timelines, and pricing versus Medic Oath's open approach. AI-generated, refreshed daily.
• Price Index — Global drug pricing data across 140+ countries. Shows price disparities for the same medication between high-income and low-income nations.
• Trial Graveyard — Repository of clinical trials that were registered but never completed or reported. Tracks why trials failed and whether the data was suppressed.
• Whistleblower — Secure submission portal for reporting research misconduct, data suppression, or safety signal cover-ups.
• Patent Cliffs — Timeline of upcoming patent expirations. When a patent expires, Medic Oath auto-publishes open manufacturing protocols so generic manufacturers can begin production immediately.
• Sovereignty Index — Measures each country's ability to manufacture its own essential medicines. Countries with low sovereignty depend entirely on foreign pharmaceutical supply chains.
• Global Neglect Index — Worldwide view of which diseases and populations receive the least research attention. Combines neglect scores with geographic burden data.
• Treatment Gaps — Maps where approved treatments exist but are inaccessible due to cost, supply, or regulatory barriers.
• Open Pharmacopoeia — Free, open-access drug manufacturing standards and monographs. The pharmaceutical equivalent of open-source software.

• AI Diagnosis — Enter symptoms to receive AI-generated differential diagnosis suggestions. Not a replacement for medical consultation — a starting point for informed conversations with your doctor.
• Drug Alternatives — Search any medication to find generic equivalents, biosimilars, and alternative compounds with similar mechanisms of action.
• Interaction Checker — Check for known interactions between multiple medications. Uses published pharmacological data to flag potential risks.
• Trial Matching — Enter your condition and location to find active clinical trials you may be eligible for. Pulls from ClinicalTrials.gov and other registries.
• Medicine Shortages — Real-time tracker of global medicine shortages. AI-generated from FDA, EMA, and WHO shortage databases. Refreshed daily.

• Contributors — Public leaderboard of researchers, reviewers, and funders ranked by contribution score. Significant contributions are attributed via ProofChain.
• Live Feed — Real-time broadcast of every discovery, hypothesis, and contribution as it happens. Subscribe via RSS or webhook.
• Participate — Citizen science data contribution. Submit anonymised symptoms, treatments, and outcomes for your condition. Protected with differential privacy. When enough patients contribute data for the same condition, a discovery run triggers automatically.
• Community Forum — Discussion space for researchers, patients, and contributors. Ask questions, share findings, coordinate research efforts.
• Safety — Report adverse events, clinical anomalies, or safety concerns. Feeds into the pharmacovigilance detection system.

• How to Use — This page. Complete guide to every feature on the platform.
• Learn Modules — Educational content explaining how drug discovery works, what clinical trials involve, how to read a research paper, and why neglected diseases remain untreated.
• Annual Report — Yearly summary of platform activity: discoveries generated, diseases investigated, contributions made, and impact metrics.
• Legacy Archive — Historical record of all platform milestones, major discoveries, and community achievements.

#How Data Works

Every number on Medic Oath comes from one of three sources: the Supabase database (user-submitted data, studies, hypotheses), the AI-generated intelligence cache (refreshed daily), or live external APIs (PubMed, ClinicalTrials.gov, WHO).

The Daily Cache Refresh

An automated cron job runs every day at 3am UTC. It regenerates all intelligence pages: disease briefs, pharma accountability reports, patent cliff timelines, medicine shortages, mortality clock data, neglect scores, outbreak detection, and more. The AI analyses current data from WHO, FDA, IHME, PubMed, and other sources, then writes the results to Supabase. Until the next refresh, pages serve the cached version.

Zero Cost from Browsing

Page views never call Claude AI. All GET routes serve cached data from Supabase. Browsing the platform — viewing hypotheses, reading disease briefs, checking neglect scores, exploring the knowledge graph — costs nothing. AI is only called when you explicitly trigger a generation action (new hypothesis, Prometheus run), and those calls use your own API key.

Data Sources

The footer of every page lists its specific data sources. Common sources include:

• Supabase — Platform database for studies, hypotheses, user data, and cached intelligence
• Claude AI — Generates hypotheses, intelligence reports, and analysis (via daily cron or user-triggered actions)
• PubMed / MEDLINE — Published biomedical literature
• ClinicalTrials.gov — Clinical trial registrations and results
• WHO / IHME — Global disease burden, mortality, and epidemiology data
• ChEMBL / DrugBank — Drug compound and target data
• FDA FAERS — Adverse event reporting for safety analysis
• Orphanet — Rare disease classifications and epidemiology

#Getting Started — Step by Step

New to Medic Oath? Follow these steps to explore the platform from start to finish.

#For Researchers

Submit papers and studies

Click Submit Research in the RESEARCH section and fill in the structured form with your study title, abstract, methodology, results, and conclusions. Attach datasets and supplementary materials. Once submitted, your study enters the peer review pipeline and receives a permanent version hash.

Peer review

Click Studies in the RESEARCH section. Register as a reviewer to evaluate hypotheses in your field. Your reviews contribute to your contributor score on the public leaderboard, and significant contributions are attributed via ProofChain.

Use the API

Medic Oath exposes REST APIs across all services. Each service has an OpenAPI/Swagger interface at its /docs endpoint. To get an API key, go to your profile → API Keys. The API supports study CRUD, hypothesis generation, knowledge graph queries, condition/intervention search, and more.

Knowledge graph access

Click Knowledge Graph in the DISEASES section. The graph shows relationships between conditions, interventions, genes, pathways, and proteins derived from the MedicOath corpus. Use traversal queries to find repurposing paths, shared pathways between diseases, and novel therapeutic targets.

Version-controlled research

Every study on Medic Oath is version-controlled. Click any study to see its full version history, including diffs between versions. Fork any study to create your own branch, modify it, and publish with full attribution to the original. All versions are immutable and cryptographically hashed.

#For Patients & Citizens

Search for your condition

Click Conditions in the DISEASES section and type your disease name. You will see: how many hypotheses have been generated, the neglect score, all proposed interventions, linked genes and pathways, and any active clinical trial designs. Click Disease Briefs for an AI-generated summary written in accessible language.

Read patient stories

Click Patient Stories in the DISEASES section. Read first-person accounts from others living with the same condition. Submit your own story to help researchers understand the real-world impact of neglected diseases.

Participate in citizen science

Click Participate in the COMMUNITY section and contribute your anonymised health data. This is completely voluntary and you control exactly which data types you share via granular consent. Your data is protected with differential privacy (mathematical noise added to prevent re-identification). When enough patients contribute data for the same condition, the platform automatically triggers a new discovery run.

Share findings

Every discovery page has a share button that copies a direct link. Subscribe to the Live Feed in the COMMUNITY section via RSS or email to stay updated. Share discoveries with your doctors, patient communities, and advocacy groups.

#For Developers

API access

Medic Oath provides REST APIs across all services. Each service exposes an OpenAPI/Swagger UI at its /docs endpoint. Key APIs include:

• MedGit (port 4001) — Studies, conditions, interventions, datasets, search
• Identity (port 4002) — Authentication, user profiles, WebAuthn
• Hypothesis Engine (port 4003) — Hypothesis CRUD, AI generation, scoring
• Knowledge Graph (port 4004) — Node/edge CRUD, traversal, analytics
• Trial Protocol (port 4005) — Protocol design, eligibility, arms, endpoints
• Pharmacovigilance (port 4006) — Adverse events, safety signals, analytics
• Funding (port 4007) — Funds, donations, governance
• Prometheus (port 4008) — Discovery runs, agent status, reports
• MedisNet (port 4009) — FHIR resources, consent, contributions

Tech stack

Next.js 15, React 19, TailwindCSS 4, PostgreSQL 16 (Supabase), pgvector, Upstash Redis, Arbitrum L2, Claude API. Production runs on Vercel + Supabase. Architected for scale with 33 microservices available for future deployment.

Contribute to the codebase

Medic Oath is AGPL-3.0 licensed. To contribute:

#For Funders & Supporters

Help Build the Future of Free Medicine

Medic Oath is built and maintained by a single developer. It does not belong to any company, any investor, or any institution. It belongs to humanity. But building and running infrastructure of this scale — AI agents, blockchain verification, biomedical databases, federated learning — has real costs and requires real time.

Why Funding Matters

Server costs, AI compute (every Prometheus run calls Claude to analyse millions of papers), database hosting, blockchain gas fees, and hundreds of hours of development time are all currently borne by one person. There is no company behind this. No venture capital. No institutional backing. Every pound and dollar contributed goes directly into keeping the platform free, expanding its capabilities, and accelerating discoveries for diseases that commercial medicine ignores. This is not a startup looking for profit — it is one person trying to solve one of humanity's biggest problems and asking for help to do it.

What Your Funding Enables

• •More Prometheus autonomous cure runs — each run analyses millions of papers across 8 AI agents. More funding means more diseases investigated, faster.
• •Expanded disease coverage — moving beyond current conditions to cover rare diseases, tropical diseases, paediatric conditions, and other neglected areas.
• •Faster hypothesis generation — more compute means more parallel runs, shorter queues, and quicker discoveries.
• •More robust ProofChain verification — gas fees for minting discoveries on Arbitrum L2 and pinning evidence on IPFS.
• •Citizen science infrastructure — differential privacy systems, federated learning coordination, and patient data security.
• •Full-time development — the difference between spare-time progress and dedicated, rapid advancement of the platform.

How You Can Help as a Funder

Contact for Partnerships

If you are a research institution, grant body, or organisation seriously interested in supporting Medic Oath, please reach out. We are looking for partners who share our belief that medical knowledge should be free and that AI can be used to save lives, not just generate profit.

#Frequently Asked Questions