Metadata-Version: 2.4
Name: ionq-bits
Version: 0.1.0
Summary: IONQ - Naked Bits Visualizer. A real-time CPU emulator, system introspector, and bit-level register visualizer.
Author-email: ATOM00blue <23sjcca008_dalvin@sjcc.edu.in>
License-Expression: MIT
Project-URL: Homepage, https://github.com/ATOM00blue/ION
Project-URL: Repository, https://github.com/ATOM00blue/ION
Project-URL: Issues, https://github.com/ATOM00blue/ION/issues
Keywords: cpu,emulator,visualizer,bits,registers,assembly,x86,arm64,riscv,tui,system-info,security-scanner
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Software Development :: Disassemblers
Classifier: Topic :: System :: Hardware
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: Education
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: unicorn
Requires-Dist: capstone
Requires-Dist: keystone-engine
Requires-Dist: textual
Requires-Dist: psutil
Requires-Dist: rich
Dynamic: license-file

# 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

```bash
pip install ionq-bits
```

## Quick Start

```bash
# 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](https://www.unicorn-engine.org/) -- CPU emulation
- [Capstone](https://www.capstone-engine.org/) -- Disassembly
- [Keystone Engine](https://www.keystone-engine.org/) -- Assembly
- [Textual](https://textual.textualize.io/) -- TUI framework
- [Rich](https://rich.readthedocs.io/) -- Terminal formatting
- [psutil](https://github.com/giampaolo/psutil) -- System info

## License

MIT License. See [LICENSE](LICENSE) for details.

## Author

**ATOM00blue** -- [GitHub](https://github.com/ATOM00blue)
