Metadata-Version: 2.4
Name: nyxora
Version: 2.6.1
Summary: Terminal-native, offline, zero-knowledge, quantum-resilient password intelligence vault
Project-URL: Homepage, https://github.com/scorpiocodex/Nyxora
Project-URL: Documentation, https://github.com/scorpiocodex/Nyxora/blob/main/README.md
Project-URL: Repository, https://github.com/scorpiocodex/Nyxora.git
Project-URL: Tracker, https://github.com/scorpiocodex/Nyxora/issues
Author-email: ScorpioCodeX <scorpiocodex0@gmail.com>
License: MIT
License-File: LICENSE
Keywords: cli,cryptography,password-manager,security,vault
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Security :: Cryptography
Requires-Python: >=3.12
Requires-Dist: argon2-cffi>=23.1.0
Requires-Dist: cryptography>=42.0.0
Requires-Dist: keyring>=24.0.0
Requires-Dist: orjson>=3.9.0
Requires-Dist: packaging>=23.0
Requires-Dist: pynacl>=1.5.0
Requires-Dist: pyotp>=2.9.0
Requires-Dist: pyperclip>=1.8.0
Requires-Dist: pyyaml>=6.0.1
Requires-Dist: questionary>=2.0.0
Requires-Dist: requests>=2.31.0
Requires-Dist: rich>=13.7.0
Requires-Dist: textual>=0.47.0
Requires-Dist: typer[all]>=0.12.0
Provides-Extra: dev
Requires-Dist: freezegun>=1.4.0; extra == 'dev'
Requires-Dist: mypy>=1.9.0; extra == 'dev'
Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
Requires-Dist: pytest-mock>=3.12.0; extra == 'dev'
Requires-Dist: pytest-timeout>=2.3.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: responses>=0.25.0; extra == 'dev'
Requires-Dist: ruff>=0.4.0; extra == 'dev'
Description-Content-Type: text/markdown

<div align="center">

# 🌌 NYXORA

