Skip to content

[Bug] README conda installation instructions specify Python 3.12 but no Python 3.10+ packages exist on aihabitat channel #2625

Description

@jayus71

Habitat-Sim version

Latest stable release (v0.3.3)

🐛 Bug

The README's "Recommended Conda Packages" section instructs users to create an environment
with python=3.12, but the aihabitat conda channel has never published builds for Python
3.10, 3.11, or 3.12. This causes conda installation to fail for all users following the
official documentation
.

Steps to Reproduce

Follow the README exactly:

  1. conda create -n habitat python=3.12 cmake=3.27
  2. conda activate habitat
  3. conda install habitat-sim withbullet headless -c conda-forge -c aihabitat

Expected behavior

Installation succeeds as described in the official documentation.

Actual behavior — conda solver fails with:

LibMambaUnsatisfiableError: Encountered problems while solving:
  - package habitat-sim-0.3.3-py3.9_headless_linux_xxx requires python >=3.9,<3.10.0a0,
    but none of the providers can be installed

Additional context

All 140+ packages published on https://anaconda.org/aihabitat/habitat-sim are built
exclusively for Python 3.9 (python >=3.9,<3.10.0a0). No Python 3.10/3.11/3.12
stable builds exist on the aihabitat channel.

The only available Python 3.10/3.11 builds are in the aihabitat-nightly channel
(version 0.3.3.2026.03.12), which is not mentioned in the documentation.

Suggested fix:
Either update the README to use python=3.9 until Python 3.10+ stable packages are
published, or document the aihabitat-nightly channel as a workaround.

Workaround (Python 3.9 stable):

conda create -n habitat python=3.9
conda activate habitat
conda install habitat-sim withbullet headless -c conda-forge -c aihabitat

Workaround (Python 3.10 nightly):

conda create -n habitat python=3.10
conda activate habitat
conda install habitat-sim withbullet headless -c conda-forge -c aihabitat-nightly

System Info

  • OS: Linux (linux-64)
  • Python version: 3.12 (as specified in README)
  • How you installed: conda, following official README instructions
  • GPU: NVIDIA (linux-64 platform)
  • Any other relevant information: Issue is reproducible on any Linux machine following
    the official documentation exactly as written.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions