Skip to content
Back to search

opendraft

Write research paper and literature review drafts with an open-source Python engine that checks citation DOIs against scholarly databases. Export PDF, Word, or LaTeX.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/federicodeponte--opendraft/badge.svg)](/listings/federicodeponte--opendraft)

HTML

<a href="/listings/federicodeponte--opendraft"><img src="/api/listings/federicodeponte--opendraft/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 104 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # OpenDraft: open-source research paper and thesis writer with verified citations
  2. **The open-source agent system that writes research papers with verified citations.**
  3. OpenDraft drafts research papers, literature reviews and thesis chapters from one topic, and keeps a citation only if at least two of Crossref, OpenAlex and Semantic Scholar hold its DOI. An open-source alternative to Jenni and ThesisAI: MIT licensed, runs on your own model key.
  4. **Website: [opendraft.xyz](https://opendraft.xyz)** · [Docs](https://opendraft.xyz/docs) · [Sample PDF](examples/Why_Academic_Thesis_AI_Saves_The_World.pdf) · [Hosted version (OpenPaper)](https://openpaper.dev/)
  5. [![PyPI](https://img.shields.io/pypi/v/opendraft?style=for-the-badge&logo=pypi&logoColor=white)](https://pypi.org/project/opendraft/)
  6. [![PyPI downloads](https://img.shields.io/pepy/dt/opendraft?style=for-the-badge&label=PyPI%20downloads)](https://pepy.tech/projects/opendraft)
  7. [![GitHub stars](https://img.shields.io/github/stars/federicodeponte/opendraft?style=for-the-badge&logo=github)](https://github.com/federicodeponte/opendraft)
  8. [![License: MIT](https://img.shields.io/badge/License-MIT-555?style=for-the-badge)](LICENSE)
  9. **Use OpenDraft as a skill in your own agent (Claude, ChatGPT), free → [getedge.cc/skills/autonomous-research](https://getedge.cc/skills/autonomous-research/?utm_source=github&utm_medium=readme&utm_campaign=opendraft)**
  10. <p align="center">
  11. <a href="examples/Why_Academic_Thesis_AI_Saves_The_World.pdf"><img src="assets/readme/sample-draft.gif" width="900" alt="Pages from a real OpenDraft sample draft: title page, table of contents, introduction, results and a DOI-linked reference list"></a>
  12. <br><sub>Real output: pages from the <a href="examples/Why_Academic_Thesis_AI_Saves_The_World.pdf">sample draft</a> (60 pages, 40+ citations).</sub>
  13. </p>
  14. ## Cited in research
  15. - **Talukder et al. (2026)**, [*Discourse2Draft: an AI-powered structured document writing tool*](https://doi.org/10.3389/frai.2026.1945655), *Frontiers in Artificial Intelligence*. Peer-reviewed NIH paper, next to Stanford's STORM ([comparison](docs/opendraft-vs-storm.md)).
  16. - **Kong et al. (2026)**, [*AI for Auto-Research: Roadmap & User Guide*](https://arxiv.org/abs/2605.18661), arXiv:2605.18661. NUS survey of research agents.
  17. **24k+ downloads:** [20,289 on PyPI](https://pepy.tech/projects/opendraft) (pepy.tech) and [4,200 on npm](https://www.npmjs.com/package/opendraft), as of November 2026.
  18. ## Quickstart
  19. Requires Python 3.10+ and a Gemini API key (Claude and OpenAI also work).
  20. ```bash
  21. pip install opendraft
  22. opendraft setup # enter your Gemini API key
  23. opendraft "Remote work and team productivity"
  24. ```
  25. | Command | What it does |
  26. |:---|:---|
  27. | `opendraft` | Interactive mode |
  28. | `opendraft "Topic" --level phd --lang de` | Draft at a level (`research_paper`, `bachelor`, `master`, `phd`) and language |
  29. | `opendraft "Topic" --expose` | Outline and sources only, faster |
  30. | `opendraft revise ./output "make the intro longer"` | Revise a draft |
  31. | `opendraft tldr paper.pdf` | 5-bullet summary of any paper |
  32. ## Use it as a skill
  33. In Claude Code, Codex or any agent that reads skills:
  34. ```bash
  35. npx skills add federicodeponte/opendraft --skill autonomous-research
  36. ```
  37. Then ask: `Write a paper on <topic>`. The skill lives in [`skills/autonomous-research/`](skills/autonomous-research/); it runs inside your agent and does not call this Python engine.
  38. ## Run the engine yourself
  39. ```bash
  40. git clone https://github.com/federicodeponte/opendraft.git
  41. cd opendraft
  42. pip install -e ./engine
  43. cp .env.example engine/.env # add your key
  44. opendraft "Your topic"
  45. ```
  46. | Variable | Required | Purpose |
  47. |:---|:---|:---|
  48. | `GOOGLE_API_KEY` | One key required | Gemini (default provider) |
  49. | `ANTHROPIC_API_KEY` / `OPENAI_API_KEY` | Optional | Claude or OpenAI, with `AI_PROVIDER=claude` or `openai` |
  50. | `ENABLE_SEMANTIC_SCHOLAR` | Optional | Set `false` if Semantic Scholar rate-limits you |
  51. All settings are listed in [`.env.example`](.env.example).
  52. ## How it works
  53. 19 agents work in six phases: research, structure, compose, validate, refine, enhance. A source stays only if at least two of Crossref, OpenAlex and Semantic Scholar hold its DOI. That proves the work exists, not that every claim about it is right, so a second check judges whether each source fits its claim. Details: [citation verification](docs/citation-verification.md) · [pipeline](docs/PIPELINE.md) · [methodology](https://opendraft.xyz/methodology).
  54. ## FAQ
  55. **What is OpenDraft?**
  56. An open-source agent system that researches and writes papers with verified citations. MIT licensed.
  57. **Is OpenDraft free?**
  58. Yes. You pay only your model provider, about $0.35 to $3 per draft.
  59. **How are citations verified?**
  60. A source stays only if at least two of Crossref, OpenAlex and Semantic Scholar hold its DOI. That proves it exists, not that every claim about it is right.
  61. **How long does a draft take, and in what formats?**
  62. Usually 10 to 20 minutes. Export to PDF, Word and LaTeX.
  63. **Who has cited OpenDraft?**
  64. A peer-reviewed NIH paper (Talukder et al., 2026), next to Stanford's STORM, and the NUS survey *AI for Auto-Research* (Kong et al., 2026).
  65. **Are the drafts ready to submit?**
  66. No. They are starting points: review and edit before use, and follow your institution's policy on disclosure.
  67. ## Contributing
  68. Issues and pull requests are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md), ask in [Discussions](https://github.com/federicodeponte/opendraft/discussions), and read the [changelog](CHANGELOG.md).
  69. ## License
  70. MIT, see [LICENSE](LICENSE). To cite OpenDraft, use [CITATION.cff](CITATION.cff) ("Cite this repository" on GitHub).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.