[Setup]: Failed to install on Android with termux, reporting failed to build psutil

[kamperfer]

What's Going Wrong?

I tried to install hermes agent on android 13 and 16 devices following termux guide, but all of them failed at "4. Install the tested Termux bundle".

Steps Taken

Strictly follow the "Hermes on Android with Termux" guide, option 2.
But failed at the command "python -m pip install -e '.[termux]' -c constraints-termux.txt", error info is:

Collecting psutil==7.2.2 (from hermes-agent==0.14.0)
Using cached psutil-7.2.2.tar.gz (493 kB)
Installing build dependencies ... done
Getting requirements to build wheel ... error
error: subprocess-exited-with-error

× Getting requirements to build wheel did not run successfully.
│ exit code: 1
╰─> [1 lines of output]
platform android is not supported
[end of output]

note: This error originates from a subprocess, and is likely not a problem with pip.
ERROR: Failed to build 'psutil' when getting requirements to build wheel

Installation Method

Install script (curl | bash)

Operating System

Android 13 and 16

Python Version

Python 3.13.13

Hermes Version

Fail to install

Debug Report

Full Error Output

(venv) ~/hermes-agent $ python -m pip install -e '.[termux]' -c constraints-termux.txt
Obtaining file:///data/data/com.termux/files/home/hermes-agent
  Installing build dependencies ... done
  Checking if build backend supports build_editable ... done
  Getting requirements to build editable ... done
  Preparing editable metadata (pyproject.toml) ... done
Collecting openai==2.24.0 (from hermes-agent==0.14.0)
  Using cached openai-2.24.0-py3-none-any.whl.metadata (29 kB)
Collecting python-dotenv==1.2.2 (from hermes-agent==0.14.0)
  Using cached python_dotenv-1.2.2-py3-none-any.whl.metadata (27 kB)
Collecting fire==0.7.1 (from hermes-agent==0.14.0)
  Using cached fire-0.7.1-py3-none-any.whl.metadata (5.8 kB)
Collecting httpx==0.28.1 (from httpx[socks]==0.28.1->hermes-agent==0.14.0)
  Using cached httpx-0.28.1-py3-none-any.whl.metadata (7.1 kB)
Collecting rich==14.3.3 (from hermes-agent==0.14.0)
  Using cached rich-14.3.3-py3-none-any.whl.metadata (18 kB)
Collecting tenacity==9.1.4 (from hermes-agent==0.14.0)
  Using cached tenacity-9.1.4-py3-none-any.whl.metadata (1.2 kB)
Collecting pyyaml==6.0.3 (from hermes-agent==0.14.0)
  Using cached pyyaml-6.0.3.tar.gz (130 kB)
  Installing build dependencies ... done
  Getting requirements to build wheel ... done
  Preparing metadata (pyproject.toml) ... done
Collecting ruamel.yaml==0.18.17 (from hermes-agent==0.14.0)
  Using cached ruamel_yaml-0.18.17-py3-none-any.whl.metadata (27 kB)
Collecting requests==2.33.0 (from hermes-agent==0.14.0)
  Using cached requests-2.33.0-py3-none-any.whl.metadata (5.1 kB)
Collecting jinja2==3.1.6 (from hermes-agent==0.14.0)
  Using cached jinja2-3.1.6-py3-none-any.whl.metadata (2.9 kB)
Collecting pydantic==2.13.4 (from hermes-agent==0.14.0)
  Using cached pydantic-2.13.4-py3-none-any.whl.metadata (109 kB)
Collecting prompt_toolkit==3.0.52 (from hermes-agent==0.14.0)
  Using cached prompt_toolkit-3.0.52-py3-none-any.whl.metadata (6.4 kB)
Collecting croniter==6.0.0 (from hermes-agent==0.14.0)
  Using cached croniter-6.0.0-py2.py3-none-any.whl.metadata (32 kB)
Collecting PyJWT==2.12.1 (from PyJWT[crypto]==2.12.1->hermes-agent==0.14.0)
  Using cached pyjwt-2.12.1-py3-none-any.whl.metadata (4.1 kB)
