DEV Community

Cover image for Now you can run opencode on termux :)
Sérgio Araújo
Sérgio Araújo

Posted on

Now you can run opencode on termux :)

#ai #termux #programming #opencode

How to Run Open Code on Termux for Free: The Definitive Guide

AI agents are transforming how we write code, but running them on a mobile device has always been a challenge. In a recent guide by tech creator DevCoreX, a seamless and entirely free method to run the updated version of Open Code directly inside Termux on Android was revealed.

Here is a comprehensive breakdown of how the setup works, how to install it, and how to start leveraging free AI models like MiniMax M2.5 and Big Pickle on your phone.

The Architecture: How It Works Without Root

Running complex desktop-grade AI software on Android usually requires a rooted device. However, this implementation utilizes a clever workaround: UDocker.

Because standard Docker cannot run on Termux without root access (and even then faces heavy limitations), this setup uses UDocker. UDocker allows you to pull and execute Docker containers inside an isolated Linux environment (like Ubuntu) completely root-free.

To keep your workflow native, the setup implements a shared volume (shared directory). When you run Open Code inside a folder in Termux, it maps directly to home/opencode/workspace inside the container. This means any file the AI generates or modifies happens instantly in your local Termux directory—no manual file transferring required.

Step-by-Step Installation Guide

The easiest way to install and manage Open Code is through Cortermux, an open-source utility repository developed by the DevCoreX community.

Step 1: Install or Update Cortermux 

curl -fsSL https://raw.githubusercontent.com/DevCoreXOfficial/core-termux/main/install.sh | bash
Enter fullscreen mode Exit fullscreen mode

Open your Termux terminal and run the main Cortermux installation script (provided in the project's official repository). Once installed, check your version by running:

core
Enter fullscreen mode Exit fullscreen mode

Make sure you are running version 3.7.1 or higher. If you need to update an older installation, execute:

core update core
Enter fullscreen mode Exit fullscreen mode

Step 2: Install Open Code Individually

Cortermux features an AI module containing multiple tools. To save storage space and avoid downloading tools you do not need, target Open Code specifically using this flag:

core install ai --opencode
Enter fullscreen mode Exit fullscreen mode

NOTE: In my case I chose the libc method and it worked perfectly

Step 3: Launch and Initialize

Create a dedicated working directory and navigate into it:

mkdir devcorex && cd devcorex
Enter fullscreen mode Exit fullscreen mode

Now, start the agent by running:

opencode
Enter fullscreen mode Exit fullscreen mode

Note: If you choose the container instalation method the very first time you execute this command, it will automatically download the required UDocker Linux container. This initial download takes a few moments, but all subsequent launches will open almost instantly.

Working with Free Models and Features

Once Open Code is running, you can interact with it like a standard terminal-based AI assistant.

  • View Available Models: Type /models within the environment. By default, you get access to three capable free models: MiniMax M2.5, Big Pickle, and Nemotron 3 Superfree.
  • Custom Providers: If you exhaust the free limits, Open Code is highly flexible. You can easily plug in API keys from premium providers like OpenAI, Anthropic, Google, or GitHub.
  • Persistent Sessions: The agent automatically tracks your chat history and project context. If you type /exit and return later, it remembers exactly what you were working on.
  • Skills Integration: By using the /skills command, you can inspect or run automated modular tasks to extend the agent's core capabilities.

Credits & Featured Links

Main reference: Video Author -> DevCoreX

Special Thanks: This Termux adaptation was made possible thanks to community developer Iván 3 (Iván 3 by Cinderela), who successfully adapted the environment and maintains it within his custom laboratories.

Project Resources:

Ialaf GitHub Repository: Maintained by Iván 3, hosting the manual deployment files and alternative Termux packages. (Search "Ialaf GitHub" to access the repository releases).

Cortermux Project: The official open-source tool manager used in this tutorial, accessible via the DevCoreX community channels.
Enter fullscreen mode Exit fullscreen mode

Author's Channel (DevCoreX): https://youtu.be/r3QwU_h8TmY (Original video link provided)

Cortermux Project Repository: https://github.com/DevCoreXOfficial/core-termux

Ialaf Laboratory (Iván 3): https://github.com/ivan3bycinderela/Ialaf or https://github.com/ivan3-by-cinderela/Ialaf (Depending on the GitHub username variation for developer Iván 3).

Base Tool (UDocker): https://github.com/indigo-dc/udocker (The mentioned tool used to run containers without root).

Top comments (0)