The da Vinci Codex Project

"Obstacles do not bend me. Every obstacle yields to stern resolve. He who is fixed to a star does not change his mind." — Leonardo da Vinci

Computational Archaeology of Renaissance Mechanical Engineering

🌐 Live Website • 🎨 Interactive Gallery • 🎵 Renaissance Ensemble • 📖 Documentation • 🤝 Contributing

---

📑 Table of Contents

• Overview
• 🎨 Interactive Gallery
• Quickstart
• Featured Inventions
• Installation
• Usage
• Methodology
• Contributing
• Resources
• License & Citation

---

Overview

This repository is an experimental open-source computational framework for analyzing Leonardo da Vinci's mechanical inventions. Using modern engineering principles, physics-based simulation, and safety analysis, we explore how da Vinci's 15th-century designs might perform when implemented with contemporary materials and methods.

🌟 Project Goals

• 📐 Digital Exploration — Create computational models of Renaissance mechanical concepts
• 🎓 Educational Resources — Develop open-source materials for STEM education
• 🔬 Technical Analysis — Apply modern simulation to historical engineering
• 🛡️ Safety Focus — Ensure all implementations prioritize safety (non-weaponized)
• 🌍 Open Collaboration — Enable community contributions to historical engineering

📜 Historical Context

Leonardo da Vinci (1452-1519) produced over 13,000 pages of notes and drawings spanning the Codex Atlanticus, Madrid Codices, Codex Leicester, and Codex on the Flight of Birds. This project explores selected civil inventions, focusing on educational applications while maintaining strict adherence to non-weaponized implementations.

---

🎨 Interactive Gallery

✨ Experience Leonardo's Genius Through 24 Interactive Web Interfaces ✨

🌐 Open the Gallery →

Built with Renaissance aesthetics, golden ratio proportions, and modern web technology

Featured Interactive Experiences

✈️ Flight Systems

Invention	Status	Experience
🚁 Aerial Screw	Breakthrough	Explore Live →
🦅 Ornithopter	Complete	Explore Live →
🪂 Parachute	Complete	Explore Live →
🎛️ Variable Pitch Mechanism	Complete	Explore Live →

🚗 Ground Transportation

Invention	Status	Experience
🛒 Self-Propelled Cart	Complete	Explore Live →
📏 Mechanical Odometer	Complete	Explore Live →
🌉 Revolving Bridge	Complete	Explore Live →

🎭 Automata & Entertainment

Invention	Status	Experience
🦁 Mechanical Lion	Complete	Explore Live →
🛡️ Armored Walker	Prototype	Explore Live →
🧶 Bobbin Winder	Complete	Explore Live →

🎵 Musical Instruments

"Music is the shaping of the invisible." — Leonardo da Vinci

Invention	Status	Experience
🎼 Mechanical Ensemble	Complete	Explore Live →
🎹 Mechanical Organ	Complete	Explore Live →
🎻 Viola Organista	Complete	Explore Live →
🎺 Mechanical Trumpeter	Complete	Explore Live →
🎶 Programmable Flute	Complete	Explore Live →
🥁 Mechanical Drum	Complete	Explore Live →
🔔 Mechanical Carillon	Complete	Explore Live →

💧 Hydraulic Systems

"Water is the driver of nature." — Leonardo da Vinci, Codex Leicester

System	Experience
🌊 Hydraulic Systems	Explore Live →

Includes: Canal locks, Archimedes screws, water wheels, pumps, and flood control

🔬 Exploration Tools

Tool	Purpose	Experience
🕸️ Cross-Pollination Explorer	Network visualization	Explore Live →
⏰ Invention Timeline	Historical journey	Explore Live →
🪞 Mirror Writing Interface	Decode Leonardo's script	Explore Live →
⚙️ Universal Machine Builder	Build mechanisms	Explore Live →

🎨 View Complete Gallery →

---

Quickstart

🚀 Get Started in 3 Steps

1️⃣ Try it now in Google Colab (no installation required):

# Open the Quickstart notebook:
# https://colab.research.google.com/github/Shannon-Labs/davinci-codex/blob/main/notebooks/Quickstart.ipynb

2️⃣ Or install locally:

pip install git+https://github.com/Shannon-Labs/davinci-codex.git

3️⃣ Run a simulation:

davinci-codex simulate --slug parachute --seed 0 --fidelity educational

4️⃣ Run tests:

make test

"Simplicity is the ultimate sophistication." — Leonardo da Vinci

---

📓 Interactive Notebooks

