---

---

What is ZYRAXON AI?

ZYRAXON is not a chatbot. It's a desktop AI agent that reads your files, writes your code, runs your commands, builds your projects, deploys your apps, and evolves itself — all while you watch. Built on Electron + SolidJS + Bun, it runs 100% locally on your machine. No cloud dependency. No data leaves your computer.

The question at the top isn't rhetorical. What if your AI could truly do everything? That's what we're building.

---

Mode	Power	What It Unlocks
Build	★★★	Full filesystem + persistent memory. The reliable workhorse.
Plan	★★☆	Read-only strategic analysis. Plans before action.
Beast	★★★★	Mission Control (3-level subagents) + Self-Evolution + Subagent Army
PRO	★★★★	Unlimited memory + auto screen vision + Self-Healing
APEX PREDATOR	★★★★★	Omega Command Center + Eternal Memory + Annihilation Engine
DARK EMPEROR	★★★★★	Supreme Sovereignty + 8 ULTRA tools. Zero Refusal.
Vision	★★★	AI's Eyes — real-time screen streaming, frame memory, scene analysis
Pro Builder	★★★★	Website genesis from natural language. Auto-deploys to GitHub Pages.
General	★★☆	Subagent for delegated tasks.

DARK EMPEROR — 8 ULTRA Tools

ultraCodeGen Code generation with Vector3/Matrix math, DirectedGraph analysis, Shannon entropy	ultraAutoDeploy One-command cloud deploy with DeploymentGraph DAG, RollbackPlanner
ultraSecuritySweep Full security audit — Miller-Rabin, Pollard-Rho, RSA attacks, NIST SP 800-22	ultraPerformance Performance engine — ANOVA, OLS regression, Grubbs test, Holt-Winters
ultraRefactor AI refactoring — CategoryTheory, DesignPatternDetector, DependencyAnalyzer	ultraTestGen Test generation — Pairwise NIST ACTS, MutationTesting, FormalVerifier
ultraDocGen Auto-documentation with API reference extraction	ultraDebug Advanced debugging engine with stack trace analysis

---

Core Engine (31) Tool Purpose shell Execute terminal commands read Read files write Write files edit Edit files glob Find files by pattern grep Search file contents task Delegate to subagents fetch Fetch web content search Web search todo Task management skill AI skill management memory Persistent memory self_evolve Self-evolution screen_vision Screen capture api_tester API testing code_analyzer Code analysis system_info System information site_create Website creation site_publish Deploy to GitHub Pages site_domain Custom domain media_fetch Media download svg_generate SVG generation github_connect GitHub integration patch Apply patches question Ask user execute Code mode lsp Language server plan Plan mode invalid Fallback handler

Domain Tools (521) Category Count Aviation 24 Ground (Autonomous) 18 Drone / UAV 21 Space 22 Helicopter / VTOL 19 Medical 9 Industrial 15 Infrastructure 15 Security 15 Survey 14 Agriculture 15 Marine 15 Construction 15 Physical Interface 8 Sensors 8 SDR (Radio) 7 Safety 7 Machine Learning 6 Digital Twin 5 Dashboard 5 Alerts 4 Data Logger 5 Remote Control 6 Predictive Maint. 6 Decision Support 6 Authorization 6 Common Sense 6 Ethics 5 Creativity 5 Vehicles 56 Extended Math 38 Extended Physics 38 Extended Chemistry 22 Extended Biology 12 Extended Engineering 41 Extended Finance 23 Extended Data Science 36 Extended Security 19 Extended Daily Life 37

---

Voice Bridge Component Tech Input Chrome SpeechRecognition Output Edge Neural TTS Port 19800 / 19810 Comm Bidirectional IPC Mic → Chrome → SpeechRecognition → AI → Edge TTS → You hear it.

Monaco AI Editor Double-click in the editor Floating AI button appears Click — AI generates code with live streaming Supports: EN, BN, AR, JA, ZH, RU, KO, HI

Self-Healing You ask for something Missing tool detected ZYRAXON searches online Installs MCP/npm/Python Uses it immediately Zero failures

---

Layer	What It Does
SQLite WAL	Persistent storage with 8 compound indexes
Ring Buffer	Last 50 conversation pairs, crash-resilient
Brain Daemon	Runs every 1 second, tails opencode.db
permanent_brain.json	Live brain state
full_chat_history.txt	Static cache (85,000+ lines)
Compression	Automatic at 50K+ entries
Reset Survives	Task Scheduler on boot

It remembers everything. Forever.

---

Capability	ZYRAXON	Cursor	Copilot	Devin	OpenHands
Desktop App	✅	✅	❌	❌	❌
Embedded VS Code Editor	✅	✅	✅	❌	❌
9 Agent Modes	✅	❌	❌	❌	❌
Self-Healing	✅	❌	❌	⚠️	⚠️
Self-Evolution	✅	❌	❌	❌	❌
Eternal Memory (50K+)	✅	⚠️	⚠️	⚠️	⚠️
Desktop Automation	✅	❌	❌	❌	❌
Screen Vision	✅	❌	❌	⚠️	❌
Voice Communication	✅	❌	❌	❌	❌
552+ Tools Built-in	✅	⚠️	⚠️	⚠️	⚠️
25+ AI Providers	✅	⚠️	⚠️	⚠️	⚠️
Free & Open Source	✅	❌	❌	❌	✅

