Skip to content

docs: document tested Conda CPU installation - #231

Merged
LauraGPT merged 1 commit into
mainfrom
docs/conda-install-20261101
Oct 31, 2026
Merged

LauraGPT merged 1 commit into
mainfrom
docs/conda-install-20261101

Conversation

@LauraGPT

Copy link
Copy Markdown
Collaborator

Summary

Document a Conda alternative in the bilingual installation guide, based on the
actual isolated CPU installation reported in #230. Keep the same interpreter
for installation, dependency checks and startup. Explain how preconfigured
Linux images can inject foreign PyTorch shared libraries despite pip check
passing, and preserve other library paths needed by FFmpeg.

User impact

Users who prefer Conda no longer need to infer the environment commands from
the venv example or search issue comments. This changes documentation only;
requirements, model loading, clipping, provider routing and all runtime source
remain byte-identical. Refs #230; do not auto-close the reporter's issue.

Validation

  • Existing installation/CLI/Gradio selection: 14 passed, zero skips on this
    documentation tree. Four Bash blocks pass bash -n.
  • Guide anchors and existing source links reviewed. The fixed evidence link
    points to 求一个conda虚拟环境的安装命令,不是很喜欢用uv #230 (comment).
  • Reused exact, hash-verified previous CPU installation evidence because no
    runtime or requirements bytes changed: Conda 26.9.4, Python 3.12.16,
    torch/torchaudio 2.10.0+cpu, all 132 original requirement RECORDs complete;
    real native imports/resampling, CLI help, Gradio, and synthetic video
    encoding/decoding/audio extraction with installed FunASR audio loading passed.
    The environment and experiments were not redundantly rebuilt or rerun.
  • Full bare python -m pytest -q is not green: collection imports the legacy
    funclip/test/imagemagick_test.py demo, which calls MoviePy TextClip and fails
    because the configured ImageMagick executable is unset. This unchanged demo
    also references an external example video. The collection error and complete
    traceback are retained; the passing focused checks are not a full-suite claim.
  • The prior install's explicit timeout, erroneous initial metadata-probe scope,
    cached completion of only 14 missing packages, and foreign-library import
    failure are preserved. The accepted child environment removes only the foreign
    system torch/lib entry, not all of LD_LIBRARY_PATH; no shared environment
    or production service was changed.
  • No pretrained model download/inference, ASR-quality acceptance, GPU validation,
    paid provider call, public server startup, or Nano leaderboard work occurred.

Screenshots or clips

Not applicable to a documentation-only change. The previous synthetic CPU media
fixture verifies I/O only, not recognition-to-clipping quality.

Notes for reviewers

Review was performed inline by the author under the user's explicit autonomous
maintenance authorization, not presented as an independent GitHub approval.
No review or other protection setting is changed. Exact-head CI, a normal merge
and final-main CI/log acceptance remain required. No release/PyPI operation.
Human-facing prose has no new string-presence tests; real installation evidence,
shell syntax and the repository's existing relevant checks establish the scope.

Refs #230. Keep installation and native-library diagnostics scoped to one environment.

Signed-off-by: LauraGPT <zhifu.gzf@alibaba-inc.com>
@LauraGPT
LauraGPT merged commit 2c9408f into main Oct 31, 2026
1 check passed
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