Explore the physics of Leonardo's inventions with our interactive Colab notebooks. These educational resources combine historical context, mathematical derivation, and real-time simulation.

Notebook	Focus	Colab Link
Aerial Screw	Aerodynamics & BEMT
Parachute	Drag & Dynamics
Ornithopter	Unsteady Aerodynamics
Variable Pitch	Swashplate Mechanics
Self-Propelled Cart	Spring Drive & Escapement
Odometer	Measurement & Error
Revolving Bridge	Statics & Balance
Mechanical Lion	Cam Programming
Armored Walker	Power & Friction
Bobbin Winder	Cam Profiles
Programmable Loom	Binary Logic
Mechanical Drum	Rhythm Sequencing
Mechanical Ensemble	Orchestration
Quickstart	CLI & Basic Usage

---

Invention registry (auto-generated)

This table is regenerated from the Python registry; run make regen-readme-table after changes to any invention module.

Slug	Title	Status	Summary
aerial_screw	Leonardo's Aerial Screw - Advanced Aerodynamic Analysis	validated	Comprehensive aerodynamic analysis of Leonardo's helical air screw using modern blade element momentum theory.
armored_walker	The Armored Walker	simulation_prototype	A walking war machine combining the chassis of the Self-Propelled Cart with the leg mechanism of the Mechanical Lion.
bobbin_winder	Automatic Bobbin Winder	prototype_ready	Cam-programmable traverse winding mechanism with tension control analysis.
mechanical_carillon	Mechanical Carillon	concept_reconstruction	Rotating drum that indexes bell strikers for programmable chimes.
mechanical_drum	Mechanical Drum	prototype_ready	Programmable percussion device with cam barrels for rhythm patterns.
mechanical_ensemble	Leonardo Mechanical Ensemble	concept_reconstruction	Coordinated simulations for Leonardo''s automated musical inventions.
mechanical_lion	Leonardo's Mechanical Lion - Complete Walking and Reveal Mechanism	validated	Reconstruction of Leonardo's cam-based walking mechanism with chest cavity reveal for the 1515 Mechanical Lion automaton.
mechanical_odometer	Leonardo's Mechanical Odometer Cart	prototype_ready	Enhanced distance-measuring cart with realistic pebble-drop physics and comprehensive error analysis.
mechanical_organ	Automatic Pipe Organ	concept_reconstruction	Self-playing pipe organ driven by pinned barrels and dual bellows.
mechanical_trumpeter	Mechanical Trumpeter	concept_reconstruction	Automated trumpeter automaton with programmable fingering and bellows-driven breath.
ornithopter	Bio-inspired Ornithopter Flight Lab	in_progress	Advanced flapping-wing flight with unsteady aerodynamics and bio-inspired mechanics.
parachute	Pyramid Parachute	prototype_ready	Modern analysis of da Vinci's pyramid-shaped parachute with advanced aerodynamic modeling, stability assessment, and historical accuracy.
programmable_flute	Programmable Flute	concept_reconstruction	Cam-driven recorder with automatic fingering and regulated airflow.
programmable_loom	Leonardo's Programmable Loom - Textile Pattern Automation	in_progress	Automatic loom concept with cam-based pattern programming for repeatable textile motifs, reconstructed from Codex Atlanticus folios 1090r-1091v.
revolving_bridge	Leonardo's Revolving Bridge - Advanced Engineering Implementation	in_progress	Leonardo da Vinci's innovative rotating bridge with water-filled counterweight system, featuring advanced mechanical analysis and educational visualization.
self_propelled_cart	Self-Propelled Cart	prototype_ready	Spring-driven cart with multi-stage gear reduction and escapement control for autonomous theatrical motion.
variable_pitch_mechanism	Variable Pitch Swashplate Mechanism	in_progress	Swashplate-based variable pitch control system for aerial screw blades
viola_organista	Viola Organista	concept_reconstruction	Continuous wheel-bowed keyboard capable of polyphonic string performance.

---

Featured Inventions

Visit our interactive gallery for detailed visualizations and technical specifications.

✈️ Flight Systems

"Once you have tasted flight, you will forever walk the earth with your eyes turned skyward."

Invention	Status	Key Achievement
Aerial Screw	🚀 Breakthrough	1,416N lift (4× improvement), variable pitch control
Ornithopter	✅ Complete	Biomimetic flight, 140 min endurance, validated aerodynamics
Parachute	✅ Complete	6.9 m/s safe descent, turbulence-tested pyramid design

