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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
ionq_bits-0.1.0.tar.gz
(44.9 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
ionq_bits-0.1.0-py3-none-any.whl
(45.4 kB
view details)
File details
Details for the file ionq_bits-0.1.0.tar.gz.
File metadata
- Download URL: ionq_bits-0.1.0.tar.gz
- Upload date:
- Size: 44.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e8548dccacdc0e65961cf20447d193d686120f5ce5dd534d7dd71238784dd1a3
|
|
| MD5 |
7f22db51f594867f5928ae51f17ca5d1
|
|
| BLAKE2b-256 |
fd0c0d0ae4f4ffaa2c0a2d1e2739285d802d7a2e5dd31642ce07ff67085b244c
|
File details
Details for the file ionq_bits-0.1.0-py3-none-any.whl.
File metadata
- Download URL: ionq_bits-0.1.0-py3-none-any.whl
- Upload date:
- Size: 45.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
604503b9cb304f899bb7f5cfe4e275e6c90e18115d4e5e9280a72efab8cf0aed
|
|
| MD5 |
bfa7f0b4576b58bf02897e9989c8ab42
|
|
| BLAKE2b-256 |
15faf8d280854b48d5d935516b8bd5db8eb66002eb683b43f9b933e3f270410e
|