Collecting psutil==7.2.2 (from hermes-agent==0.14.0)
  Using cached psutil-7.2.2.tar.gz (493 kB)
  Installing build dependencies ... done
  Getting requirements to build wheel ... error
  error: subprocess-exited-with-error

  × Getting requirements to build wheel did not run successfully.
  │ exit code: 1
  ╰─> [1 lines of output]
      platform android is not supported
      [end of output]

  note: This error originates from a subprocess, and is likely not a problem with pip.
ERROR: Failed to build 'psutil' when getting requirements to build wheel

What I've Already Tried

Tried to fix psutil issue on android but doesn't work:
termux-user-repository/tur#2297
giampaolo/psutil#2743 (comment)

[alt-glitch]

Related: PR #22901 (merged) addressed end-to-end Termux install. Also see #22814 (psutil android patch, closed), #23122 (psutil sdist extraction security, open), #26891 (Termux on kernel 4.19).

psutil>=7.x explicitly rejects Android (platform android is not supported). The merged #22901 fix patched around this — if that patch is no longer being applied during install, this is a regression in the install script/constraints.

[him007]

Use install_psutil_android.py will be better.
The page about termux need update, or manual install will fail.

cd /data/data/com.termux/files/home/.hermes/hermes-agent && source venv/bin/activate && python scripts/install_psutil_android.py
python -m pip install -e '.[termux-all]' -c constraints-termux.txt

This should works
Or try

1. Install python-psutil
2. Symlink to venv
3. Retry

pkg install python-psutil
ln -s /data/data/com.termux/files/usr/lib/python3.13/site-packages/psutil* /data/data/com.termux/files/home/.hermes/hermes-agent/venv/lib/python3.13/site-packages/
cd /data/data/com.termux/files/home/.hermes/hermes-agent && source venv/bin/activate && python -m pip install -e '.[termux-all]' -c constraints-termux.txt

[AAAHQZ]

1. Install python-psutil
2. Symlink to venv
3. Retry

pkg install python-psutil
ln -s /data/data/com.termux/files/usr/lib/python3.13/site-packages/psutil* /data/data/com.termux/files/home/.hermes/hermes-agent/venv/lib/python3.13/site-packages/
cd /data/data/com.termux/files/home/.hermes/hermes-agent && source venv/bin/activate && python -m pip install -e '.[termux-all]' -c constraints-termux.txt

It works

[kamperfer]

1. Install python-psutil
2. Symlink to venv
3. Retry

pkg install python-psutil
ln -s /data/data/com.termux/files/usr/lib/python3.13/site-packages/psutil* /data/data/com.termux/files/home/.hermes/hermes-agent/venv/lib/python3.13/site-packages/
cd /data/data/com.termux/files/home/.hermes/hermes-agent && source venv/bin/activate && python -m pip install -e '.[termux-all]' -c constraints-termux.txt

Works for me, thanks a lot!

[Fortifier1]

Use install_psutil_android.py will be better. The page about termux need update, or manual install will fail.

cd /data/data/com.termux/files/home/.hermes/hermes-agent && source venv/bin/activate && python install_psutil_android.py
python -m pip install -e '.[termux-all]' -c constraints-termux.txt

This should works Or try

1. Install python-psutil
2. Symlink to venv
3. Retry

pkg install python-psutil
ln -s /data/data/com.termux/files/usr/lib/python3.13/site-packages/psutil* /data/data/com.termux/files/home/.hermes/hermes-agent/venv/lib/python3.13/site-packages/
cd /data/data/com.termux/files/home/.hermes/hermes-agent && source venv/bin/activate && python -m pip install -e '.[termux-all]' -c constraints-termux.txt

I tried both ways. now i'm getting

Obtaining file:///data/data/com.termux/files/home/hermes-agent
  Installing build dependencies ... done
  Checking if build backend supports build_editable ... done
  Getting requirements to build editable ... done
  Preparing editable metadata (pyproject.toml) ... done