🚗 Ground Transportation

Invention	Status	Key Achievement
Self-Propelled Cart	✅ Complete	First autonomous vehicle, 150m range, spring-powered
Mechanical Odometer	✅ Complete	Precision measurement (<17% error), pebble-drop counter
Revolving Bridge	✅ Complete	360° rotation, tactical engineering, water counterweight

🎭 Automata & Entertainment

Invention	Status	Key Achievement
Mechanical Lion	✅ Complete	30s choreography, synchronized movements, cam-based control
Programmable Loom	🔧 In Progress	First programmable computer, 16-thread patterns
Armored Walker	🛡️ Prototype	Quadruped gait, 200kg payload, dynamic balance

🎵 Musical Instruments & Renaissance Ensemble

"Music is the shaping of the invisible." — Leonardo da Vinci

Our Renaissance Ensemble features 6 physics-based instrument timbres, each modeled with authentic harmonic profiles:

Instrument	Timbre Profile	Key Characteristics
🎻 Viola Organista	Bowed Strings	Warm tone, strong odd harmonics, 5Hz vibrato, pink noise
🎹 Mechanical Organ	Pipe Organ	1/n harmonic series, breath noise, high sustain
🎵 Programmable Flute	Recorder	Fundamental-dominant, 8% breath noise, 4.5Hz vibrato
🔔 Mechanical Carillon	Bell System	Inharmonic partials (1, 2.4, 3.9...), long release
🎺 Mechanical Trumpeter	Brass	Bright harmonics, breath noise, 5.5Hz vibrato
🥁 Mechanical Drum	Percussion	Bessel drumhead modes, 60% noise burst, no sustain

✨ Ensemble Capabilities:

• AI Composition: Generate period-authentic music in Dorian, Mixolydian, and other church modes
• Audio Synthesis: Physics-based sound generation (not samples!) with 44.1kHz output
• Hall Reverb: Schroeder reverb (4 comb + 2 allpass filters) for court acoustics
• Visualizations: Waveform, spectrogram, and piano-roll score renders
• CLI Integration: davinci-codex concert command for full pipeline

🎵 Experience the Interactive Ensemble →

See complete inventory →

---

Installation

Prerequisites

• Python 3.9+
• Git
• 8GB RAM minimum for simulations

Setup

# Clone repository
git clone https://github.com/Shannon-Labs/davinci-codex.git
cd davinci-codex

# Create virtual environment and install
make setup

# Or manually:
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -e .

# Verify installation
make test

---

Usage

Command Line Interface

# List all inventions
davinci-codex list

# Run simulation
davinci-codex simulate --slug ornithopter --seed 42

# Generate CAD models
davinci-codex build --slug aerial_screw

# Run safety analysis
davinci-codex evaluate --slug parachute

# Execute full pipeline
davinci-codex pipeline --slug ornithopter

# 🎵 Generate a Renaissance mechanical concert
davinci-codex concert --form pavane --mode dorian --measures 16 --seed 42 --reverb 0.2

# Available forms: pavane, galliard, basse_danse, saltarello, allemande
# Available modes: dorian, mixolydian, phrygian, lydian

Python API

from davinci_codex import registry

# List inventions
inventions = registry.list_inventions()

# Get specific invention
ornithopter = registry.get_invention("ornithopter")

# Run simulation with deterministic seed
results = ornithopter.module.simulate(seed=42)

# Generate CAD models
ornithopter.module.build()

# Safety evaluation
evaluation = ornithopter.module.evaluate()

Development Commands

make test          # Run full test suite
make lint          # Run Ruff + mypy
make smoke         # Fast smoke tests
make demo          # Generate visualizations
make book          # Build Jupyter Book documentation

---

Methodology

Our computational archaeology approach combines historical research with modern engineering:

1️⃣ Historical Research

• Original codex folio examination
• Provenance documentation with manuscript references
• Dimensional recovery from Renaissance units
• Engineering intent interpretation

2️⃣ Mathematical Modeling

• Physics-based frameworks (Newtonian mechanics, fluids)
• Material property mapping (Renaissance → modern)
• Parametric design for optimization
• Constraint and safety analysis

3️⃣ Computational Simulation

• Finite element analysis and CFD with FSI
• Validation metrics (lift, stress margins, energy)
• Sensitivity analysis (Sobol indices, tornado plots)
• Uncertainty quantification (epistemic + aleatory)

4️⃣ Safety Assessment

