hercules is a high-performance AOT compiler that compiles Python code to native machine code or c++ code without any runtime overhead. Typical speedups over Python are on the order of 100x or more.

The Hercules framework is fully modular and extensible, allowing for the seamless integration of new modules, compiler optimizations, domain-specific languages and so on. We actively work with hercules to interact with Elastic AI Search.

hercules is a high-performance AOT compiler and jit code to run, see the benchmarks below.

Contents

WELCOME TO HERCULES

• Welcome to EA Hercules

QUICK STARTED

• Installing Hercules
  • try with docker
  • binary install
  • run a jupyter notebook server:
  • build in docker
  • source install
  • export PATH
• Command Line Interface
  • version
  • run
  • build
  • jit
• Sneak Peek
  • hello world
  • run jit
  • build to binary
  • build to shared library
  • call from hs
  • call from C
  • call from C++
• jupyter notebook support
  • plugins support
  • fibonacci example

TUTORIALS

• Foundation
  • Print
  • Comments
  • Literals
  • Assignments and operators
  • Control flow
    • If statements
    • Loops
  • Imports
  • Exceptions
  • Context life cycle
  • Statics
  • Static evaluation
• Collections
  • Comprehensions
  • Tuples
  • Strong typing
• Functions
  • Restrict function Arguments and Return Types
  • partial specialization of the function arguments:
  • Default and named arguments
  • Optional Arguments
  • implicit Optional Arguments
  • Generics
  • Generators
• Classes
  • generic
  • References
  • Inheritance
  • Named tuples
  • static class methods
  • static class variables
  • Type extensions
  • Magic methods
• Types and features
  • Arbitrary-width foundational types
  • Pointers
  • Static arrays

ADVANCED

• Integration
  • C/C++ integration
  • Python integration
  • Jupyter integration
• Exporting
  • C/C++ export
  • Python export
• Plugins
  • Plugins configure
  • Pure hs plugins
  • C++ plugins
• Intermediate representation
  • IR Structure
  • Uses
  • IR API
  • Custom types
  • IR pass pipeline
  • transform pass example

LLVM

• LLVM Introduction