Collecting openai==2.24.0 (from hermes-agent==0.15.1)
  Using cached openai-2.24.0-py3-none-any.whl.metadata (29 kB)
Collecting python-dotenv==1.2.2 (from hermes-agent==0.15.1)
  Using cached python_dotenv-1.2.2-py3-none-any.whl.metadata (27 kB)
Collecting fire==0.7.1 (from hermes-agent==0.15.1)
  Using cached fire-0.7.1-py3-none-any.whl.metadata (5.8 kB)
Collecting httpx==0.28.1 (from httpx[socks]==0.28.1->hermes-agent==0.15.1)
  Using cached httpx-0.28.1-py3-none-any.whl.metadata (7.1 kB)
Collecting rich==14.3.3 (from hermes-agent==0.15.1)
  Using cached rich-14.3.3-py3-none-any.whl.metadata (18 kB)
Collecting tenacity==9.1.4 (from hermes-agent==0.15.1)
  Using cached tenacity-9.1.4-py3-none-any.whl.metadata (1.2 kB)
Collecting pyyaml==6.0.3 (from hermes-agent==0.15.1)
  Using cached pyyaml-6.0.3.tar.gz (130 kB)
  Installing build dependencies ... done
  Getting requirements to build wheel ... done
  Preparing metadata (pyproject.toml) ... done
Collecting ruamel.yaml==0.18.17 (from hermes-agent==0.15.1)
  Using cached ruamel_yaml-0.18.17-py3-none-any.whl.metadata (27 kB)
Collecting requests==2.33.0 (from hermes-agent==0.15.1)
  Using cached requests-2.33.0-py3-none-any.whl.metadata (5.1 kB)
Collecting jinja2==3.1.6 (from hermes-agent==0.15.1)
  Using cached jinja2-3.1.6-py3-none-any.whl.metadata (2.9 kB)
Collecting pydantic==2.13.4 (from hermes-agent==0.15.1)
  Using cached pydantic-2.13.4-py3-none-any.whl.metadata (109 kB)
Collecting prompt_toolkit==3.0.52 (from hermes-agent==0.15.1)
  Using cached prompt_toolkit-3.0.52-py3-none-any.whl.metadata (6.4 kB)
Collecting croniter==6.0.0 (from hermes-agent==0.15.1)
  Using cached croniter-6.0.0-py2.py3-none-any.whl.metadata (32 kB)
Collecting PyJWT==2.12.1 (from PyJWT[crypto]==2.12.1->hermes-agent==0.15.1)
  Using cached pyjwt-2.12.1-py3-none-any.whl.metadata (4.1 kB)
Requirement already satisfied: psutil==7.2.2 in ./venv/lib/python3.13/site-packages (from hermes-agent==0.15.1) (7.2.2)
Collecting fastapi<1,>=0.104.0 (from hermes-agent==0.15.1)
  Downloading fastapi-0.136.3-py3-none-any.whl.metadata (27 kB)
Collecting uvicorn<1,>=0.24.0 (from uvicorn[standard]<1,>=0.24.0->hermes-agent==0.15.1)
  Downloading uvicorn-0.48.0-py3-none-any.whl.metadata (6.7 kB)
Collecting ptyprocess<1,>=0.7.0 (from hermes-agent==0.15.1)
  Downloading ptyprocess-0.7.0-py2.py3-none-any.whl.metadata (1.3 kB)
Collecting python-dateutil (from croniter==6.0.0->hermes-agent==0.15.1)
  Downloading python_dateutil-2.9.0.post0-py2.py3-none-any.whl.metadata (8.4 kB)
Collecting pytz>2021.1 (from croniter==6.0.0->hermes-agent==0.15.1)
  Downloading pytz-2026.2-py2.py3-none-any.whl.metadata (22 kB)
Collecting termcolor (from fire==0.7.1->hermes-agent==0.15.1)
  Downloading termcolor-3.3.0-py3-none-any.whl.metadata (6.5 kB)