Cursor is a sports car. Devin is an airline. ZYRAXON is a transformer — a complete autonomous AI workforce in one app.

---

Tier	Price	Tools	Features
Free	$0 / forever	57	Core tools + basic AI
Pro	$5 / 15 days	113	+ Screen Vision, Self-Healing, Memory
Max	$15 / 2 months	370	+ All domain tools, DARK EMPEROR, ULTRA
Ultra	$99 / year	552+	Everything. Forever.

Secret codes unlock permanent access. No server. No internet. Pure local.

---

Layer Tech Runtime Bun 1.3.14+ Desktop Electron 42 + electron-vite UI SolidJS + TailwindCSS Database SQLite (drizzle-orm) WAL Build electron-builder Language TypeScript LLM Runtime AI SDK (Vercel)

Layer Tech Voice Input Chrome SpeechRecognition Voice Output Edge Neural TTS Browser Playwright (Chromium) Providers 25+ (OpenAI, Anthropic, Google, Azure, xAI, Mistral...) Memory SQLite WAL + Ring Buffer + Brain Daemon Subagents 3-level deep Mission Control Package Manager bun (not npm)

---

ZYRAXON AI provides a powerful JavaScript/TypeScript SDK for developers who want to integrate AI capabilities into their own applications.

Quick Start

npm install @zyraxon-ai/sdk

import { createZyraxonClient } from '@zyraxon-ai/sdk'

const client = createZyraxonClient({
  baseUrl: 'http://localhost:3000',  // ZYRAXON server port
})

// Chat with AI
const response = await client.chat({
  message: 'Hello ZYRAXON!',
})

console.log(response.text)

What You Can Do

Feature	Description
AI Chat	converse with 25+ LLM providers
Tool Execution	Run 552+ tools programmatically
Session Management	Create and manage AI sessions
Memory	Store and retrieve memories
Voice	Speech recognition & TTS
Vision	Screen capture & analysis

Full Documentation

See SDK.md for complete API reference, examples, and guides.

---

Platform	File	Arch
Windows	ZYRAXON Dev-win-installer.exe	x64
Linux	zyraxon-desktop-linux-amd64.deb	x64
Linux	zyraxon-desktop-linux-x86_64.AppImage	x64
Linux	zyraxon-linux-x64.tar.gz	x64
Linux	zyraxon-linux-arm64.tar.gz	arm64

Download from Releases

---

git clone https://github.com/onelpawarai-X/ZYRAXON-AI.git
cd ZYRAXON-AI
bun install
bun run zyraxon:full:win    # Windows
bun run zyraxon:full:linux  # Linux
bun run zyraxon:full:mac    # macOS

Step-by-step build

# Step 1: Core (AI engine)
bun run --cwd packages/zyraxon script/build.ts --single --skip-install

# Step 2: Node sidecar
bun run --cwd packages/zyraxon script/build-node.ts

# Step 3: Web UI
NODE_OPTIONS="--max-old-space-size=16384" bun run --cwd packages/app build

# Step 4: Electron shell
bun run --cwd packages/desktop build

# Step 5: EXE package
bun run --cwd packages/desktop package:win

---

ZYRAXON-AI/
├── packages/
│   ├── zyraxon/          # Core AI engine
│   │   ├── src/
│   │   │   ├── agent/    # 9 agent modes
│   │   │   ├── mcp/      # MCP servers + tools
│   │   │   ├── tool/     # Core tools
│   │   │   ├── x/        # 521+ domain tools
│   │   │   ├── session/  # LLM streaming
│   │   │   ├── screen/   # Vision system
│   │   │   └── memory/   # Eternal memory
│   ├── desktop/          # Electron app
│   ├── app/              # SolidJS UI
│   ├── ui/               # Shared components
│   ├── core/             # Database, utilities
│   ├── llm/              # 25+ provider routing
│   └── session-ui/       # Session UI

---

1. Fork the repo
2. Clone: git clone https://github.com/onelpawarai-X/ZYRAXON-AI.git
3. Install: bun install
4. Build: cd packages/zyraxon && bun run dev
5. Branch: git checkout -b feat/my-feature
6. Commit: git commit -m "feat: add my feature"
7. Push: git push origin feat/my-feature
8. Open PR

---

Project	Description
ZYRAXON AI	Desktop AI agent — the main project
Myra Agent	Android voice assistant
Zyraxon Code	AI-powered code editor (Monaco fork)
ZYRAXON Website	Main website
Cloud Agent	Cloud-based agent interface

---

ZYRAXON AI publishes 12 packages to npm under the @zyraxon-ai scope.

Quick Install

# Most users — just the SDK
npm install @zyraxon-ai/sdk

# Plugin developers
npm install @zyraxon-ai/plugin

All Packages

See PACKAGES.md for full documentation of all 12 packages, dependency graph, and usage guides.

Publishing

Use the all-in-one publish script to build and publish all packages at once:

# Publish all 12 packages to npm
.\publish-all.ps1

# Dry run (no actual publish)
.\publish-all.ps1 -DryRun

# Custom version
.\publish-all.ps1 -Version "20.0.0"

The script handles everything: resolves dependencies, compiles TypeScript, and publishes in correct order.

---

---