<p><b>Terminal-Native, Zero-Knowledge, Quantum-Resilient Password Intelligence Vault</b></p>

  <img alt="Version" src="https://img.shields.io/badge/version-2.6.0-00FFFF?style=for-the-badge&logo=appveyor">
  <img alt="Coverage" src="https://img.shields.io/badge/coverage-98%25-00FF41?style=for-the-badge&logo=pytest">
  <img alt="Python" src="https://img.shields.io/badge/python-3.12--3.14-8B00FF?style=for-the-badge&logo=python">
  ![CI](https://github.com/scorpiocodex/Nyxora/actions/workflows/ci.yml/badge.svg)

```text
███╗   ██╗██╗   ██╗██╗  ██╗ ██████╗ ██████╗  █████╗ 
████╗  ██║╚██╗ ██╔╝╚██╗██╔╝██╔═══██╗██╔══██╗██╔══██╗
██╔██╗ ██║ ╚████╔╝  ╚███╔╝ ██║   ██║██████╔╝███████║
██║╚██╗██║  ╚██╔╝   ██╔██╗ ██║   ██║██╔══██╗██╔══██║
██║ ╚████║   ██║   ██╔╝ ██╗╚██████╔╝██║  ██║██║  ██║
╚═╝  ╚═══╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝
  [ O F F L I N E ] • [ Z E R O  K N O W L E D G E ] • [ T A C T I C A L  S E C R E T S  V A U L T ]
```

*Designed and engineered by [ScorpioCodeX](https://github.com/scorpiocodex)*

</div>

---

**Nyxora** is a completely offline, ultra-hardened, command-line password manager. Built for power users, hackers, and security engineers who demand absolute control over their digital sovereignty. Keep your secrets out of the cloud and natively embedded in a high-octane cyberpunk terminal interface.

No telemetry. No forced syncs. Just pure, mathematically resilient cryptographic storage.

## 🛡️ Core Capabilities

🌟 **Quantum-Resistant Foundations**
Encrypts your local vault using memory-hard `Argon2id` for master key derivation, combined with `XChaCha20-Poly1305` authenticated encryption. It actively protects your keys from physical RAM attacks using native OS memory locking (`VirtualLock` on Windows, `mlock` on Linux).

🌟 **Zero-Knowledge Architecture**
Operates in a pure offline environment. The only outbound connection made is an optional lookup against the HaveIBeenPwned API utilizing k-anonymity (meaning only the first 5 characters of a hashed password leave your machine) for breach detection.

🌟 **Cryptographic Recovery**
Includes built-in support for Shamir's Secret Sharing (split the master key into multiple shards) and encrypted emergency recovery capsules to prevent catastrophic data loss.

🌟 **Intel & Audit Engine**
Provides deep pattern analysis and password strength auditing. Nyxora detects keyboard walks, repeated characters, common word bases, leet speak mappings, and password reuse across your entire local vault.

🌟 **Import Intelligence**
Bulk-import credentials from Bitwarden, 1Password, or any CSV export directly into the encrypted vault using `nyx vault import`. Supports auto-detection, dry-run preview, and format normalization.

🌟 **Next-Generation Terminal UI**
Visual entropy bars, live session dashboards, integrity checklists, and colour-coded audit summaries. Every interaction is information-dense and visually distinct.

## 🚀 Installation 

`Nyxora` isn't hosted on typical package indexes like PyPI to maintain strict, verifiable source derivation. You can install it directly from this GitHub repository using Python standards.

### Option 1: Using pipx (Recommended)
`pipx` ensures Nyxora is installed in an isolated environment but heavily available globally assigned to your `PATH`.

```bash
pipx install git+https://github.com/scorpiocodex/Nyxora.git
```

### Option 2: Using pip (Global or Virtual Environment)
```bash
python -m pip install git+https://github.com/scorpiocodex/Nyxora.git
```

### Option 3: Local Clone Development
```bash
git clone https://github.com/scorpiocodex/Nyxora.git
cd Nyxora
python -m pip install -e .
```

---

## ⚡ Quick Start

Experience next-generation CLI speed natively inside your terminal.

```bash
# 1. Initialize your new encrypted vault infrastructure
nyx vault init

# 2. Unlock and start a secured memory DPAPI keychain session
nyx vault unlock

# 3. Generate a strong passphrase with visual entropy meter
nyx generate passphrase --words 6 --count 3

# 4. Import from Bitwarden export
nyx vault import ~/bitwarden_export.json --format bitwarden

# 5. Add a secret with auto-generation parameters
nyx secret add --generate -t "GitHub" -u "cyber-ninja"

# 6. Search and securely push the password to your clipboard
nyx secret get "GitHub" --copy

# 7. Launch the interactive vault browser
nyx tui

# 8. Check for updates
nyx update check
```

---

## 📚 Global Command Hierarchy

Nyxora organizes its massive array of tools into clear, structured sub-modules. Type `nyx --help` or `nyx <module> --help` to explore the beautifully-rendered terminal graphics describing each endpoint parameter.

### 🔑 Vault & Sessions
* `nyx vault init` : Create the master SQLite database wrapper.
* `nyx vault unlock` : Boot a localized secure vault session.
* `nyx vault lock` : Securely halt background threads and terminate key mappings.
* `nyx vault status` : View cryptographic limits, session timers, and configurations.
* `nyx vault change-password` : Dynamically rotate the master derivation key sequence.
* `nyx vault import` : Bulk-import entries from CSV, Bitwarden, or 1Password.
* `nyx vault panic` : **Emergency Protocol**. Rapidly purge all RAM limits and shell bindings immediately.
* `nyx vault profiles` / `nyx vault use <name>` : Manage named vault profiles.
* `nyx update check/install/rollback` : Auto-updater with SHA-256 integrity verification.

### 🔒 Secrets Engine
* `nyx secret add` : Inject a new database item with associated URIs, notes, tags, and arbitrary `--custom` key=value fields.
* `nyx secret get` : Securely retrieve existing entries and copy to local clipboards.
* `nyx secret list` / `nyx secret search` : Iterate natively over large indexes safely visually.
* `nyx secret update` : Manage and alter entry fields — supports `--tags` to replace tag sets and `--custom` field updates.
* `nyx secret delete` : Remove entries with HMAC-verified soft deletion.

### ⚡ Generators & Tools
* `nyx generate password` : Emit highly entropic true-random sequences. Use `--min-strength` (weak/fair/strong/excellent) to enforce a minimum entropy threshold — regenerates up to 10 times to meet the target.
* `nyx generate passphrase` : Assemble multi-word combinations sampled from the full 7,776-word EFF large wordlist. Use `--count/-n` to generate multiple passphrases in one call.
* `nyx generate ssh-key` : Deploy native RSA/ED25519 payload creation (optionally encrypted).

### 🛡️ Security & Intelligence
* `nyx security audit` : Conduct a full vault scan for hash repetitions and structural entropy scores.
* `nyx security hibp` : K-Anonymity hash validation against breach databases.
* `nyx security log` : Cryptographically protected audit history tracing.

### 💾 Resiliency & Backups
* `nyx backup create` : Output `.nyx.bak` local vault snapshot copies.
* `nyx backup restore` / `nyx backup verify` : Assure disk-level stability and rollback support.
* `nyx backup export` : Dump vault items utilizing highly encrypted JSON constraints.

### 🚑 Emergency Access
* `nyx recovery setup-totp` : Deploy RFC-6238 Time-Based OTP secondary locks.
* `nyx recovery capsule` : Seal offline break-glass root keys.
* `nyx recovery split` / `nyx recovery combine` : Execute GF(256) Lagrange interpolation mathematics to split vault constraints into physical Shamir fragments.

### 📁 File Locker
* `nyx locker encrypt` / `nyx locker decrypt` : Bind arbitrary large files (`.pdf`, `.jpg`, `.txt`, `.mp4`) directly into strict encryption boundaries shielded by the vault's derived XChaCha keys.

### 🔌 Scripting & Integration
* `nyx script pipe <entry> -- <cmd>` : Pipe credential to command stdin without shell history exposure.
* `nyx script run <entry> -- <cmd>` : Inject credentials as env vars (`NYX_PASSWORD`, `NYX_USERNAME`, `NYX_URL`, custom fields).
* `nyx script fzf` : Fuzzy-find entries with fzf — `--field`, `--copy`, `--show`, `--json` output modes.
* `nyx --json <command>` : Machine-readable JSON output for any command (secret get/list/search, vault status, generate).
* `from nyxora import VaultClient` : Python SDK for programmatic access — context manager, CRUD, TOTP, health score.

### 🖥️ Interactive
* `nyx tui` : Obsidian Tactical vault browser — j/k navigation, live search overlay, detail panel with TOTP countdown, audit dashboard.

---

## 🏗️ Execution Architecture

```mermaid
graph TD
    CLI[Nyxora CLI Typer Engine] --> Core[Command Handlers]
    Core --> SM[Session Manager DPAPI Keyring]
    Core --> VS[Vault Store SQLite]
    Core --> CE[Crypto Engine AEAD]
    Core --> IE[Intel Engine HIBP APIs]
    CE --> MG[Memory Guard VirtualLock/mlock]
    SM --> MG
    VS --> CE
    IE --> CE
```

---

<div align="center">
  <sub><b>Nyxora v2.6.0</b> ◦ Developed by ScorpioCodeX ◦ Under MIT License</sub>
</div>