Collecting anyio (from httpx==0.28.1->httpx[socks]==0.28.1->hermes-agent==0.15.1)
  Downloading anyio-4.13.0-py3-none-any.whl.metadata (4.5 kB)
Collecting certifi (from httpx==0.28.1->httpx[socks]==0.28.1->hermes-agent==0.15.1)
  Downloading certifi-2026.5.20-py3-none-any.whl.metadata (2.5 kB)
Collecting httpcore==1.* (from httpx==0.28.1->httpx[socks]==0.28.1->hermes-agent==0.15.1)
  Downloading httpcore-1.0.9-py3-none-any.whl.metadata (21 kB)
Collecting idna (from httpx==0.28.1->httpx[socks]==0.28.1->hermes-agent==0.15.1)
  Downloading idna-3.17-py3-none-any.whl.metadata (6.4 kB)
Collecting socksio==1.* (from httpx[socks]==0.28.1->hermes-agent==0.15.1)
  Downloading socksio-1.0.0-py3-none-any.whl.metadata (6.1 kB)
Collecting MarkupSafe>=2.0 (from jinja2==3.1.6->hermes-agent==0.15.1)
  Downloading markupsafe-3.0.3.tar.gz (80 kB)
  Installing build dependencies ... done
  Getting requirements to build wheel ... done
  Preparing metadata (pyproject.toml) ... done
Collecting distro<2,>=1.7.0 (from openai==2.24.0->hermes-agent==0.15.1)
  Downloading distro-1.9.0-py3-none-any.whl.metadata (6.8 kB)
Collecting jiter<1,>=0.10.0 (from openai==2.24.0->hermes-agent==0.15.1)
  Downloading jiter-0.15.0.tar.gz (166 kB)
  Installing build dependencies ... done
  Getting requirements to build wheel ... done
  Preparing metadata (pyproject.toml) ... error
  error: subprocess-exited-with-error

  × Preparing metadata (pyproject.toml) did not run successfully.
  │ exit code: 1
  ╰─> [8 lines of output]
      🐍 Found CPython 3.13 at /data/data/com.termux/files/home/hermes-agent/venv/bin/python
      🔗 Found pyo3 bindings
      📡 Using build options features, bindings from pyproject.toml
      💥 maturin failed
        Caused by: Unsupported Android architecture: armv8l
      Error running maturin: Command '['maturin', 'pep517', 'write-dist-info', '--metadata-directory', '/data/data/com.termux/files/usr/tmp/pip-modern-metadata-l0fqygc6', '--interpreter', '/data/data/com.termux/files/home/hermes-agent/venv/bin/python']' returned non-zero exit status 1.
      Checking for Rust toolchain....
      Running `maturin pep517 write-dist-info --metadata-directory /data/data/com.termux/files/usr/tmp/pip-modern-metadata-l0fqygc6 --interpreter /data/data/com.termux/files/home/hermes-agent/venv/bin/python`
      [end of output]

  note: This error originates from a subprocess, and is likely not a problem with pip.
error: metadata-generation-failed

× Encountered error while generating package metadata.
╰─> jiter

note: This is an issue with the package mentioned above, not pip.
hint: See above for details.

anyone any ideas for my setup?

[him007]

Use install_psutil_android.py will be better. The page about termux need update, or manual install will fail.

cd /data/data/com.termux/files/home/.hermes/hermes-agent && source venv/bin/activate && python install_psutil_android.py
python -m pip install -e '.[termux-all]' -c constraints-termux.txt

This should works Or try

1. Install python-psutil
2. Symlink to venv
3. Retry

pkg install python-psutil
ln -s /data/data/com.termux/files/usr/lib/python3.13/site-packages/psutil* /data/data/com.termux/files/home/.hermes/hermes-agent/venv/lib/python3.13/site-packages/
cd /data/data/com.termux/files/home/.hermes/hermes-agent && source venv/bin/activate && python -m pip install -e '.[termux-all]' -c constraints-termux.txt

I tried both ways. now i'm getting

