Better documentation about building quadrants

[v01dXYZ]

I tried to compile quadrants v0.4.5 using pip install/build but it was harder than expected:

• build-isolation from pip creates friction with pybind11-stubs that needs the packages installed
• I've got an issue with symbol not found typeinfo llvm::ModulePass, I don't know the reason. Maybe it needs a LLVM with RTTI.

Except those two problems, it seems to compile fine.

[hughperkins]

Hi Robert,

Thank you!

For the issue with 'symbol not found', is this an error or a warning? If a warning, does this occur also in our CI? If it's an error, or a warning that doesn't occur in our CI, then perhaps you could consider comparing your build process with the CI build?. You can find the various scripts linked from:

• Windows: https://github.com/Genesis-Embodied-AI/quadrants/blob/main/.github/workflows/win.yml
• linux: https://github.com/Genesis-Embodied-AI/quadrants/blob/main/.github/workflows/linux.yml
• Mac: https://github.com/Genesis-Embodied-AI/quadrants/blob/main/.github/workflows/macosx.yml

Note that I find that Opus 4.6 AI model is very powerful for diagnosing the root cause in these kinds of issues, so I recommend trying asking Opus 4.6. Make sure to give Opus 4.6 the paths of the build scripts above.

[v01dXYZ]

It's an error. The problem with symbol not found typeinfo llvm::ModulePass is a (dynamic) linking error that occurs when loading the extension with Python. If LLVM has RTTI enabled, it doesn't happen.

When removing all the classes inheriting llvm::ModulePass, the package compiles fine (ie there is no other llvm objects needing RTTI). I didn't take a look long enough to the code base why RTTI is required.

Edit: Using llvm-config, actually it seems debian and the version of llvm-22 you provide through download_llvm has RTTI enabled.