🌳 acornix

The intelligent seed for your Termux ecosystem.

acornix is an AI-powered assistant designed to generate apps, manage plugins, and automate workflows directly from your terminal. Built with a nod to the legacy of Acorn Computers and the power of ARM architecture, it transforms your phone into a portable development powerhouse.

Watch acornix create app Video DEMO

1. Environment Setup (Android)

Before touching the code, you need the base tools on your mobile device:

Install Termux: Download it preferably from F-Droid or its official GitHub (the Google Play version is obsolete). Termux
Install Termux:API: Download the Termux:API extension (this allows the AI to control phone functions). Termux:API

Open Termux and update everything is up to date before you begin:

pkg update && pkg upgrade

2. Initial Configuration

Open Termux and make sure everything is updated before starting:

🚀 Quick Install

Run this command in Termux to set up everything automatically (dependencies, permissions, and alias):

pkg update && pkg upgrade -y && pkg install python git termux-api binutils -y && termux-setup-storage && git clone https://github.com/gonzaroman/acornix.git && cd acornix && pip install requests python-dotenv psutil && echo "alias acornix='cd ~/acornix && python main.py'" >> ~/.bashrc && source ~/.bashrc && python main.py

Note: You'll be asked for storage permissions. Please grant them to allow acornix to save your projects.

✨ Key Features AI App Generator: Create web apps and scripts using natural language.

Plugin System: Extend acornix capabilities with modular plugins.

Termux Native: Fully optimized for mobile environments and ARM processors.

Zero Config: The one-liner takes care of everything, including your custom acornix command.

🛠 Usage After installation, you can launch the system from anywhere by simply typing:

acornix

Main Menu Options: Generate App: Describe what you want, and acornix will build it.

Manage Plugins: Install or update system extensions.

Launch Server: Preview your generated apps on your local network.

if you have a problem with the server, reebot the server:

pkill -f "python -m http.server"
python -m http.server 8080

🌳 acornix: The AI-Powered OS for Termux

"Transform your mobile terminal into a neural development hub."

acornix isn't just a script; it's a procedural engine designed to bridge the gap between AI intelligence and mobile hardware. It allows you to orchestrate complex applications, automate local environments, and extend your terminal capabilities using natural language. Markdown

"Transform your mobile terminal into a neural development hub."

You can create games, applications, or in agent mode, ask it to control your phone, such as opening YouTube and searching for a Nirvana video, or ask your phone to do anything, such as sending an S.O.S. signal with the flashlight. The only limit is your imagination. You can create whatever you want and share it with whoever you want. The system has a simple tool for exporting and importing creations, apps, etc.

🌳 acornixOS: The AI-Powered

"Transform your mobile in a PC." Press and hold an app to add it to the dock.

Watch acornixOS Video Demo

📸 Showcase

*Create a simple game 3d aeroplane for mobile

*create a piano for mobile

*create a arkanoid with tactile buttons

*in mode agent: open youtube and search Nirvana videos

| | | | :---: | :---: | | <img src="https://github.com/user-attachments/assets/3c93ac34-93e7-438c-8c14-f37b43ccabb2" width="300" alt="avion"> | <img src="https://github.com/user-attachments/assets/beb859cc-bf43-4861-ad6a-e8254adeb0b8" width="300" alt="piano"> | | <img src="https://github.com/user-attachments/assets/06667fcb-43b4-4098-839f-09383ce8aeb4" width="300" alt="arckanoid"> | <img src="https://github.com/user-attachments/assets/bca05911-68cf-4a70-be84-abc4e4fa1b23" width="300" alt="nirvana"> |

OPTION 1: Create APP Create an app that is a canvas for painting with your fingers on a mobile device, with color selection, brush size, and the option to erase the canvas: <img width="401" alt="Paint" src="https://github.com/user-attachments/assets/555b114a-4acd-426c-a6ef-12f40dc9c9cd" /> OPTION 1: Create APP Create a castle defense game for mobile screens, where enemies attack and I can shoot with a cannon to eliminate them. The difficulty should increase as I progress, and I should receive more powerful weapons: <img width="401" alt="Castle" src="https://github.com/user-attachments/assets/19197abb-aafe-465d-bef1-dfe519fec31a" /> OPTION 2: Create FUNCTIONALITY Create a plugin or functionality that displays all the applications created in the my_apps folder. The style should be similar to how applications are displayed on a mobile phone: <img width="401" alt="Library" src="https://github.com/user-attachments/assets/d78448f8-beba-4116-9162-9c5210492109" /> OPTION 1: Create APP Create a solar system simulator that shows how the planets move. Make it mobile so I can control it with my fingers: <img width="401" alt="Solar sytem" src="https://github.com/user-attachments/assets/e3073cf5-1e1b-4a96-b82e-4d56a63c6a3a" /> OPTION 1: Create APP Create a game similar to Flappy Bird for mobile phones: <img width="401" alt="Flappy bird" src="https://github.com/user-attachments/assets/c1fc7e28-f295-4977-bdfe-77dc7d0fbbd6" /> OPTION 2: Create FUNCTIONALITY Create a plugin or feature that displays a MacOS-based operating system, where I can control everything in Acornix, and where applications and plugins are displayed. Windows should be moved with my fingers; if I touch a window, it moves on top of the others. If I hold down an application, it is added to the dock. The terminal must communicate with the Termux terminal and must execute real commands, not simulate them: <img width="401" alt="AcornixOS" src="https://github.com/user-attachments/assets/c9f7bddf-83df-4872-b6dd-b313b4b6b688" />

🧠 Why acornix?

Most mobile environments are limited. acornix breaks those barriers by using a Context-Aware Architecture to turn simple text prompts into fully functional, locally-hosted software.

✨ Advanced Capabilities

🛠 Pro Workflow: From Idea to Execution

Don't just run code. Build systems. Here is how acornix handles the lifecycle of a project:

$$\text{Prompt} \xrightarrow{\text{IA Engine}} \text{Optimized Code} \xrightarrow{\text{Acornix Core}} \text{Local Deployment}$$

Example Commands:

"Create a dashboard to monitor my device battery and CPU usage using a modern dark-mode UI."

Generation: acornix builds the HTML5/CSS3/JS bundle.
Deployment: The system places it in my_apps/monitor_pro.
Hosting: Start the local server and access it at localhost:8080.

📂 System Architecture

The heart of acornix is organized for scalability:

acornix/
├── 🧠 main.py           # The Kernel: Entry point & process manager
├── 🛠 core/              # The Brain: Neural logic and prompt engineering
├── 🔌 plugins/          # The Limbs: Modular extensions for the system
├── 📦 my_apps/          # The Vault: AI-generated projects & assets
└── ⚙️ config.json       # The DNA: Secure credentials and API keys

Gonzalo Román Márquez

Acornix

Install / Use

README