Obtaining file:///data/data/com.termux/files/home/hermes-agent
Installing build dependencies ... done
Checking if build backend supports build_editable ... done
Getting requirements to build editable ... done
Preparing editable metadata (pyproject.toml) ... done
Collecting openai==2.24.0 (from hermes-agent==0.15.1)
Using cached openai-2.24.0-py3-none-any.whl.metadata (29 kB)
Collecting python-dotenv==1.2.2 (from hermes-agent==0.15.1)
Using cached python_dotenv-1.2.2-py3-none-any.whl.metadata (27 kB)
Collecting fire==0.7.1 (from hermes-agent==0.15.1)
Using cached fire-0.7.1-py3-none-any.whl.metadata (5.8 kB)
Collecting httpx==0.28.1 (from httpx[socks]==0.28.1->hermes-agent==0.15.1)
Using cached httpx-0.28.1-py3-none-any.whl.metadata (7.1 kB)
Collecting rich==14.3.3 (from hermes-agent==0.15.1)
Using cached rich-14.3.3-py3-none-any.whl.metadata (18 kB)
Collecting tenacity==9.1.4 (from hermes-agent==0.15.1)
Using cached tenacity-9.1.4-py3-none-any.whl.metadata (1.2 kB)
Collecting pyyaml==6.0.3 (from hermes-agent==0.15.1)
Using cached pyyaml-6.0.3.tar.gz (130 kB)
Installing build dependencies ... done
Getting requirements to build wheel ... done
Preparing metadata (pyproject.toml) ... done
Collecting ruamel.yaml==0.18.17 (from hermes-agent==0.15.1)
Using cached ruamel_yaml-0.18.17-py3-none-any.whl.metadata (27 kB)
Collecting requests==2.33.0 (from hermes-agent==0.15.1)
Using cached requests-2.33.0-py3-none-any.whl.metadata (5.1 kB)
Collecting jinja2==3.1.6 (from hermes-agent==0.15.1)
Using cached jinja2-3.1.6-py3-none-any.whl.metadata (2.9 kB)
Collecting pydantic==2.13.4 (from hermes-agent==0.15.1)
Using cached pydantic-2.13.4-py3-none-any.whl.metadata (109 kB)
Collecting prompt_toolkit==3.0.52 (from hermes-agent==0.15.1)
Using cached prompt_toolkit-3.0.52-py3-none-any.whl.metadata (6.4 kB)
Collecting croniter==6.0.0 (from hermes-agent==0.15.1)
Using cached croniter-6.0.0-py2.py3-none-any.whl.metadata (32 kB)
Collecting PyJWT==2.12.1 (from PyJWT[crypto]==2.12.1->hermes-agent==0.15.1)
Using cached pyjwt-2.12.1-py3-none-any.whl.metadata (4.1 kB)
Requirement already satisfied: psutil==7.2.2 in ./venv/lib/python3.13/site-packages (from hermes-agent==0.15.1) (7.2.2)
Collecting fastapi<1,>=0.104.0 (from hermes-agent==0.15.1)
Downloading fastapi-0.136.3-py3-none-any.whl.metadata (27 kB)
Collecting uvicorn<1,>=0.24.0 (from uvicorn[standard]<1,>=0.24.0->hermes-agent==0.15.1)
Downloading uvicorn-0.48.0-py3-none-any.whl.metadata (6.7 kB)
Collecting ptyprocess<1,>=0.7.0 (from hermes-agent==0.15.1)
Downloading ptyprocess-0.7.0-py2.py3-none-any.whl.metadata (1.3 kB)
Collecting python-dateutil (from croniter==6.0.0->hermes-agent==0.15.1)
Downloading python_dateutil-2.9.0.post0-py2.py3-none-any.whl.metadata (8.4 kB)
Collecting pytz>2021.1 (from croniter==6.0.0->hermes-agent==0.15.1)
Downloading pytz-2026.2-py2.py3-none-any.whl.metadata (22 kB)
Collecting termcolor (from fire==0.7.1->hermes-agent==0.15.1)
Downloading termcolor-3.3.0-py3-none-any.whl.metadata (6.5 kB)
Collecting anyio (from httpx==0.28.1->httpx[socks]==0.28.1->hermes-agent==0.15.1)
Downloading anyio-4.13.0-py3-none-any.whl.metadata (4.5 kB)
Collecting certifi (from httpx==0.28.1->httpx[socks]==0.28.1->hermes-agent==0.15.1)
Downloading certifi-2026.5.20-py3-none-any.whl.metadata (2.5 kB)
Collecting httpcore==1.* (from httpx==0.28.1->httpx[socks]==0.28.1->hermes-agent==0.15.1)
Downloading httpcore-1.0.9-py3-none-any.whl.metadata (21 kB)
Collecting idna (from httpx==0.28.1->httpx[socks]==0.28.1->hermes-agent==0.15.1)
Downloading idna-3.17-py3-none-any.whl.metadata (6.4 kB)
Collecting socksio==1.* (from httpx[socks]==0.28.1->hermes-agent==0.15.1)
Downloading socksio-1.0.0-py3-none-any.whl.metadata (6.1 kB)
Collecting MarkupSafe>=2.0 (from jinja2==3.1.6->hermes-agent==0.15.1)
Downloading markupsafe-3.0.3.tar.gz (80 kB)
Installing build dependencies ... done
Getting requirements to build wheel ... done
Preparing metadata (pyproject.toml) ... done
Collecting distro<2,>=1.7.0 (from openai==2.24.0->hermes-agent==0.15.1)
Downloading distro-1.9.0-py3-none-any.whl.metadata (6.8 kB)
Collecting jiter<1,>=0.10.0 (from openai==2.24.0->hermes-agent==0.15.1)
Downloading jiter-0.15.0.tar.gz (166 kB)
Installing build dependencies ... done
Getting requirements to build wheel ... done
Preparing metadata (pyproject.toml) ... error
error: subprocess-exited-with-error

