<div align="center">

Darwin

</div>

---

⚠️ Important Notice

This is alpha software! Use at your own risk. While we're working hard to make it stable, bugs are expected. Perfect for learning and prototyping! 🧪

---

Overview

Darwin is a powerful Lua compiler that transforms your Lua scripts into standalone executables. It provides a streamlined interface for compilation, eliminating the complexity of traditional build systems:

1. Write your Lua code
2. Compile to executable
3. Deploy anywhere

This compiler is designed for developers who need to:

• Create standalone applications from Lua scripts
• Embed files and resources into executables
• Mix Lua with native C code seamlessly
• Deploy applications without dependencies

Key Features

• Multi-platform compilation - Create executables for Windows, Linux, and more
• File embedding - Bundle resources directly into your executable
• C/C++ integration - Mix Lua with native code
• Zero dependencies - Your compiled programs run anywhere
• Lua amalgamation - Single file distribution
• SO library generation - Create shared libraries from Lua code

Linux Installation

curl -L https://github.com/OUIsolutions/Darwin/releases/download/0.20.0/darwin_linux_bin.out -o darwin.out && chmod +x darwin.out &&   mv darwin.out /usr/local/bin/darwin 

Mac-Os Instalation

curl -L https://github.com/OUIsolutions/Darwin/releases/download/0.20.0/darwin.c -o darwin.c && gcc darwin.c -o darwin.out && sudo mv darwin.out /usr/local/bin/darwin && rm darwin.c 

AI/LLM Integration

Want to learn how to use Darwin with AI assistance? Download the ai_doc.md file and paste its contents to your preferred AI assistant (ChatGPT, Claude, Copilot, etc.) for interactive learning and code examples.

---

Releases

| File | What is | |---------------------------------------------------------------------------------------------------------------------|--------------------------------------------| |darwin.c | A Amalgamation Containing all the Library | |darwin_linux_bin.out | Ready-to-use Linux binary | |darwini32.exe | Ready-to-use Windows 32-bit executable | |darwin.deb | Debian package for easy installation | |darwin.rpm | RPM package for easy installation |

Public API

Click here Public API to see the full list of public API functions.

Usage Tutorials

| Tutorial | Description | |-----------------------------------------------------------------|---------------------------------------------------------| | API Usage | Working with Darwin's API | | Build Guide | Building Darwin from source | | CLI Usage | Command line interface guide | | Dependencies | Understanding project dependencies |

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---