OX Alpha is an enterprise-grade, high-throughput autonomous ReAct (Reasoning and Acting) AI Agent system. It features omnichannel client support across Web, Lightweight Desktop, Telegram, Personal Zalo, and CLI, backed by a dual-engine architecture in Node.js and high-performance Golang.
OX Alpha operates on an autonomous Thought-Action-Observation loop that breaks down complex user objectives into tool calls, executes them securely in isolated environments, and reflects on intermediate outputs until the task is solved.
+-----------------------------------------------------------------------------------+
| CLIENT SURFACES |
| Web UI (React) | Desktop App (Native C++) | Terminal CLI | Zalo / TG |
+-----------------------------------------------------------------------------------+
|
v HTTP / REST / SSE / gRPC
+-----------------------------------------------------------------------------------+
| API GATEWAY & ENGINE RUNTIMES |
| |
| [Node.js Engine] Hono Router + Drizzle ORM + Stdio MCP Manager |
| [Golang Core Engine] Fiber v2 + SQLite WAL (Pure-Go) + Goroutine Swarm Pool |
+-----------------------------------------------------------------------------------+
| | | |
v v v v
+---------------+ +------------------+ +----------------+ +-------------+
| ReAct Runtime | | Multi-Agent Pool | | Cron Scheduler | | SQLite WAL |
| Tool-Calling | | Background Swarm | | Shell & Agent | | Persistent |
+---------------+ +------------------+ +----------------+ +-------------+
- Frontend & UI: React 18, Vite 5, Tailwind CSS, Lucide Icons, Full i18n Localization (VI, EN, ZH, JA, KO, FR).
- Desktop Client: Lightweight Native WebView (Neutralino / Edge WebView2) consuming under 35 MB RAM with 100% JetBrains Mono typography.
- Node.js Gateway: Node.js 20+, Hono framework, Drizzle ORM, Stdio MCP RPC protocols.
- High-Throughput Golang Core: Go 1.22+, Fiber v2 (FastHTTP), Pure-Go SQLite in WAL mode (
modernc.org/sqlite),robfig/cron/v3, Goroutine Worker Pool with buffered channels. - AI Providers: OpenRouter, Google Gemini, Groq, Mistral, Together AI, xAI (Grok), DeepSeek, and local LLMs (Ollama / 9Router / vLLM).
- Node.js >= 20.10.0
- pnpm >= 9.0.0
- Go >= 1.22 (for high-concurrency Golang engine)
- Windows 10/11, macOS, or Linux
git clone https://github.com/ryanowlops/ox-alpha.git
cd ox-alpha
pnpm installCreate or update ox.yml in the project root:
app:
name: OX
version: 1.0.0
locale: en
server:
host: 0.0.0.0
port: 1006
cors: true
ai:
default_provider: custom
models:
custom: research
gemini: gemini-2.0-flash
deepseek: deepseek-chat
openai: gpt-4o
claude: claude-3-5-sonnet-20241022
custom:
base_url: http://localhost:20128/v1
api_key: your-api-key
zalo:
enabled: true
mode: bridge
bridge_url: http://127.0.0.1:8787pnpm build-
Run Standard Gateway (Node.js/Hono):
pnpm gateway
-
Run High-Throughput Core Engine (Golang):
pnpm gateway:go
-
Run Web Dashboard (Dev Mode):
pnpm web
Access at
http://localhost:5173. -
Run Desktop Native Client:
pnpm desktop
Or execute the standalone binary directly:
dist-desktop/OX Alpha.exe -
Install Windows Desktop Package (NSIS): Launch
dist-desktop/OX Alpha_1.0.0_x64-setup.exeto install to user profile with Start Menu and Desktop shortcuts. -
Run Interactive Terminal CLI:
pnpm ox
| Shortcut | Action | Description |
|---|---|---|
Enter |
Send Message | Submits current message or command to the agent |
Shift + Enter |
Newline | Inserts a new line in the message input area without submitting |
Ctrl + L / Cmd + L |
Clear Terminal | Clears the active chat session buffer |
Ctrl + K / Cmd + K |
Command Palette | Focuses search and prompt navigation |
Esc |
Close Overlays | Closes modals, dropdown menus, and popups |
When interacting via pnpm ox, type / to trigger interactive autocomplete:
| Command | Description |
|---|---|
/effort [level] |
Configures reasoning depth (low, medium, high, xhigh, max, ultracode) |
/effort ultracode |
Enables autonomous multi-phase engineering mode (Plan -> Execute -> Verify) |
/model [name] |
Dynamically switches the active AI model |
/clear |
Clears conversation history on screen |
/mcp |
Displays active MCP servers, tools, and connection statuses |
/memory |
Inspects stored long-term SQLite memories for the current user |
/image [path] |
Attaches a local image or screenshot for vision reasoning |
/exit or Ctrl + C |
Safely terminates the interactive CLI session |
- Request Intake & Normalization: Requests entering via HTTP API, Zalo Bridge (port 8787), Telegram, or CLI are parsed and assigned a unique
conversationId. - Context Assembly: The engine loads registered skills, MCP tool definitions, and long-term memories matching the user ID from SQLite WAL storage.
- ReAct Thought Loop:
- The LLM assesses the objective and emits structured Function Calls (
exec_shell,read_file,write_file, web search, etc.). - The runtime intercepts the call, verifies security boundaries, and runs the command inside a bounded Goroutine context.
- Output observation feeds back into the prompt history.
- The LLM assesses the objective and emits structured Function Calls (
- Sub-Agent Delegation: If a prompt demands heavy parallel research or compute, the engine calls
delegate_taskto dispatch independent worker jobs handled by an 8-goroutine worker pool. - Streaming & Delivery: Final verified responses are streamed back to Web/Desktop consoles or dispatched as clean messages to Zalo and Telegram.
Distributed under the MIT License.