tools-only Android Version via Termux Terminal
You can run AgentMake AI on Android via Termux.
Do NOT use Play Store to Install Termux
The following instructions install the offical termux package downloaded from github repository.
FIRST, Give Permission to Chrome App
We will describe how to install the Termux apk file via Chrome app, but first you need to enable your Chrome app to install unknown app.
Go to
Settings>Apps>Special app access>Install unknown appsSelect Chrome
Enable "Allow from this source"
Remarks: You may disable this feature after you install Termux app.
Pause Play Protect
Open the ˋGoogle Play Storeˋ app
Play Protect > Play Protect Settings
Pause ˋScan apps with Play Protectˋ
Remarks: Remember to resume when you finish Termux setup.
Install Termux App
Launch Chrome on your Android device.
Go to official Termux GitHub release page: https://github.com/termux/termux-app/releases
Download the "universal" version from the list under "Assets"
After the file is downloaded, select it from Chrome download list
Select "Install"
Extra step for Android 14+ users, read https://github.com/agnostic-apollo/Android-Docs/blob/master/en/docs/apps/processes/phantom-cached-and-empty-processes.md#commands-for-android-14-and-higher
Install Repositories
Launch Termux and run,
pkg install root-repo
pkg install x11-repo
Update and Upgrade
pkg upgrade
Termux:API & termux-api
Termux:API app and termux-api package are two different elements that needed to be installed separately.
Download and install a
*.apkfile from https://github.com/termux/termux-api/releasesRun in termux:
pkg install termux-api
Read more at https://wiki.termux.com/wiki/Termux:API
Storage Setup
Go to Settings > Apps > Termux > Permissions > Files > Allow
termux-setup-storage
Locate the shared storage in $HOME/storage
Read more at https://wiki.termux.com/wiki/Sharing_Data
Install Basic Packages
pkg install bash-completion which python golang git binutils libjpeg-turbo libpng build-essential clang make cmake pkg-config curl wget lynx w3m elinks vlc xclip xsel vim libxml2 libxslt python-apsw libzmq libsodium libgmp libmpc libmpfr python-lxml micro nano rust proot python-torch python-torchaudio python-torchvision
echo 'alias micro="micro -softwrap true -wordwrap true"' >> ~/.bashrc
source ~/.bashrc
Remarks:
We install the official python-apsw package created by Termux team, rather than using pip3, in order to work with regular expression searches. For details, read https://github.com/termux/termux-packages/issues/12340
Installation of
rustis necessary for several python packages to be installed.
Read more at: https://wiki.termux.com/wiki/Python#Python_module_installation_tips_and_tricks
More about Packages
https://wiki.termux.com/wiki/Package_Management#Other_Package_Managers
https://wiki.termux.com/wiki/Python
Install matplotlib on Termux
On Termux, do not use pip3 to install matplotlib, we manage to install matplotlib on Termux by running:
pip3 install 'kiwisolver<1.4.0,>=1.0.1' --force-reinstall
pip3 install cycler
pip3 install fonttools
pip3 install python-dateutil
pkg install python-numpy
pkg install matplotlib
Build Llama.cpp
cd ~
git clone https://github.com/ggerganov/llama.cpp.git
cd llama.cpp
cmake -B build
cmake --build build --config Release
Instal Ollama on Termux
Install Ollama:
pkg install git cmake golang
git clone --depth 1 https://github.com/ollama/ollama.git
cd ollama
sed -i "s/-D__ARM_FEATURE_MATMUL_INT8//g" llama/llama.go
go generate ./...
go build .
cp ollama /data/data/com.termux/files/usr/bin/
echo 'export OLLAMA_HOST=0.0.0.0' >> ~/.bashrc
source ~/.bashrc
Start Ollama server:
ollama serve &
Run, e.g. Llama3.2:3b:
ollama run llama3.2:3b
Install fabric
pkg install golang
go install github.com/danielmiessler/fabric@latest
export GOPATH=$HOME/go
export PATH=$GOPATH/bin:$HOME/.local/bin:$PATH
echo "export GOPATH=$HOME/go" >> ~/.bashrc
echo "export PATH=$GOPATH/bin:$HOME/.local/bin:$PATH" >> ~/.bashrc
fabric --setup
Install Docker, SearxNG and Perplexica
Install yt-dlp
cd
mkdir -p ~/.local/bin
pkg install ffmpeg
wget -P ~/.local/bin/ https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp
chmod +x ~/.local/bin/yt-dlp
export PATH=$HOME/.local/bin:$PATH
alias mp3='cd /data/data/com.termux/files/home/storage/music && yt-dlp -x --audio-format mp3'
alias mp4='cd /data/data/com.termux/files/home/storage/movies && yt-dlp -f bestvideo[ext=mp4]+bestaudio[ext=m4a]/mp4'
SSH Setup
pkg install openssh avahi
echo 'echo "IP Address: \$(termux-wifi-connectioninfo | grep ip | awk -F'"' '{print $4}')"' >> ~/.bashrc
To acess a machine on the same network with port forwarding, e.g.
ssh user_name@computer_name.local -L 8080:localhost:8080 -L 3000:localhost:3000 -L 3001:localhost:3001
Install AgentMake
cd
mkdir ~/storage/shared/Documents/agentmake
ln -s ~/storage/shared/Documents/agentmake agentmake
python3 -m venv ai
source ai/bin/activate
pip install -U agentmake
echo "export PATH=\$PATH:\$HOME/ai/bin" >> .bashrc
To configure:
ai -ec
To test:
ai Hi!
ai Send an email to Eliran to express appreciation for his work at eliran@email.com -t android/send_email
To list all Android specific tools:
ai -lt | grep android
Remarks: Run ollama serve in a separate Termux session if you use ollama as default backend for running AgentMake AI.
For more tests or examples, read https://github.com/eliranwong/AMD_iGPU_AI_Setup#edit-configurations
Note: Work with Vertex AI
Termux does not support installation of package google-genai directly, but you can set up an Ubuntu container in order to use it. Read below.
Install Ubuntu Container
To install an Unbuntu container for more support of python libraries, run in Termux:
cd
mkdir -p storage/shared/Documents/agentmake
pkg update && pkg upgrade && pkg install -y git wget proot
git clone https://github.com/MFDGaming/ubuntu-in-termux.git
cd ubuntu-in-termux && chmod +x ubuntu.sh && ./ubuntu.sh -y
echo 'alias ubuntu='$(pwd)'/startubuntu.sh' >> ~/.bashrc
echo 'pulseaudio --start --load="module-native-protocol-tcp auth-ip-acl=127.0.0.1 auth-anonymous=1" --exit-idle-time=-1' >> ~/.bashrc
source ~/.bashrc
Start Ubuntu in Termux
ubuntu
Install Basic Tools
cd
apt update && apt full-upgrade
apt install -y bash-completion
apt install -y python3
apt install -y python3-setuptools python3-pip python3-dev python3-venv portaudio19-dev ffmpeg wget curl git wget nano micro sqlite3 libsqlite3-dev net-tools
apt install libxcb-cursor0 pulseaudio-utils alsa-base alsa-utils mpg123 espeak
pip install xonsh[full]
# add missing group names
groupadd -g 3003 groupname3003
groupadd -g 9997 groupname9997
groupadd -g 20298 groupname20298
groupadd -g 50298 groupname50298
# support container sound output
echo 'export PULSE_SERVER=127.0.0.1' >> ~/.bashrc
# configure xonsh
echo "# XONSH WEBCONFIG START
$XONSH_COLOR_STYLE = 'material'
xontrib load coreutils
# XONSH WEBCONFIG END
aliases['micro']='micro -softwrap true -wordwrap true'" > .xonshrc
# install golang
add-apt-repository ppa:longsleep/golang-backports
apt update
apt install golang-go
# install rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
export PATH=$HOME/.cargo/bin:$PATH
# install ollama
curl -fsSL https://ollama.com/install.sh | sh
echo 'export OLLAMA_HOST=0.0.0.0' >> ~/.bashrc
# install fabric
mkdir -p .local/bin
echo "export PATH=$HOME/.local/bin:$PATH" >> ~/.bashrc
# Install fabric amd64 version
#curl -L https://github.com/danielmiessler/fabric/releases/latest/download/fabric-linux-amd64 > ~/.local/bin/fabric && chmod +x ~/.local/bin/fabric && ~/.local/bin/fabric --setup
# Install fabric arm64 version
curl -L https://github.com/danielmiessler/fabric/releases/latest/download/fabric-linux-arm64 > ~/.local/bin/fabric && chmod +x ~/.local/bin/fabric && ~/.local/bin/fabric --setup
# reload variables
source ~/.bashrc
Example: Work with VertexAI
Package google-genai is not supported directly on Termux, but you can install it in Ubuntu container.
cd
python3 -m venv ai
source ai/bin/activate
pip install -U agentmake[genai]