• FMEA (Failure Mode and Effects Analysis)
• Minimum 2× safety factors on structural components
• Ethical review (non-weaponization verification)
• Modern regulatory compliance

5️⃣ Open Documentation

• MIT licensed code, CC0 media
• Seed-controlled reproducible simulations
• Comprehensive educational resources

"Experience never errs; it is only your judgments that err by promising themselves results such as are not caused by your experiments." — Leonardo da Vinci

Learn more: Adaptation Methodology • Physics Derivations

---

Contributing

"Patience serves as a protection against wrongs." — Leonardo da Vinci

We welcome contributions from engineers, historians, educators, and enthusiasts worldwide!

How to Contribute

1. Fork and clone the repository
2. Create a feature branch: git checkout -b feature/invention
3. Develop and test: make test && make lint
4. Submit a pull request with:
   • References to relevant codex folios
   • Safety analysis
   • Comprehensive tests
   • Documentation updates

Contribution Ideas

• 🔧 New Inventions — Implement additional da Vinci designs
• 📐 Enhanced Physics — Improve simulation accuracy
• 📚 Historical Research — Add manuscript references
• 🌍 Translations — Internationalize documentation
• 🎓 Educational Content — Create tutorials and guides
• 🖨️ CAD Models — Develop parametric 3D models
• 🎨 Web Interfaces — Create interactive visualizations

See: CONTRIBUTING.md • CODE_OF_CONDUCT.md

---

Resources

📖 Documentation

• Project Website — Main documentation hub
• Interactive Web Gallery ⭐ NEW! — 24 interactive experiences
• Technical Documentation — Jupyter Book essays
• Physics Derivations — Mathematical foundations

📜 Leonardo's Original Manuscripts

• Codex Atlanticus — Biblioteca Ambrosiana, Milan
• Madrid Codices — Biblioteca Nacional de España
• Codex on Flight of Birds — Smithsonian
• Leonardo Digitale Archive — Comprehensive digital collection

📚 Academic References

• Martin Kemp, "Leonardo" (Oxford University Press) — Foundational text
• e-Leo Archive — High-resolution manuscript scans
• docs/meta/REFERENCES.md — Complete bibliography

---

Educational Applications

"Study without desire spoils the memory, and it retains nothing that it takes in." — Leonardo da Vinci

This project serves as a resource for:

• 📚 STEM Education — Physics, mathematics, engineering, computer science
• 🏫 Curriculum Integration — High school demonstrations to graduate research
• 🛠️ Maker Spaces — 3D printable CAD models for hands-on learning
• 🏛️ Museum Exhibitions — Interactive displays and historical reconstructions

Available Resources

• 🎨 24 interactive web interfaces with Renaissance design
• 📓 Jupyter notebooks with guided explorations
• 🖨️ Parametric CAD models for 3D printing
• 📊 Simulation visualizations
• 📜 Historical context and provenance documentation

---

License & Citation

Code

MIT License - See licenses/LICENSE

Media

CC0 1.0 Universal - Public Domain Dedication

Citation

@software{davinci_codex_2025,
  author = {Bown, Hunter},
  title = {The da Vinci Codex: Computational Archaeology of Renaissance Mechanical Engineering},
  year = {2025},
  publisher = {GitHub},
  url = {https://github.com/Shannon-Labs/davinci-codex}
}

See CITATION.cff for structured citation metadata.

---

Acknowledgments

🎨 Special Thanks

Leonardo da Vinci — For timeless inspiration and Renaissance genius

Open Source Community — For foundational tools and collaborative spirit

Digital Archives — For preserving and sharing Leonardo's manuscripts

Shannon Labs — For computational resources and research support

---

Author: Hunter Bown, Shannon Labs Development: Built with AI assistance for code generation and documentation Design: Renaissance aesthetics meet modern web technology

---

Contact

👤 Principal Investigator: Hunter Bown 📧 Email: hunter@shannonlabs.dev 🏛️ Institution: Shannon Labs 🌐 Website: https://shannon-labs.github.io/davinci-codex/ 💻 GitHub: https://github.com/Shannon-Labs/davinci-codex

---

"Obstacles do not bend me. Every obstacle yields to stern resolve. He who is fixed to a star does not change his mind." — Leonardo da Vinci (1452-1519)

⚙️ Renaissance Engineering • 🎨 Digital Innovation • 📐 Golden Ratio Design • 🌍 Open Source Forever

---

Made with ❤️, ⚙️, and Renaissance spirit Golden ratio proportions (φ = 1.618) throughout Built for education, exploration, and eternal curiosity