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
1 maintainer
Release files for opendraft 1.7.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| opendraft-1.7.3.tar.gz | 364.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| opendraft-1.7.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 781.0 kB
Release files / opendraft-1.7.3.tar.gz
| Download URL | opendraft-1.7.3.tar.gz |
|---|---|
| Size | 364.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e5059ad00312f3314e9a176b5f56d86c134d270230b13fe9fc3fcfbde37a743c
|
|
BLAKE2b-256 checksum How to use checksums |
5c3e68e2e8d2b186edebc58fcbb79e68d7f4ec04bbc07c66f5e9c499cc00361a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Release files / opendraft-1.7.3-py3-none-any.whl
| Download URL | opendraft-1.7.3-py3-none-any.whl |
|---|---|
| Size | 416.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
71d70cd0e925e062ae56154a4047ea7bc89591bb1d9b6b2848bb6600fd1fc1b9
|
|
BLAKE2b-256 checksum How to use checksums |
4eeb9d398f6b4f05f682c28dde4a8cd5dbacc412cb68022286d8cdb9243e2e64
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
