Darwin 🧬

The Most Advanced Lua Compiler - Transform your Lua code into powerful executables

🎯 What can Darwin do?

Darwin is a powerful Lua compiler that transforms your Lua scripts into:

Output Type	Description	Perfect for
🐧 Linux Executable	Standalone binary for Linux	Servers, CLI tools
🪟 Windows Executable	Standalone .exe for Windows	Desktop apps, utilities
⚙️ C/C++ Code	Generated C source code	Integration, performance
📚 SO Library	Shared object libraries	Modular applications
🔗 Lua Amalgamation	Single Lua file	Distribution, embedding

✨ Why Choose Darwin?

• 📁 Embed Files & Folders - Bundle resources directly into your executable
• 🔧 C/C++ Integration - Mix Lua with native C code seamlessly
• ⚡ Compile-time Magic - Manipulate code during compilation
• 🎨 Zero Dependencies - Your compiled programs run anywhere
• 🚀 Lightning Fast - Optimized compilation and execution

🚀 Quick Start (30 seconds!)

Step 1: Create a simple Lua file

-- hello.lua
print("Hello from Darwin! 🧬")
print("This is now a compiled executable!")

Step 2: Compile it

darwin hello.lua -o hello.out

Step 3: Run it

./hello.out

That's it! You've just created your first compiled Lua program! 🎉

📦 Installation

🐧 Linux (One-liner)

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

🪟 Windows

Download darwin.exe and add it to your PATH

📋 Download Options

Platform	File	Size	Description
🐧 Linux	darwin.out	~2MB	Ready-to-use Linux binary
🪟 Windows	darwin.exe	~2MB	Ready-to-use Windows executable
📄 Source	darwin.c	~500KB	C amalgamation for compilation

🎓 Learning Resources

📖 Documentation

Guide	Difficulty	Description
🚀 Quick Start Examples	Beginner	Get started in 30 seconds
🖥️ Command Line Usage	Beginner	All CLI commands explained
🔧 API Usage	Intermediate	Advanced project creation
🏗️ Build Guide	Advanced	Build from source
📚 Dependencies	Reference	License information

🎯 Common Use Cases

🛠️ Command Line Tools

Perfect for creating system utilities and CLI applications:

# Create a file manager
darwin file_manager.lua -o fm.out

# Create a text processor
darwin text_processor.lua -o process.out

🌐 Web Applications

Build web servers and APIs:

# Simple web server
darwin web_server.lua -o server.out

# REST API
darwin api.lua -o api.out

🎮 Games & Interactive Apps

Create games and interactive applications:

# Simple game
darwin game.lua -o game.out

# Interactive quiz
darwin quiz.lua -o quiz.out

⚙️ System Integration

Integrate with existing C/C++ projects:

# Generate C library
darwin my_logic.lua -o liblogic.so

# Create C header
darwin logic.lua -output-type c-header

🤝 Community & Support

• 🐛 Found a bug? Open an issue
• 💡 Have an idea? Start a discussion
• 📖 Need help? Check our documentation
• 🌟 Like Darwin? Give us a star on GitHub!

🏆 Why Darwin is Special

Darwin isn't just another compiler - it's a complete ecosystem for Lua development:

Feature	Traditional Lua	Darwin
Distribution	Script files	Single executable
Dependencies	External libs	Everything embedded
Performance	Interpreted	Compiled optimization
Integration	Lua only	Lua + C seamlessly
Deployment	Complex setup	Drop and run

---

Made with ❤️ by the OUI Solutions team

⭐ Star us on GitHub • 📖 Read the docs • 🚀 Try Darwin now