× Preparing metadata (pyproject.toml) did not run successfully.
│ exit code: 1
╰─> [8 lines of output]
🐍 Found CPython 3.13 at /data/data/com.termux/files/home/hermes-agent/venv/bin/python
🔗 Found pyo3 bindings
📡 Using build options features, bindings from pyproject.toml
💥 maturin failed
Caused by: Unsupported Android architecture: armv8l
Error running maturin: Command '['maturin', 'pep517', 'write-dist-info', '--metadata-directory', '/data/data/com.termux/files/usr/tmp/pip-modern-metadata-l0fqygc6', '--interpreter', '/data/data/com.termux/files/home/hermes-agent/venv/bin/python']' returned non-zero exit status 1.
Checking for Rust toolchain....
Running maturin pep517 write-dist-info --metadata-directory /data/data/com.termux/files/usr/tmp/pip-modern-metadata-l0fqygc6 --interpreter /data/data/com.termux/files/home/hermes-agent/venv/bin/python
[end of output]

note: This error originates from a subprocess, and is likely not a problem with pip.
error: metadata-generation-failed

× Encountered error while generating package metadata.
╰─> jiter

note: This is an issue with the package mentioned above, not pip.
hint: See above for details.
anyone any ideas for my setup?

can not build jiter.
try run and write into ~/.bashrc or ~/.zshrc

export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
export CARGO_BUILD_TARGET="aarch64-linux-android"

[Fortifier1]

had to use CARGO_BUILD_TARGET="armv7-linux-androideabi" because of my armv8l architecture. It's just a 32bit machine. Now its working. Thanks for your comment

[lifuyue]

I checked current main: the one-line Termux installer already prebuilds psutil via scripts/install_psutil_android.py, so the main installer path looks covered by #22901. The remaining gap seems to be the manual Termux guide: it still jumps straight to python -m pip install -e '.[termux]' -c constraints-termux.txt without the psutil shim step.

I'm preparing a small docs fix for the manual path, including the psutil shim step and the 32-bit armv8l / CARGO_BUILD_TARGET note from this thread.