How to Use MedicOath
A complete guide to the world's first open-source AI platform for discovering cures the pharmaceutical industry won't build.
#What Is MedicOath
MedicOath is an open-source autonomous 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.
MedicOath changes this by using AI to analyse millions of biomedical papers, generate novel therapeutic hypotheses, validate them through automated safety and ethics review, and publish every discovery as CC0 — free for anyone in the world to use, manufacture, and distribute.
Who is MedicOath for?
- Researchers — Access AI-generated hypotheses, contribute to peer review, use the knowledge graph for your own work.
- Doctors — Search for conditions and interventions, access the latest discovery reports, find treatment options for neglected diseases.
- Patients — Search your condition, contribute your data to citizen science, trigger new discoveries, access findings for free.
- Citizens — Fund research, share discoveries, participate in governance, help build an open medical commons.
- Developers — Contribute to the open-source codebase, build on the API, extend the platform.
Every discovery made on MedicOath is published under CC0 — meaning no patents, no paywalls, no restrictions. The discoveries belong to humanity. Forever.
#The 7 Pillars — How Each One Works
MedicOath is built on 7 interconnected pillars. Each serves a specific function in the discovery pipeline.
MedGit
Open Research Repository
MedGit is the core data layer — a Git-like version control system for medical research. Every study, condition, intervention, and dataset is tracked with immutable versioning. Each update creates a new version with a SHA-256 commit hash, ensuring complete transparency and reproducibility.
Who should use it: Researchers, academics, and anyone who wants to browse, create, or fork medical studies.
How to use MedGit
Example: A researcher publishes a study on TBK1 inhibitors for ALS → the study gets a version hash → another team forks it to test a modified dose → both versions are permanently linked with full attribution.
Discovery
8-Agent AI Intelligence Stack
Discovery is the brain of MedicOath — 8 specialised AI agents powered by Claude that work in sequence to generate, validate, and score novel therapeutic hypotheses. Each hypothesis is scored across 7 dimensions: mechanistic plausibility, evidence convergence, novelty, tractability, impact, cost, and overall confidence.
Who should use it: Anyone investigating a disease or looking for novel therapeutic approaches. No expertise required.
How to use Discovery
Example: Submit "Visceral leishmaniasis" → 8 agents run in 9 minutes → 5 novel hypotheses generated, 1 flagged Groundbreaking, 1 Trial Ready. Each includes a full evidence chain, safety assessment, and proposed trial design.
ProofChain
Blockchain Trust Layer
ProofChain mints every MedicOath discovery as an immutable record on Arbitrum L2 blockchain. Each record includes a timestamp, evidence hash, IPFS link, and CC0 license — creating permanent prior art that prevents anyone from patenting discoveries after the fact.
Who should use it: Anyone who wants to verify the authenticity of a discovery or download a prior art certificate for patent challenges.
How to use ProofChain
Example: "TBK1 kinase inhibitor for ALS" minted on Arbitrum at block #18,442,891. Any patent application filed after this timestamp covering this approach is invalidated by the on-chain prior art.
Evidence
Peer Review System
Evidence is the transparent peer review system for all MedicOath discoveries. Every Prometheus hypothesis is automatically submitted for blind peer review by registered researchers. The system tracks review status, scores, and community validation.
Who should use it: Researchers who want to review or validate hypotheses, and anyone tracking the status of discoveries.
How to use Evidence
Example: "CRISPR-Cas13 for HSV latency" submitted for review → 3 registered researchers assigned → 2 approve with minor revisions → study status updated to "Validated" within 48 hours.
OpenFund
Decentralised Funding Engine
OpenFund directs research funding to diseases ranked by neglect score — not commercial potential. All funding is tracked on-chain. Reputation-weighted governance lets the community vote on how funds are allocated. The Dead Archive prevents duplicated effort by permanently recording failed approaches.
Who should use it: Anyone who wants to fund neglected disease research or participate in decentralised science governance.
How to use OpenFund
Example: $50,000 contributed to Noma research → funds 3 Prometheus runs, 2 peer reviews, and 1 compassionate use IND filing. Every cent tracked on-chain.
CureNet
Citizen Science Layer
CureNet allows patients with any condition to contribute their anonymised symptom, treatment, and biomarker data directly into the discovery pipeline. When 10 or more patients contribute data for the same condition, Prometheus triggers automatically. CureNet also provides clinical infrastructure: trial protocol design, pharmacovigilance monitoring, and disease-specific research tracking.
Who should use it: Patients, caregivers, and anyone who wants to contribute real-world health data to accelerate medical discovery.
How to use CureNet
Example: 14 patients with ME/CFS submit data → threshold reached → Prometheus auto-triggers → 3 novel hypotheses generated from patient-reported patterns within 15 minutes.
Prometheus
Autonomous Cure Engine
Prometheus is the autonomous AI Cure Engine — 8 specialist LangGraph agents working in sequence for end-to-end drug discovery. It reads literature, generates hypotheses, checks safety, analyses genes and pathways, detects conflicts of interest, designs experiments, finds repurposable drugs, and conducts ethics review. A human-in-the-loop checkpoint ensures quality control after hypothesis generation.
Who should use it: Anyone who wants to trigger a full autonomous discovery run for any disease.
How to use Prometheus
Example: Submit "Visceral leishmaniasis" → 8 agents complete in 12 minutes → 5 hypotheses generated → safety gate clears 3 → ethics review approves 2 → manufacturing protocol published on IPFS. Total cost: ~$2.
#Getting Started — Step by Step
New to MedicOath? Follow these steps to explore the platform from start to finish.
Click MedGit → Conditions in the sidebar. Type your disease name into the search bar. You will see all linked hypotheses, trials, genes, and neglect data.
Click Discovery → Neglect Score. This shows how ignored each disease is commercially — the ratio of global disease burden (DALYs) to research investment. Diseases scoring 90+ receive almost zero funding.
Click Discovery → Hypothesis Engine. Browse existing hypotheses or submit a new disease to trigger a full 8-agent discovery run.
Click Discovery → Knowledge Graph. Search for any gene, compound, or disease to see all known relationships in an interactive graph visualisation.
Click Discovery → Contradictions. See where published literature disagrees — Paper A says a compound works, Paper B says it doesn't. These conflicts are opportunities for new research.
Click Evidence → Peer Review. Register as a reviewer to evaluate hypotheses in your field, or submit your own research for open peer review.
Click OpenFund → Funding. Browse active campaigns by disease and contribute. All funding is tracked on-chain with full transparency.
Click CureNet → Participate. Submit your condition, symptoms, and treatments to contribute to the discovery pipeline. Your anonymised data helps trigger new discoveries.
Click Prometheus → Cure Engine. Click "+ New Run", enter a disease name, and watch 8 AI agents work in sequence to discover novel treatments in under 15 minutes.
#Understanding the Data
What are hypotheses?
A hypothesis on MedicOath is a proposed therapeutic approach generated by the AI system. Each hypothesis includes: the proposed intervention (drug, gene therapy, combination), the target condition, a mechanistic explanation of why it might work, supporting evidence from published literature, safety assessment, and scores across 7 dimensions (confidence, mechanistic plausibility, evidence convergence, novelty, tractability, impact, and cost). Hypotheses are not approved treatments — they are starting points for further research and validation.
What does CC0 mean?
CC0 (Creative Commons Zero) means the creator waives all copyright and related rights. Every MedicOath discovery is published under CC0, meaning anyone in the world can use, modify, manufacture, and distribute the findings without permission, attribution requirements, or payment. The discoveries belong to humanity — no patents, no paywalls, no restrictions. Ever.
What does ProofChain verification mean?
When a discovery is "verified on ProofChain," it means the evidence hash has been minted as an immutable record on the Arbitrum L2 blockchain. This timestamp proves the discovery existed at a specific point in time. If anyone later tries to patent the same approach, the on-chain record serves as prior art that invalidates the patent claim. The IPFS link ensures the full evidence is permanently accessible.
What do Neglect Scores mean?
The Neglect Score is a number from 0 to 100 that measures how commercially ignored a disease is. It is calculated as the ratio of global disease burden (measured in DALYs — Disability-Adjusted Life Years) to total research investment. A score of 97 means the disease causes enormous suffering but receives almost zero research funding. MedicOath prioritises high-neglect diseases for Prometheus runs.
What does the Live Feed show?
The Live Feed is a real-time broadcast of every discovery as it is generated on MedicOath. Each entry shows the disease, proposed intervention, confidence score, and timestamp. You can subscribe via RSS, webhook, or email digest to receive alerts the moment a new cure approach is discovered.
#For Researchers
Submit papers and studies
Click MedGit → Studies and click "+ New Study". 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 Evidence peer review pipeline and receives a permanent version hash.
Use the API
MedicOath exposes a full REST API for programmatic access. Every service has an OpenAPI/Swagger interface accessible 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.
Contribute to peer review
Click Evidence → Peer Review and click "Register as Reviewer". Specify your areas of expertise. You will be assigned studies for blind review based on your field. Your reviews contribute to your contributor score on the public leaderboard, and significant contributions are attributed via ProofChain.
Access MedGit version control
Every study on MedicOath is version-controlled. Click any study to see its full version history, including diffs between versions. You can 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 MedGit → Conditions and type your disease or condition name. You will see: how many hypotheses have been generated, the neglect score showing how commercially ignored it is, all proposed interventions, linked genes and pathways, and any active clinical trial designs. Everything is written in accessible language alongside the technical data.
Understand the results
Each hypothesis shows a confidence score from 0.0 to 1.0. A score above 0.7 indicates strong supporting evidence. The "Trial Ready" badge means the hypothesis has passed safety review and has a proposed trial design. The "Groundbreaking" badge means the approach is novel and has high potential impact. Remember: these are research hypotheses, not medical advice. Always consult your healthcare provider.
Participate in citizen science
Click CureNet → Participate 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 (adding mathematical noise 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. You can also subscribe to the Live Feed via RSS or email to stay updated. Share discoveries with your doctors, patient communities, and advocacy groups. The more people who know about these findings, the more likely they are to reach clinical use.
Important: MedicOath generates research hypotheses, not medical advice. All findings should be discussed with qualified healthcare providers before any treatment decisions are made.
#For Developers
API access
MedicOath 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
- CureNet (port 4009) — FHIR resources, consent, contributions
Open source contribution
MedicOath is fully open source under AGPL-3.0. The codebase includes 1,250+ files and 150K+ lines of code across 33 services. To contribute:
git clone https://github.com/andrewhoyle/MedicOath.gitpnpm installdocker compose up -d postgres redisGitHub: github.com/andrewhoyle/MedicOath
Tech stack: Next.js 15, React 19, FastAPI, NestJS, PostgreSQL, Neo4j, Weaviate, Kafka, Arbitrum L2, LangGraph, Claude API.
#For Funders & Supporters
Help Build the Future of Free Medicine
MedicOath 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.
- •CureNet 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
Individual Donations
Any amount helps. Even small contributions add up to keep the servers running and the AI agents discovering.
Research Institution Partnerships
Universities and research institutions can partner with MedicOath to integrate the platform into their research workflows, contribute domain expertise, and co-fund discovery runs for specific disease areas.
Grant Funding
Academic, charitable, and governmental grants can fund specific pillars of MedicOath — from AI compute for Prometheus runs to CureNet citizen science infrastructure. MedicOath is AGPL-3.0 licensed and CC0-published, making it eligible for open science and public good grant programmes.
Corporate Social Responsibility Partnerships
Companies can support MedicOath as part of their CSR programmes. The condition is absolute: no influence over what gets researched, no ownership of discoveries, no IP rights. Everything remains CC0. If your company wants to genuinely help without strings attached, we welcome the conversation.
Technical Infrastructure Donations
Cloud compute credits, GPU time, database hosting, CDN bandwidth — if your organisation can donate infrastructure, it directly translates to more discoveries for more diseases.
What Funders Will Never Get
We want to be completely transparent about this. Funding MedicOath gives you:
- ✕ No ownership of the platform or its discoveries
- ✕ No intellectual property rights of any kind
- ✕ No influence over what diseases are researched
- ✕ No patents, no exclusive access, no premium tier
- ✕ No ability to restrict, paywall, or commercialise any discovery
Every discovery remains CC0 and free forever. This is non-negotiable. If you want to fund medical research that belongs to humanity with no strings attached, MedicOath is the place. If you want a return on investment, this is not.
Contact for Partnerships
If you are a research institution, grant body, or organisation seriously interested in supporting MedicOath, 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.
GitHub: github.com/andrewhoyle/MedicOath
For partnership enquiries, open a GitHub Discussion or contact via the repository.