Import AITURK IDE 1.0.0-beta.1 from Hermes 63279301; preserve MIT license

setup.py

@@ -0,0 +1,74 @@
+"""
+setup.py — wheel/sdist build guard.
+
+pip/PyPI and Homebrew are no longer supported distribution methods for
+Hermes Agent (see website/docs/getting-started/platform-support.md). The
+wheel would ship without bundled assets (locales, skills, optional-mcps,
+web_dist, tui_dist, plugin manifests) since those are resolved at runtime
+via env-var overrides set by the nix wrapper or the source-checkout layout.
+
+This file overrides the ``bdist_wheel`` and ``sdist`` setuptools commands
+to raise an error when run outside a Nix build. The PEP 517
+``build_wheel`` / ``build_sdist`` hooks in
+``setuptools.build_meta`` call these commands internally, so the guard
+fires for ``uv build``, ``pip wheel``, ``python -m build``, and direct
+``setup.py`` invocations alike.
+
+The one legitimate consumer of ``build_wheel`` is uv2nix, which calls
+``setuptools.build_meta.build_wheel`` (→ ``bdist_wheel``) inside a Nix
+build sandbox. ``nix/python.nix`` sets ``HERMES_NIX_BUILD=1`` on the
+Hermes package derivation, so only that build may create an artifact.
+
+Editable installs (``uv sync``, ``pip install -e .``, ``nix develop``)
+use ``build_editable``, which does NOT call ``bdist_wheel`` — it calls
+``build_ext`` in editable mode. So the guard does not affect development.
+"""
+
+import os
+
+from setuptools import setup
+from setuptools.command.sdist import sdist
+
+_IN_NIX_BUILD = os.environ.get("HERMES_NIX_BUILD") == "1"
+
+_BLOCK_MESSAGE = (
+    "Building wheels or sdists for hermes-agent is not supported.\n"
+    "Hermes is distributed via the shell installer, Docker image, or Nix.\n"
+    "See: https://hermes-agent.nousresearch.com/docs/getting-started/installation\n"
+    "\n"
+    "If you are developing, use an editable install instead:\n"
+    "  uv sync          # or: uv pip install -e .\n"
+    "\n"
+    "If you are building with Nix (uv2nix), this error should not fire —\n"
+    "the Hermes Nix derivation sets HERMES_NIX_BUILD=1. If it does, file a bug."
+)
+
+
+class _GuardedSdist(sdist):
+    def run(self, *args, **kwargs):
+        if not _IN_NIX_BUILD:
+            raise RuntimeError(_BLOCK_MESSAGE)
+        return super().run(*args, **kwargs)
+
+
+cmdclass = {"sdist": _GuardedSdist}
+
+# bdist_wheel is only available when the `wheel` package is installed.
+# setuptools.build_meta.build_wheel() calls it internally, so the guard
+# fires for all PEP 517 wheel build paths. Define the subclass only when
+# the import succeeds — otherwise a None base class raises TypeError at
+# class-definition time, before the cmdclass guard can run.
+try:
+    from setuptools.command.bdist_wheel import bdist_wheel
+
+    class _GuardedBdistWheel(bdist_wheel):
+        def run(self, *args, **kwargs):
+            if not _IN_NIX_BUILD:
+                raise RuntimeError(_BLOCK_MESSAGE)
+            return super().run(*args, **kwargs)
+
+    cmdclass["bdist_wheel"] = _GuardedBdistWheel
+except ImportError:
+    pass
+
+setup(cmdclass=cmdclass)