🦄 UNIC0RN WEBRUNNER v2.0 - V1B3C0R3 EDITION

Run WebAssembly & Python in your browser with REAL-TIME streaming output!

✨ Features

🚀 Core Capabilities

• WASI Preview 2 Components - Full std library support for WebAssembly
• Python Runtime - 27MB WASI-compiled Python interpreter
• Real-time Output Streaming - See output as it happens
• INT10H Graphics Protocol - Retro graphics rendering in terminal
• Run Groups - Organize and filter apps by category
• WebSocket Communication - Bidirectional real-time messaging
• File Manager - Upload, view, and manage files
• Multi-app Support - Run multiple WASM/Python apps simultaneously

🎨 V1B3C0R3 WebUI Features

• Cyber-punk aesthetic with neon glow effects
• XTerm.js terminal with CRT scanlines
• Drag & drop upload for WASM and Python files
• Live metrics display (CPU, Memory, Runtime)
• Responsive 3-panel layout
• Canvas overlay for graphics rendering

🏗️ Architecture

┌─────────────────────────────────────────────────────┐
│                   WebUI (Yew/WASM)                   │
│  ┌────────────┬──────────────┬─────────────────┐   │
│  │  App List  │   Terminal    │    Controls     │   │
│  │            │   XTerm.js    │                 │   │
│  └────────────┴──────────────┴─────────────────┘   │
└───────────────────────WebSocket─────────────────────┘
                            │
┌───────────────────────────┴─────────────────────────┐
│              UNIC0RN Server (Rust)                   │
│  ┌─────────────────────────────────────────────┐   │
│  │         Wasmtime Runtime (WASI P2)          │   │
│  │  ┌──────────┬──────────┬────────────────┐  │   │
│  │  │   WASM   │  Python  │   TCP Server   │  │   │
│  │  │Component │  Runtime │   (Port 1337)  │  │   │
│  │  └──────────┴──────────┴────────────────┘  │   │
│  └─────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────┘

🚀 Quick Start

Prerequisites

• Rust 1.75+ with wasm32-wasip2 and wasm32-unknown-unknown targets
• Trunk for WebUI building

1. Start the Server

cargo run --bin unic0rn_server

2. Build & Serve WebUI

cd unic0rn_web_next
trunk serve --open

3. Upload & Run Apps

Via CLI:

# Upload WASM component
cargo run --bin unic0rn_cli -- upload target/wasm32-wasip2/release/app.wasm

# Upload Python script
cargo run --bin unic0rn_cli -- upload-python script.py

Via WebUI:

• Click "UPLOAD FILE" or drag & drop
• Select app from list
• Click "START" to run

📁 Project Structure

unic0rn/
├── unic0rn_server/        # Main server with Wasmtime runtime
├── unic0rn_web_next/      # V2.0 WebUI (Yew + XTerm.js)
├── unic0rn_cli/           # Command-line client
├── unic0rn_data/          # Shared data structures
├── unic0rn_sdk/           # SDK for building WASM apps
├── examples/              # Example apps and demos
│   ├── python/           
│   │   ├── int10h/       # Graphics demos
│   │   ├── tests/        # Test scripts
│   │   └── interactive/  # REPL examples
│   └── wasm/             # WASM examples
└── docs/                  # Documentation

🎮 INT10H Graphics Protocol

Custom escape sequence protocol for rendering graphics in the terminal:

ESC[10;<cmd>;<params>h

Commands:

• Clear (0): ESC[10;0h - Clear canvas
• Rectangle (1): ESC[10;1;<x>;<y>;<w>;<h>;<color>h
• Sprite (2): ESC[10;2;<x>;<y>;<w>;<h>;<base64_data>h
• Text (3): ESC[10;3;<x>;<y>;<color>;<text>h
• Line (4): ESC[10;4;<x1>;<y1>;<x2>;<y2>;<color>h
• Circle (5): ESC[10;5;<x>;<y>;<radius>;<color>h

Example (Python):

# Draw a cyan rectangle
print(f"\x1b[10;1;10;10;100;50;#00FFFFh", end='', flush=True)

🛠️ Development

Building WASM Apps

# Create new app
cargo new --lib my_app
cd my_app

# Add WASI target
rustup target add wasm32-wasip2

# Build as component
cargo build --release --target wasm32-wasip2

Running Tests

# Run all tests
cargo test --all

# Run specific example
cargo run --bin unic0rn_cli -- upload examples/python/int10h/int10h_demo.py

WebUI Development

cd unic0rn_web_next

# Development server with auto-reload
trunk serve --open

# Production build
trunk build --release

📚 API Documentation

WebSocket Messages

Client → Server:

enum ClientMessage {
    ListApps,
    StartApp { uuid: Uuid },
    StopApp { uuid: Uuid },
    DeleteApp { uuid: Uuid },
    UploadFile { name: String, data: Vec<u8> },
    TTYInput { uuid: Uuid, data: Vec<u8> },
}

Server → Client:

enum ServerMessage {
    AppList(Vec<AppInfo>),
    AppStarted { uuid: Uuid },
    AppStopped { uuid: Uuid, reason: String },
    AppOutput { uuid: Uuid, data: Vec<u8> },
    AppMetrics { uuid: Uuid, metrics: ResourceStats },
}

🎨 Customization

Themes

Edit unic0rn_web_next/assets/styles/v1b3c0r3.css to customize colors:

:root {
    --cyber-pink: #FF007F;
    --cyber-cyan: #00FFFF;
    --matrix-green: #00FF41;
    --void-black: #0A0A0A;
}

Run Groups

Apps are automatically categorized by name patterns:

• test_* → TEST group
• demo_* → DEMO group
• int10h_* → GFX group
• server_* → NET group

🔧 Troubleshooting

No Output Captured

• Ensure building with wasm32-wasip2 target (not wasm32-wasi)
• Check server logs for StreamWriter messages
• Verify WebSocket connection in browser console

WebUI Not Loading

• Clear browser cache (Ctrl+Shift+R)
• Check trunk serve is running on port 8080
• Verify no CSP violations in console

Python Import Errors

• Python runtime has limited stdlib
• No pip/external packages available
• Use built-in modules only

🤝 Contributing

1. Fork the repository
2. Create feature branch (git checkout -b feature/amazing)
3. Commit changes (git commit -m '✨ Add amazing feature')
4. Push to branch (git push origin feature/amazing)
5. Open Pull Request

📄 License

MIT License - See LICENSE file

🙏 Acknowledgments

• Wasmtime - WebAssembly runtime
• XTerm.js - Terminal emulator
• Yew - Rust/WASM framework
• Trunk - WASM web bundler

---

🦄 V1B3C0R3 COMPLETE! 💫

Built with 💜 by the UNIC0RN team

LET'S FUCKING GOOOOO!!! 🚀