Nexon

Nexon 🚀

An AI-powered Mobile Agentic IDE and Deep Research assistant that runs natively on Android via Termux. Nexon combines an interactive Flutter UI with a local Python bridge to orchestrate shell execution, file manipulation, live web search, and 3-agent Deep Research loops directly on your phone.

🏗️ System Architecture

Nexon split-processes operations between the Flutter application (visual IDE panels, state management, and rendering) and a Python Bridge background server running in the Termux userland environment.

+----------------------------------------------------------------------+
|                        Flutter App (Android)                         |
|                                                                      |
| +-------------+ +--------------+ +-------------+ +-----------------+ |
| | Chat/IDE UI | |  Artifacts   | |  Cost Tracker| |Deep Research UI | |
| |(Tool routing) |(SVG/MD Render) | (Token Usage)| |(3-State UI)     | |
| +------+------+ +--------------+ +-------------+ +-------+---------+ |
|        |                                                 |           |
|        |    +-------------------------------+            |           |
|        |    |      Google Drive Backup      |            |           |
|        |    | (Syncs Chats, Settings, Keys) |            |           |
|        |    +---------------+---------------+            |           |
+--------+--------------------+----------------------------+-----------+
         |                    |                            |
         | WebSocket :8765 /  | HTTP :8390                 |
         v                    |                            v
+-----------------------------+----------------------------------------+
|                             |    python_bridge Server                |
| +------------------------+  |  +-----------------------------------+ |
| | IDE / Shell Exec Layer |  |  | Deep Research Engine              | |
| | (hybrid_tools.py)      |  |  | - 3-Agent Autonomous Pipeline     | |
| | - File Read/Write/Edit |  |  | - Structured Fact/Finding Memory  | |
| | - Arbitrary Termux Cmds|  |  | - Dynamic Context Synthesizer     | |
| +---------+--------------+  |  +-----------------+-----------------+ |
+-----------+-----------------+--------------------+-------------------+
            |                                      |
            v                                      v
+------------------------+         +-----------------------------------+
|     Termux Runtime     |         |      External Services & APIs     |
| - Bash shell           |         | - Google Drive API (OAuth Backup) |
| - GCC, git, python     |         | - Tavily Search API (Web Search)  |
| +----------------------+         | - LLM Providers (BYOK Keys)       |
                                   +-----------------------------------+

✨ Core Features

1. 🛠️ Agentic IDE & Termux Tool Integration

Arbitrary Command Runner: LLM agents execute commands directly inside the Termux shell via shell_exec through the Python bridge, supporting standard compilers, tests, and script runners.
Rich File Manipulation: Read, write, and patch files using specific line range indices. Supports granular tools like patch_file, replace_lines, and diff_files.
Security Permission Control: Grants users execution control via shell permission configurations natively in the Flutter UI (ask, session, always, or never).

2. 🌐 Standalone Web Search

Live Web Context: The app intercepts search requests during standard chat sessions and routes them natively to Tavily API for real-time web context.

3. 📄 Artifact Rendering & Export

Markdown & Code Views: Renders rich formatted documents and syntax-highlighted code directly in the chat feed.
SVG Diagram Rendering: Intercepts generated SVG markup and renders interactive visual diagrams natively via flutter_svg.
Document Export: Supports parsing and saving conversational artifacts locally as .md or .docx files.

4. ☁️ Google Drive Backup & Sync

Unified Sync: Bundles conversation sessions, settings, and credentials into nexon_backup.json on Google Drive.
Non-Destructive Merge: Smart syncing preserves local un-synced chats while restoring remote backups smoothly.

5. 🔬 Deep Research Engine

3-Agent Autonomous Pipeline: Guided pipeline moving through Planner, Researcher, and Synthesizer phases.
Structured Fact & Finding Storage: Iteratively extracts precise FACT records (numeric metrics, dates, claims) and FINDING insights into state storage without heavy embedding models or vector databases.
Configurable Context Budget: Dynamically budget and throttle evidence tokens passed into the synthesis phase for maximum response quality.

6. 🔔 Automatic Release Notifications

Version Checker: Integrated UpdateService notifies users when a new version or APK release is available.

🧰 Technical Specifications

Layer	Technologies & Frameworks
Frontend UI	Flutter (Dart), Material 3 Design, `flutter_markdown`, `flutter_svg`, `fl_chart`
Local Storage	Flutter Secure Storage, SharedPreferences, local JSON
Python Bridge	Python 3, `aiohttp`, `websockets`, `python-docx`
Research Storage	Structured Fact/Finding JSON Store (Zero vector/embedding overhead)
Third-Party APIs	Supabase Auth, Google Drive v3 REST API, Tavily Web Search API

📌 Project Status

Nexon is an open-source Mobile Agentic IDE project actively developed for Android & Termux. All core infrastructure (Google Drive OAuth token refresh, structured file manipulation, and responsive UI rendering) has been fully stabilized.

🚀 Getting Started

Prerequisites

An Android device running Android 7.0+ (API 24+)
Termux installed from F-Droid
Python 3.10+ installed inside Termux

Installation

Configure Termux Environment: Run the bridge setup script inside your repository directory:
```
chmod +x install_bridge.sh
./install_bridge.sh
```
Start Python Bridge Server: Launch the bridge gateway. This runs WebSocket communication on port 8765 and HTTP REST on port 8390:
```
cd ~/nexon_bridge
python3 mcp_server.py
```
Compile & Run App: Build or run the Flutter application:
```
flutter run
```

🤝 Contributing

Contributions, bug reports, and feature requests are open and welcome! Feel free to open an issue or submit a Pull Request.

📜 License & Usage

Distributed under the Nexon Non-Commercial License. Free strictly for personal, academic, and non-commercial usage. Commercial use in any form (as-is, modified, or re-branded) is strictly prohibited. Subscriptions are coming soon; commercial licensing options will open once subscriptions launch. See LICENSE for details.

This site is open source. Improve this page.