OpenDraft Engine

The Python AI engine that powers thesis draft generation. Contains the 19-agent pipeline, citation research, and export functionality.

Structure

engine/
├── draft_generator.py      # Main 19-stage pipeline orchestrator
├── config.py               # Model settings, API keys, rate limits
├── utils/
│   ├── agent_runner.py     # Agent execution engine
│   ├── api_citations/      # Citation APIs (CrossRef, Semantic Scholar)
│   ├── citation_*.py       # Citation management & validation
│   ├── export_professional.py  # PDF/DOCX export
│   ├── pdf_engines/        # Pandoc, WeasyPrint engines
│   └── deep_research.py    # Research phase utilities
├── prompts/
│   ├── 00_WORKFLOW.md      # Complete agent workflow
│   ├── 01_research/        # Deep Research, Scout, Scribe, Signal
│   ├── 02_structure/       # Architect, Citation Manager, Formatter
│   ├── 03_compose/         # Crafter, Thread, Narrator
│   ├── 04_validate/        # Skeptic, Verifier, Referee
│   ├── 05_refine/          # Citation Verifier, Voice, Entropy, Polish
│   └── 06_enhance/         # Abstract Generator, Enhancer
└── opendraft/              # CLI tools

Usage

Run Pipeline Directly

cd engine
python draft_generator.py --topic "Your research topic" --level master

Academic Levels

Level	Words	Chapters	Time
research_paper	3-5k	3-4	5-10 min
bachelor	10-15k	5-7	8-15 min
master	20-30k	7-10	10-25 min
phd	50-80k	10-15	20-40 min

Environment Variables

Required in .env (project root):

GEMINI_API_KEY=your-key      # Required
PROXY_LIST=...               # Optional: for faster research
SCOUT_PARALLEL_WORKERS=32    # Optional: parallelism

Dependencies

pip install -r requirements.txt

Release files for opendraft 1.7.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for opendraft 1.7.4
File	Size	Uploaded
opendraft-1.7.4.tar.gz	367.0 kB	Jul 22, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for opendraft 1.7.4
File	Interpreter	ABI	Platform	Reset
opendraft-1.7.4-py3-none-any.whl 419.8 kB Jul 22, 2026	Python 3	none	any	Details

Total release size:786.8 kB

Release files / opendraft-1.7.4.tar.gz

Download URL	opendraft-1.7.4.tar.gz
Size	367.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`65d815e6b98a8496837ac7cc39665e8fa5c1951b17a919d14bf3415e5fd3f984`
BLAKE2b-256 checksum How to use checksums	`e0adb13fd310643271311df491db1743f7a4cefcfd1faf193a9f8be236ebdbf5`
Upload date	Jul 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.3`

Release files / opendraft-1.7.4-py3-none-any.whl

Download URL	opendraft-1.7.4-py3-none-any.whl
Size	419.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d7fe5a496734939025b4ef2fa4f6cd4279372d17f9ca016e570f0f73556912d1`
BLAKE2b-256 checksum How to use checksums	`22d0e5047d2bd99ade902483feddf4b51bd45ffaebf1c335bdc2d007cc1571a1`
Upload date	Jul 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.3`