Skip to content

docs: native Linux/HPC setup guide (SETUP_LINUX.md)#2

Open
wyim-pgl wants to merge 1 commit into
mainfrom
docs/linux-setup
Open

docs: native Linux/HPC setup guide (SETUP_LINUX.md)#2
wyim-pgl wants to merge 1 commit into
mainfrom
docs/linux-setup

Conversation

@wyim-pgl

Copy link
Copy Markdown
Owner

Summary

Adds SETUP_LINUX.md — a verified, non-Docker install recipe for Linux/HPC where only conda/micromamba is available.

The repo currently ships environment.yml pinned to osx-64 (macOS) plus a Dockerfile; there was no native-Linux path. This fills that gap.

What it documents (all verified end-to-end on a Linux x86-64 HPC node)

  • conda-forge c-compiler env (no system gcc / no module needed)
  • Solver-hang workaround: ~/.condarc with defaults + channel_priority: strict hangs the solve (>10 min); --override-channels -c conda-forge fixes it (~4 s)
  • Building the required Cython _accelerators + ctypes C extensions — without them the pure-Python fallbacks return empty and the tool reports 0 repeats
  • Smoke test + troubleshooting table

Verified toolchain

python 3.11.15 · numpy 2.4.6 · cython 3.2.5 · gcc 14.3.0 (conda-forge) · pydivsufsort 0.0.20 → smoke test 8 repeats.

🤖 Generated with Claude Code

Document the verified non-Docker Linux install: conda-forge compiler env,
the channel-priority solver-hang workaround (--override-channels), and the
required Cython/C extension build (without it the tool reports 0 repeats).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant