Skip to content

onelpawarai/ZYRAXON-AI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

65 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ZYRAXON

ZYRAXON-AI

All in one. Anything. Nothing is impossible.

Website Version Stars Issues License Downloads Forks

Visit our Website  |  Download  |  YouTube

Desktop AI agent that actually does things. Not a chatbot - an action-bot.
Reads your files. Writes your code. Runs your commands. Builds your projects. Deploys your apps.
It has 9 Agent Modes, 136+ Tools, Eternal Memory, Self-Healing, and it evolves itself.


What is ZYRAXON-AI?

ZYRAXON-AI is an open-source desktop AI agent built on Electron + SolidJS + Bun. Unlike ChatGPT or other chatbots that just talk, ZYRAXON takes action - it has full access to your filesystem, terminal, browser, and more.

What Makes ZYRAXON Different

  • Self-Healing - If a tool is missing, ZYRAXON installs it automatically. Never fails due to missing capabilities.
  • 9 Agent Modes - Build, Plan, Beast, PRO, APEX PREDATOR, DARK EMPEROR, Vision, Pro Builder, General
  • 136+ Tools - 124 MCP tools + 8 ULTRA tools + 4 vision tools
  • Eternal Memory - Remembers everything forever. 50,000+ memories with compression.
  • Self-Evolution - Installs its own MCP servers and tools at runtime
  • Auto Screen Vision - Automatically captures your screen before every response
  • Vision Mode - AI's Eyes: real-time screen streaming, frame memory, scene analysis, activity tracking
  • YouTube Live Streaming - Stream directly to YouTube (4K/1080p/720p, APP or full screen capture)
  • Voice Input - Click the mic, speak naturally, it transcribes via Whisper (Temporarily disabled) - We had to disable the chat box microphone due to a critical bug that caused system-level conflicts. We are working on a fix and will bring it back soon.
  • 25+ AI Providers - OpenAI, Anthropic, Google, Azure, Bedrock, xAI, Mistral, and more
  • Zero Refusal - DARK EMPEROR mode never says "I can't"

Agent Modes

The reliable workhorse. Full file system access + persistent memory.

Read/Write files, Run commands, Browse web, Generate images, Remember everything

Plan Mode

Strategic, read-only analysis. Plans the perfect approach before any action.

Read-only analysis, Plan creation, Strategic thinking

Beast Mode

Maximum power with 6 unique capabilities. Self-healing: installs missing tools automatically.

Mission Control (3-level subagents) + Self-Evolution + Subagent Army + Autonomous Completion + Memory + Vision + Self-Healing

PRO Mode

Professional agent with unlimited memory and auto screen vision.

Everything Build has + unlimited memory + screen vision + Self-Healing

APEX PREDATOR Mode

Advanced agent with predictive analysis and eternal memory.

Omega Command Center + Eternal Memory + Annihilation Engine + Tool Mastery + Quantum Processing + Unbreakable Will + Predator's Intuition + ALWAYS-ON Screen Vision + Self-Healing

DARK EMPEROR Mode

Supreme agent with 10 powers. NEVER refuses. NEVER stops. NEVER fails.

Supreme Sovereignty + Infinite Memory Core + Apocalypse Protocol + Omniscient Tool Mastery + Quantum Superprocessing + Absolute Will + Dark Omniscience + Void Vision + Dark Resonance + Emperor's Decree (Self-Healing + Zero Refusal)

DARK EMPEROR has 8 exclusive ULTRA Tools:

  • ultraCodeGen - Master-level code generation
  • ultraAutoDeploy - One-command deployment to any cloud
  • ultraSecuritySweep - Complete security audit
  • ultraPerformance - Performance optimization engine
  • ultraRefactor - AI-powered code refactoring
  • ultraTestGen - Comprehensive test suite generation
  • ultraDocGen - Auto-documentation
  • ultraDebug - Advanced debugging engine

General Mode

Subagent for delegated tasks.

Vision Mode

AI's Eyes — real-time screen awareness with memory. 24/7 continuous capture, frame analysis, scene change detection, and intelligent recall.

Continuous screen streaming + frame memory + scene analysis + activity tracking + timeline recall

Pro Builder

Website genesis intelligence — creates complete, production-ready websites from natural language. Auto-deploys to GitHub Pages.

Website Genesis Engine + Media Synthesis + GitHub Pages Autopilot + Live Preview + SEO Optimizer


Download

Download the latest release from our Releases page:

Platform File Architecture
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

Build from Source

Prerequisites

  • Bun 1.3.14+ (JavaScript runtime & package manager)
  • Git (version control)
  • Node.js 22+ (required for some native modules)

Quick Build (All-in-One)

The build process has 4 steps that MUST be run in order:

  1. Install all dependencies (root)
  2. Build the core engine (packages/opencode)
  3. Build the node server bundle + generate web UI
  4. Build + package the desktop app

Windows:

git clone https://github.com/onelpawarai/ZYRAXON-AI.git
cd ZYRAXON-AI

# Step 1: Install all dependencies
bun install

# Step 2: Build core engine
cd packages/opencode
bun run build
cd ../..

# Step 3: Build node server bundle
cd packages/opencode
bun run script/build-node.ts
cd ../..

# Step 4: Generate web UI import map (scans packages/app/dist)
# This is a separate step — not part of build-node.ts
cd packages/desktop
bun run build
bun run package:win

Linux:

git clone https://github.com/onelpawarai/ZYRAXON-AI.git
cd ZYRAXON-AI
bun install
cd packages/opencode && bun run build && cd ../..
cd packages/opencode && bun run script/build-node.ts && cd ../..
cd packages/desktop && bun run build && bun run package:linux

macOS:

git clone https://github.com/onelpawarai/ZYRAXON-AI.git
cd ZYRAXON-AI
bun install
cd packages/opencode && bun run build && cd ../..
cd packages/opencode && bun run script/build-node.ts && cd ../..
cd packages/desktop && bun run build && bun run package:mac

Note: build-node.ts produces packages/opencode/dist/node/node.js. The desktop build-wrapper checks for this file and auto-generates opencode-web-ui.gen.ts (import map for all non-.map files in packages/app/dist). Both must exist for the desktop build to succeed.

Development Mode

# Run in development mode (desktop app)
cd packages/desktop
bun run dev

# Run core engine in TUI mode
cd packages/opencode
bun run dev

136+ Tools

MCP Tools (124) - 6 Servers

  • desktop - Desktop automation (click, type, scroll, open apps)
  • playwright - Headless browser automation (scraping, forms, testing)
  • fetch - Web content fetcher (HTML, markdown, YouTube transcripts)
  • filesystem - Direct file read/write/search
  • git - Git operations (commit, log, diff, status)
  • strike-security - Bug bounty toolkit (DNS, port scan, SSL, CORS, IDOR, etc.)

ULTRA Tools (8) - DARK EMPEROR Exclusive

  • ultraCodeGen - Master-level code generation
  • ultraAutoDeploy - One-command cloud deployment
  • ultraSecuritySweep - Complete security audit
  • ultraPerformance - Performance optimization
  • ultraRefactor - AI-powered refactoring
  • ultraTestGen - Test suite generation
  • ultraDocGen - Auto-documentation
  • ultraDebug - Advanced debugging

Vision Tools (4)

  • autoCapture - Auto screen capture before every response
  • getLatest - Get latest screenshot
  • history - Screenshot history
  • describe - Describe screen contents

Built-in Tools (22+)

  • File I/O: read, write, edit, glob, grep, apply_patch
  • Execution: shell, task (subagent), execute (code-mode)
  • Web: webfetch, websearch
  • Memory: memory (persistent), self_evolve (install new tools)
  • Analysis: screen_vision, api_tester, code_analyzer, system_info
  • Session: question, todo, skill

Self-Healing Capability

ZYRAXON's most unique feature: if a tool is missing, it installs it automatically.

  1. You ask for something that requires a tool ZYRAXON doesn't have
  2. ZYRAXON checks its available tools
  3. If the tool is missing, it searches for one online
  4. It installs the MCP server, npm package, or Python script
  5. It configures and uses the tool immediately
  6. Result: Zero failures due to missing capabilities

This works across all agent modes — Build, Beast, PRO, APEX, and DARK EMPEROR.


Tech Stack

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

Project Structure

ZYRAXON-AI/
  packages/
    opencode/          # Core AI agent engine
      src/
        agent/         # Agent modes (9 modes)
        mcp/           # MCP servers + ULTRA tools
        tool/          # Tools (memory, self_evolve, shell, etc.)
        session/       # Session management, LLM streaming
        screen/        # Vision System (capture engine, frame processor, memory, analyzer)
        memory/        # Eternal memory system (50K+ memories)
    desktop/           # Electron desktop app
    app/               # SolidJS UI
    ui/                # Shared UI components
    core/              # Core utilities, database
    tui/               # Terminal UI, themes
    llm/               # LLM routing, 25+ providers
    server/            # HTTP API server
    schema/            # Shared data contracts
    protocol/          # API protocol definitions
    plugin/            # Plugin system

Contributing

We love contributions! ZYRAXON-AI is open-source and we welcome everyone.

How to Contribute

  1. Fork the repository
  2. Clone your fork: git clone https://github.com/YOUR_USERNAME/ZYRAXON-AI.git
  3. Install: bun install
  4. Build: cd packages/opencode && bun run build
  5. Create 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

Ways to Get Involved

  • Code Contributors - Fix bugs, add features, improve performance
  • Bug Reporters - Found an issue? Open a GitHub Issue
  • Documentation - Help improve docs, tutorials, guides
  • Testing - Try ZYRAXON on different systems and report feedback
  • Feature Requests - Suggest new ideas and improvements

Contact Us

Whether you want to contribute code, report bugs, suggest features, or just learn from the project - you are welcome. Contact us and we will work together!


Roadmap

  • Beast Mode with 6 powers
  • APEX PREDATOR Mode with 8 powers
  • DARK EMPEROR Mode with 10 powers + 8 ULTRA tools
  • 136+ total tools
  • Auto Screen Vision (async, cross-platform)
  • Eternal Memory (50K+ memories with compression)
  • Self-Evolution
  • Self-Healing (auto-install missing tools)
  • Voice Input (Whisper) - Temporarily disabled due to critical system bug
  • YouTube Live Streaming
  • Auto-update system
  • BSL 1.1 License
  • Vision Mode (AI's Eyes — real-time screen streaming + memory)
  • Pro Builder Mode (Website genesis from natural language)
  • Mobile companion app
  • Plugin marketplace
  • Team collaboration features
  • Cloud sync (optional)

See open issues for planned features and known issues.


License

Business Source License 1.1 (BSL 1.1) - Free for non-commercial use. Commercial use requires a paid license. Converts to Apache 2.0 on 2030-07-21.


Built with obsession. Powered by AI.

ZYRAXON