ionq-bits 0.1.0

IONQ - Naked Bits Visualizer. A real-time CPU emulator, system introspector, and bit-level register visualizer.

IONQ - Naked Bits Visualizer

A real-time CPU emulator, system introspector, and bit-level register visualizer.

Watch every bit flip, every register change, and every stack push as your assembly code executes instruction by instruction.

Features

• Real-time CPU Emulator TUI -- x86_64, ARM64, and RISC-V architectures powered by Unicorn Engine
• Bit-level Visualization -- See registers, flags, stack, and memory as raw bits updating live
• Interactive Assembler REPL -- Write and execute assembly instructions on the fly
• Breakpoints & Watchpoints -- Pause on addresses or register value changes
• Memory Inspector -- Hex dump with change highlighting and write capability
• Deep System Introspection -- CPU, GPU, BIOS, disk, network, and security info (cross-platform)
• Security Scanner -- Firewall status, antivirus, open ports, vulnerability assessment
• 12 Built-in Programs -- 7 x86_64, 3 ARM64, 2 RISC-V sample programs to explore

Installation

pip install ionq-bits

Quick Start

# Show system info then launch the bits visualizer
ionq

# Launch the bits visualizer directly
ionq bits

# Load a custom assembly file
ionq bits -f mycode.asm

# Set architecture (x86_64, arm64, riscv)
ionq bits -a arm64

# Full system information
ionq info

# Live packet transfer stats
ionq packets

# Security scan
ionq scan

# Show all commands and keybindings
ionq help

Keybindings (Bits Visualizer)

Key	Action
Space	Play / Pause execution
Right	Step one instruction (while paused)
Up/Down	Increase / decrease speed
R	Reset current program
P	Switch to next program
L	Toggle loop mode
M	Toggle memory inspector
`	Open interactive assembler / REPL
Q	Quit

REPL Commands

Command	Description
<asm>	Assemble and execute (e.g. inc rax)
b <addr>	Set breakpoint at hex address
w <reg>	Watch a register for changes
w <reg>=<val>	Watch for register == value
m <addr>	View memory at hex address
mw <addr> <hex>	Write hex bytes to memory
regs	Print all register values

Requirements

• Python 3.9+
• Unicorn Engine -- CPU emulation
• Capstone -- Disassembly
• Keystone Engine -- Assembly
• Textual -- TUI framework
• Rich -- Terminal formatting
• psutil -- System info

License

MIT License. See LICENSE for details.

Author

ATOM00blue -- GitHub