🌳 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.

---

acornix_video.mp4

---

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."

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.

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.

acornixOSvideomix.mp4

📸 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

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:

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:

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:

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:

OPTION 1: Create APP
Create a game similar to Flappy Bird for mobile phones:

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:

---

🧠 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

Feature	Description	Technical Edge
Neural Architect	Generate high-performance web apps and Python tools from scratch.	Uses custom system prompts for ARM optimization.
Modular Core	Hot-swappable plugin system to add new commands without restarts.	Dynamic importing via core/ logic.
Environment Sync	Automatic SFTP and local server management for instant previews.	Integrated http.server with automatic port cleanup.
Hardware Mastery	Direct access to Termux API for hardware-level interaction.	Low-level integration with binutils and psutil.

---

🛠 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."

1. Generation: acornix builds the HTML5/CSS3/JS bundle.
2. Deployment: The system places it in my_apps/monitor_pro.
3. 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