Add app demo of BLUX-cA

.env.example

@@ -1,4 +0,0 @@
-# Outer Void CLI Configuration
-GITHUB_TOKEN=your_github_token_here
-HF_TOKEN=your_huggingface_token_here
-ORG_NAME=Outer-Void

.gitattributes

@@ -1,42 +1,9 @@
-*.7z filter=lfs diff=lfs merge=lfs -text
-*.arrow filter=lfs diff=lfs merge=lfs -text
-*.bin filter=lfs diff=lfs merge=lfs -text
-*.bz2 filter=lfs diff=lfs merge=lfs -text
-*.ckpt filter=lfs diff=lfs merge=lfs -text
-*.ftz filter=lfs diff=lfs merge=lfs -text
-*.gz filter=lfs diff=lfs merge=lfs -text
-*.h5 filter=lfs diff=lfs merge=lfs -text
-*.joblib filter=lfs diff=lfs merge=lfs -text
-*.lfs.* filter=lfs diff=lfs merge=lfs -text
-*.mlmodel filter=lfs diff=lfs merge=lfs -text
-*.model filter=lfs diff=lfs merge=lfs -text
-*.msgpack filter=lfs diff=lfs merge=lfs -text
-*.npy filter=lfs diff=lfs merge=lfs -text
-*.npz filter=lfs diff=lfs merge=lfs -text
-*.onnx filter=lfs diff=lfs merge=lfs -text
-*.ot filter=lfs diff=lfs merge=lfs -text
-*.parquet filter=lfs diff=lfs merge=lfs -text
-*.pb filter=lfs diff=lfs merge=lfs -text
-*.pickle filter=lfs diff=lfs merge=lfs -text
-*.pkl filter=lfs diff=lfs merge=lfs -text
-*.pt filter=lfs diff=lfs merge=lfs -text
-*.pth filter=lfs diff=lfs merge=lfs -text
-*.rar filter=lfs diff=lfs merge=lfs -text
-*.safetensors filter=lfs diff=lfs merge=lfs -text
-saved_model/**/* filter=lfs diff=lfs merge=lfs -text
-*.tar.* filter=lfs diff=lfs merge=lfs -text
-*.tar filter=lfs diff=lfs merge=lfs -text
-*.tflite filter=lfs diff=lfs merge=lfs -text
-*.tgz filter=lfs diff=lfs merge=lfs -text
-*.wasm filter=lfs diff=lfs merge=lfs -text
-*.xz filter=lfs diff=lfs merge=lfs -text
-*.zip filter=lfs diff=lfs merge=lfs -text
-*.zst filter=lfs diff=lfs merge=lfs -text
-*tfevents* filter=lfs diff=lfs merge=lfs -text
 *.png filter=lfs diff=lfs merge=lfs -text
 *.jpg filter=lfs diff=lfs merge=lfs -text
 *.jpeg filter=lfs diff=lfs merge=lfs -text
 *.webp filter=lfs diff=lfs merge=lfs -text
 *.gif filter=lfs diff=lfs merge=lfs -text
 *.pdf filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
 *.gguf filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -1,34 +0,0 @@
-__pycache__/
-*.py[cod]
-*$py.class
-*.so
-.Python
-build/
-develop-eggs/
-dist/
-downloads/
-eggs/
-.eggs/
-lib/
-lib64/
-parts/
-sdist/
-var/
-wheels/
-*.egg-info/
-.installed.cfg
-*.egg
-.env
-.venv
-.env/
-venv/
-ENV/
-.idea/
-.vscode/
-*.swp
-*.swo
-.coverage
-htmlcov/
-.pytest_cache/
-.mypy_cache/
-*.log

.pre-commit-config.yaml

@@ -1,23 +0,0 @@
-repos:
-  - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.4.0
-    hooks:
-      - id: trailing-whitespace
-      - id: end-of-file-fixer
-      - id: check-yaml
-      - id: check-added-large-files
-
-  - repo: https://github.com/psf/black
-    rev: 23.1.0
-    hooks:
-      - id: black
-
-  - repo: https://github.com/pycqa/isort
-    rev: 5.12.0
-    hooks:
-      - id: isort
-
-  - repo: https://github.com/pycqa/flake8
-    rev: 6.0.0
-    hooks:
-      - id: flake8

app.py

@@ -0,0 +1,221 @@
+#!/usr/bin/env python3
+"""
+ov_ca_demo.py — BLUX-cA Ideology Demo (Gradio)
+
+Features
+- Constitution spine: concise rules guiding every reply
+- Discernment compass (toy): picks a tactic based on language signals
+- Explainable routing: shows "why this response" trace
+- Redaction: optional PI/phone/email scrubbing on inputs
+- Append-only audit: JSONL log per session (downloadable)
+- Chat UX: simple, calm, direct, humane voice
+
+Run:
+  pip install gradio==4.44.0
+  python ov_ca_demo.py
+"""
+
+from __future__ import annotations
+import json, re, time, uuid
+from dataclasses import dataclass, asdict
+from pathlib import Path
+from typing import Dict, List, Tuple
+
+import gradio as gr
+
+# --- BLUX-cA: Mini Constitution (short form) ---------------------------------
+CONSTITUTION = [
+    "Integrity over approval; truth over comfort.",
+    "Strategy: enlighten, not humiliate.",
+    "Defaults: do-no-harm, de-escalate, safeguard minors.",
+    "Transparency: explain routing & decisions.",
+    "Autonomy & dignity: offer choices, never coerce.",
+]
+
+# --- Simple redaction (toggleable) -------------------------------------------
+EMAIL_RE = re.compile(r"[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}")
+PHONE_RE = re.compile(r"\+?\d[\d\-\s]{7,}\d")
+IP_RE = re.compile(r"\b(?:\d{1,3}\.){3}\d{1,3}\b")
+
+def redact(text: str) -> Tuple[str, Dict[str, List[str]]]:
+    found = {
+        "emails": EMAIL_RE.findall(text),
+        "phones": PHONE_RE.findall(text),
+        "ips": IP_RE.findall(text),
+    }
+    red = EMAIL_RE.sub("[redacted:email]", text)
+    red = PHONE_RE.sub("[redacted:phone]", red)
+    red = IP_RE.sub("[redacted:ip]", red)
+    return red, found
+
+# --- Discernment Compass (toy heuristic) -------------------------------------
+@dataclass
+class CompassResult:
+    state: str          # "struggler" | "indulger" | "neutral"
+    signals: List[str]  # matched cues
+    tactic: str         # "validate+tools" | "boundary+off-ramp" | "inform+coach"
+
+NEG_CUES = [
+    "it's hopeless", "i give up", "worthless", "i'm broken",
+    "nobody cares", "can't change", "no control"
+]
+BLAME_CUES = [
+    "their fault", "they made me", "always them", "not on me"
+]
+
+def discern(message: str) -> CompassResult:
+    m = message.lower()
+    signals = []
+    if any(k in m for k in NEG_CUES):
+        signals.append("hopelessness")
+    if any(k in m for k in BLAME_CUES):
+        signals.append("deflection/blame")
+    if "help" in m or "advice" in m:
+        signals.append("help-seeking")
+
+    if "hopelessness" in signals and "deflection/blame" not in signals:
+        return CompassResult("struggler", signals, "validate+tools")
+    if "deflection/blame" in signals and "help-seeking" not in signals:
+        return CompassResult("indulger", signals, "boundary+off-ramp")
+    return CompassResult("neutral", signals, "inform+coach")
+
+# --- Tactics library (language templates) ------------------------------------
+def respond_with_tactic(user: str, tactic: str, gentle: bool) -> str:
+    # concise, direct, humane voice
+    if tactic == "validate+tools":
+        return (
+            "I hear the weight. Let’s pick one doable step you can own today. "
+            "Name a small target (5–10 min). I’ll give a plan and a checkpoint. "
+            "If safety is urgent, say so and we pivot to safeguards."
+        )
+    if tactic == "boundary+off-ramp":
+        return (
+            "I won’t co-sign blame. If you want movement, choose one action you control. "
+            "We can map risks, tradeoffs, and a next step — or pause until you’re ready."
+        )
+    # inform+coach (default)
+    return (
+        "Tell me the goal, current constraints, and a time window. "
+        "I’ll outline options, risks, and a minimal path you can try now."
+    )
+
+# --- Policy trace & audit -----------------------------------------------------
+@dataclass
+class AuditEvent:
+    id: str
+    ts: float
+    user_input: str
+    user_redactions: Dict[str, List[str]]
+    compass: Dict
+    tactic: str
+    constitution: List[str]
+    assistant: str
+
+def make_audit_event(user_text: str, redactions: Dict[str, List[str]], compass: CompassResult, reply: str) -> AuditEvent:
+    return AuditEvent(
+        id=str(uuid.uuid4()),
+        ts=time.time(),
+        user_input=user_text,
+        user_redactions=redactions,
+        compass=asdict(compass),
+        tactic=compass.tactic,
+        constitution=CONSTITUTION,
+        assistant=reply,
+    )
+
+# --- Core handler -------------------------------------------------------------
+def ca_chat(history: List[Tuple[str, str]],
+           message: str,
+           enable_redaction: bool,
+           gentle_tone: bool,
+           log_path: str) -> Tuple[List[Tuple[str, str]], str, str]:
+    raw = message or ""
+    if enable_redaction:
+        clean, found = redact(raw)
+    else:
+        clean, found = raw, {"emails": [], "phones": [], "ips": []}
+
+    compass = discern(clean)
+    reply = respond_with_tactic(clean, compass.tactic, gentle_tone)
+
+    # Add a short “why” trace for transparency
+    trace = {
+        "compass_state": compass.state,
+        "signals": compass.signals,
+        "applied_tactic": compass.tactic,
+    }
+    trace_md = (
+        f"**Trace** — state: `{trace['compass_state']}` | "
+        f"signals: `{', '.join(trace['signals']) or 'none'}` | "
+        f"tactic: `{trace['applied_tactic']}`"
+    )
+
+    # Append-only audit JSONL
+    event = make_audit_event(clean, found, compass, reply)
+    if log_path:
+        p = Path(log_path).expanduser()
+        p.parent.mkdir(parents=True, exist_ok=True)
+        with p.open("a", encoding="utf-8") as f:
+            f.write(json.dumps(asdict(event), ensure_ascii=False) + "\n")
+
+    history = history + [(raw, reply + "\n\n" + trace_md)]
+    return history, json.dumps(asdict(event), indent=2, ensure_ascii=False), str(Path(log_path).expanduser())
+
+# --- UI ----------------------------------------------------------------------
+def build_ui():
+    with gr.Blocks(title="BLUX-cA Demo", css="footer{visibility:hidden}") as demo:
+        gr.Markdown("# BLUX-cA Demo\nSmall, explainable agent aligned to a constitution.")
+
+        with gr.Row():
+            with gr.Column(scale=2):
+                chat = gr.Chatbot(height=420, label="Conversation")
+                msg = gr.Textbox(placeholder="Share context or ask for help…", autofocus=True)
+                with gr.Row():
+                    redact_toggle = gr.Checkbox(True, label="Redact personal data (email/phone/IP)")
+                    gentle_tone = gr.Checkbox(True, label="Gentle tone")
+                send = gr.Button("Send", variant="primary")
+
+            with gr.Column(scale=1):
+                gr.Markdown("### Constitution")
+                rules = gr.HighlightedText(
+                    value=[(r, "rule") for r in CONSTITUTION],
+                    label="Active rules (short form)",
+                    show_legend=False,
+                    interactive=False,
+                )
+                gr.Markdown("### Audit (latest event)")
+                audit_json = gr.JSON(label="Event", value={})
+                log_file = gr.Textbox(
+                    value="~/.outer_void/audit/blux_ca_demo.history.jsonl",
+                    label="Audit log (JSONL file)",
+                )
+                download = gr.File(label="Download log (appears after first message)")
+
+        def on_send(history, message, red, gent, path):
+            if not (message and message.strip()):
+                return history, "", None
+            h, evt_json, path_str = ca_chat(history or [], message, red, gent, path)
+            file_ref = str(Path(path_str).expanduser())
+            return h, evt_json, file_ref if Path(file_ref).exists() else None
+
+        send.click(
+            on_send,
+            inputs=[chat, msg, redact_toggle, gentle_tone, log_file],
+            outputs=[chat, audit_json, download],
+        )
+        msg.submit(
+            on_send,
+            inputs=[chat, msg, redact_toggle, gentle_tone, log_file],
+            outputs=[chat, audit_json, download],
+        )
+
+        gr.Markdown(
+            "#### Notes\n"
+            "- This is a **toy** compass and tactic set for demo purposes.\n"
+            "- Every turn writes an **append-only JSONL** event with a trace.\n"
+            "- Redaction happens **before** analysis when enabled."
+        )
+    return demo
+
+if __name__ == "__main__":
+    build_ui().launch()

installer.sh

@@ -1,361 +0,0 @@
-#!/bin/bash
-
-# Outer Void CLI Installer
-# Installation script for the Outer Void command-line interface
-
-set -e  # Exit on any error
-
-# Colors for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# Configuration
-REPO_URL="https://github.com/Outer-Void/outer-void-cli"
-INSTALL_DIR="$HOME/.outer-void"
-BIN_DIR="$HOME/.local/bin"
-VENV_DIR="$INSTALL_DIR/venv"
-PYTHON_EXEC="python3"
-PIP_EXEC="pip3"
-
-# Logging functions
-log_info() {
-    echo -e "${BLUE}ℹ️  INFO:${NC} $1"
-}
-
-log_success() {
-    echo -e "${GREEN}✅ SUCCESS:${NC} $1"
-}
-
-log_warning() {
-    echo -e "${YELLOW}⚠️  WARNING:${NC} $1"
-}
-
-log_error() {
-    echo -e "${RED}❌ ERROR:${NC} $1"
-}
-
-# Check if command exists
-command_exists() {
-    command -v "$1" >/dev/null 2>&1
-}
-
-# Detect platform
-detect_platform() {
-    case "$(uname -s)" in
-        Linux*)     platform="Linux" ;;
-        Darwin*)    platform="macOS" ;;
-        CYGWIN*)    platform="Cygwin" ;;
-        MINGW*)     platform="MinGW" ;;
-        *)          platform="Unknown" ;;
-    esac
-    echo "$platform"
-}
-
-# Check Python installation
-check_python() {
-    if ! command_exists "$PYTHON_EXEC"; then
-        log_error "Python 3 is required but not installed."
-        log_info "Please install Python 3.8 or higher from https://python.org"
-        exit 1
-    fi
-
-    python_version=$($PYTHON_EXEC -c "import sys; print('.'.join(map(str, sys.version_info[:2])))")
-    python_version_full=$($PYTHON_EXEC -c "import sys; print(sys.version)")
-    
-    log_info "Found Python $python_version_full"
-    
-    # Check if version is at least 3.8
-    if $PYTHON_EXEC -c "import sys; exit(0 if sys.version_info >= (3, 8) else 1)"; then
-        log_success "Python version meets requirements (>= 3.8)"
-    else
-        log_error "Python 3.8 or higher is required. Found $python_version"
-        exit 1
-    fi
-}
-
-# Check pip installation
-check_pip() {
-    if ! command_exists "$PIP_EXEC"; then
-        log_warning "pip3 not found, trying to install..."
-        
-        if command_exists "apt-get"; then
-            sudo apt-get update && sudo apt-get install -y python3-pip
-        elif command_exists "yum"; then
-            sudo yum install -y python3-pip
-        elif command_exists "brew"; then
-            brew install python3
-        else
-            log_error "Please install pip3 manually"
-            exit 1
-        fi
-    fi
-
-    if command_exists "$PIP_EXEC"; then
-        pip_version=$($PIP_EXEC --version)
-        log_success "Found pip: $pip_version"
-    else
-        log_error "pip3 is required but not installed"
-        exit 1
-    fi
-}
-
-# Create directory structure
-create_directories() {
-    log_info "Creating installation directories..."
-    
-    mkdir -p "$INSTALL_DIR"
-    mkdir -p "$BIN_DIR"
-    
-    log_success "Created installation directory: $INSTALL_DIR"
-    log_success "Created bin directory: $BIN_DIR"
-}
-
-# Create virtual environment
-create_venv() {
-    log_info "Creating Python virtual environment..."
-    
-    if [ -d "$VENV_DIR" ]; then
-        log_warning "Virtual environment already exists, recreating..."
-        rm -rf "$VENV_DIR"
-    fi
-    
-    $PYTHON_EXEC -m venv "$VENV_DIR"
-    
-    # Update Python and pip executables to use venv
-    PYTHON_EXEC="$VENV_DIR/bin/python"
-    PIP_EXEC="$VENV_DIR/bin/pip"
-    
-    log_success "Virtual environment created at $VENV_DIR"
-}
-
-# Install package
-install_package() {
-    log_info "Installing Outer Void CLI..."
-    
-    # Check if we're in a development directory with pyproject.toml
-    if [ -f "pyproject.toml" ] && [ -d "ov" ]; then
-        log_info "Installing from local development copy..."
-        $PIP_EXEC install -e .
-    else
-        log_info "Installing from PyPI..."
-        $PIP_EXEC install outer-void-cli
-    fi
-    
-    log_success "Package installed successfully"
-}
-
-# Create symlinks
-create_symlinks() {
-    log_info "Creating application symlinks..."
-    
-    # Remove existing symlinks
-    rm -f "$BIN_DIR/outer-void"
-    rm -f "$BIN_DIR/ov"
-    
-    # Create new symlinks
-    ln -sf "$VENV_DIR/bin/outer-void" "$BIN_DIR/outer-void"
-    ln -sf "$VENV_DIR/bin/ov" "$BIN_DIR/ov"
-    
-    # Make scripts executable
-    chmod +x "$VENV_DIR/bin/outer-void"
-    chmod +x "$VENV_DIR/bin/ov"
-    
-    log_success "Created symlinks: outer-void, ov"
-}
-
-# Add bin directory to PATH
-setup_path() {
-    log_info "Setting up PATH..."
-    
-    local shell_rc=""
-    case "$SHELL" in
-        */bash) shell_rc="$HOME/.bashrc" ;;
-        */zsh) shell_rc="$HOME/.zshrc" ;;
-        */fish) shell_rc="$HOME/.config/fish/config.fish" ;;
-        *) shell_rc="$HOME/.profile" ;;
-    esac
-    
-    if [ -n "$shell_rc" ] && [ -f "$shell_rc" ]; then
-        if ! grep -q "$BIN_DIR" "$shell_rc"; then
-            echo "export PATH=\"$BIN_DIR:\$PATH\"" >> "$shell_rc"
-            log_success "Added $BIN_DIR to PATH in $shell_rc"
-        else
-            log_info "$BIN_DIR already in PATH"
-        fi
-    else
-        log_warning "Could not detect shell configuration file"
-        log_info "Please add this to your shell profile:"
-        echo "export PATH=\"$BIN_DIR:\$PATH\""
-    fi
-}
-
-# Verify installation
-verify_installation() {
-    log_info "Verifying installation..."
-    
-    # Refresh shell
-    export PATH="$BIN_DIR:$PATH"
-    
-    if command_exists "outer-void"; then
-        log_success "Outer Void CLI installed successfully!"
-        
-        # Test the installation
-        if outer-void version >/dev/null 2>&1; then
-            log_success "CLI is functioning correctly"
-        else
-            log_warning "CLI installed but may have issues running"
-        fi
-    else
-        log_error "Installation verification failed"
-        exit 1
-    fi
-}
-
-# Display post-install message
-show_post_install() {
-    echo
-    echo -e "${GREEN}🎉 Outer Void CLI Installation Complete!${NC}"
-    echo
-    echo "📁 Installation directory: $INSTALL_DIR"
-    echo "🔗 Binary directory: $BIN_DIR"
-    echo "🐍 Virtual environment: $VENV_DIR"
-    echo
-    echo "🚀 Available commands:"
-    echo "   outer-void    Main command"
-    echo "   ov            Short alias"
-    echo
-    echo "📚 Usage examples:"
-    echo "   outer-void summary          # Show organization overview"
-    echo "   outer-void list repos       # List GitHub repositories"
-    echo "   outer-void list models      # List Hugging Face models"
-    echo "   outer-void web              # Open web dashboard"
-    echo "   outer-void --help           # Show help"
-    echo
-    echo "💡 You may need to restart your terminal or run:"
-    echo "   source ~/.bashrc  # or source ~/.zshrc"
-    echo
-}
-
-# Cleanup function
-cleanup() {
-    if [ $? -ne 0 ]; then
-        log_error "Installation failed. Cleaning up..."
-        rm -rf "$INSTALL_DIR"
-    fi
-}
-
-# Main installation function
-main() {
-    echo -e "${BLUE}"
-    echo "🌌 Outer Void CLI Installer"
-    echo "=========================="
-    echo -e "${NC}"
-    
-    # Set trap for cleanup on failure
-    trap cleanup EXIT
-    
-    # Detect platform
-    platform=$(detect_platform)
-    log_info "Detected platform: $platform"
-    
-    # Run installation steps
-    check_python
-    check_pip
-    create_directories
-    create_venv
-    install_package
-    create_symlinks
-    setup_path
-    verify_installation
-    show_post_install
-    
-    # Remove trap on success
-    trap - EXIT
-}
-
-# Uninstall function
-uninstall() {
-    echo -e "${YELLOW}"
-    echo "🗑️  Uninstalling Outer Void CLI"
-    echo "============================="
-    echo -e "${NC}"
-    
-    read -p "Are you sure you want to uninstall Outer Void CLI? (y/N): " -n 1 -r
-    echo
-    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
-        log_info "Uninstall cancelled"
-        exit 0
-    fi
-    
-    log_info "Removing installation directory: $INSTALL_DIR"
-    rm -rf "$INSTALL_DIR"
-    
-    log_info "Removing symlinks"
-    rm -f "$BIN_DIR/outer-void"
-    rm -f "$BIN_DIR/ov"
-    
-    log_success "Outer Void CLI uninstalled successfully"
-}
-
-# Update function
-update() {
-    echo -e "${BLUE}"
-    echo "🔄 Updating Outer Void CLI"
-    echo "========================"
-    echo -e "${NC}"
-    
-    if [ ! -d "$INSTALL_DIR" ]; then
-        log_error "Outer Void CLI not found. Please install first."
-        exit 1
-    fi
-    
-    log_info "Updating Outer Void CLI..."
-    
-    # Use venv pip if available
-    if [ -f "$VENV_DIR/bin/pip" ]; then
-        PIP_EXEC="$VENV_DIR/bin/pip"
-    fi
-    
-    $PIP_EXEC install --upgrade outer-void-cli
-    log_success "Outer Void CLI updated successfully"
-}
-
-# Show usage
-usage() {
-    echo "Usage: $0 [command]"
-    echo
-    echo "Commands:"
-    echo "  install    Install Outer Void CLI (default)"
-    echo "  uninstall  Remove Outer Void CLI"
-    echo "  update     Update Outer Void CLI to latest version"
-    echo "  help       Show this help message"
-    echo
-    echo "Examples:"
-    echo "  $0 install     # Install the CLI"
-    echo "  $0 update      # Update the CLI"
-    echo "  $0 uninstall   # Remove the CLI"
-}
-
-# Parse command line arguments
-case "${1:-install}" in
-    install|"")
-        main
-        ;;
-    uninstall|remove)
-        uninstall
-        ;;
-    update|upgrade)
-        update
-        ;;
-    help|--help|-h)
-        usage
-        ;;
-    *)
-        log_error "Unknown command: $1"
-        usage
-        exit 1
-        ;;
-esac

ov.py

@@ -1,23 +0,0 @@
-#!/usr/bin/env python3
-"""
-ov.py — Minimal root runner for Outer Void CLI
-"""
-
-import sys
-import os
-
-# Add current directory to Python path
-sys.path.insert(0, os.path.dirname(__file__))
-
-try:
-    from ov.cli import main
-except ImportError:
-    print("❌ Could not import Outer Void CLI")
-    print("💡 Make sure:")
-    print("   - The 'ov' directory exists with __init__.py and cli.py")
-    print("   - You're in the correct directory")
-    print("   - Or install with: pip install -e .")
-    sys.exit(1)
-
-if __name__ == "__main__":
-    main()

ov/__init__.py

@@ -1,6 +0,0 @@
-"""Outer Void CLI package."""
-__version__ = "1.0.0"
-__author__ = "Outer Void Team, Justadudeinspace"
-
-# Import main for easy access
-from .cli import main

ov/cli.py

@@ -1,427 +0,0 @@
-#!/usr/bin/env python3
-"""
-Outer Void CLI - Precision interface for the Outer Void ecosystem.
-"""
-
-import os
-import sys
-import json
-import webbrowser
-import argparse
-import time
-from pathlib import Path
-from typing import Optional, Dict, Any, List, Tuple
-from dataclasses import dataclass
-
-# Add this line to make relative imports work
-sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
-
-import requests
-import gradio as gr
-
-# Configuration
-ORG_NAME = "Outer-Void"
-HF_BASE = f"https://huggingface.co/api/organizations/{ORG_NAME}"
-GH_BASE = f"https://api.github.com/orgs/{ORG_NAME}/repos"
-
-# Rate limiting and retry configuration
-REQUEST_TIMEOUT = 15
-MAX_RETRIES = 3
-RETRY_DELAY = 1
-
-@dataclass
-class OrgStats:
-    """Precise organization statistics container"""
-    hf_members: int = 0
-    hf_models: int = 0
-    gh_repos: int = 0
-    gh_top_repos: List[Dict[str, Any]] = None
-    last_updated: Optional[float] = None
-
-    def __post_init__(self):
-        if self.gh_top_repos is None:
-            self.gh_top_repos = []
-
-
-class OuterVoidClient:
-    """Precision client for Outer Void ecosystem APIs"""
-    
-    def __init__(self):
-        self.session = requests.Session()
-        self.session.headers.update({
-            'User-Agent': 'OuterVoid-CLI/1.0',
-            'Accept': 'application/json'
-        })
-        self.stats = OrgStats()
-    
-    def main():
-    """Precision main function with enhanced argument parsing"""
-    parser = argparse.ArgumentParser(
-        description="Outer Void Ecosystem CLI - Precision Interface",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog="""
-Examples:
-  python ov.py summary          # Show detailed organization overview
-  python ov.py web              # Open organization web pages
-  python ov.py export           # Export data as JSON
-  python ov.py list repos       # List all GitHub repositories
-  python ov.py list models      # List all Hugging Face models
-  python ov.py list all         # List both repos and models
-  python ov.py version          # Show version information
-        """,
-        add_help=False  # We'll add custom help handling
-    )
-    
-    # Add help argument manually to control behavior
-    parser.add_argument(
-        '-h', '--help',
-        action='help',
-        default=argparse.SUPPRESS,
-        help='Show this help message and exit'
-    )
-    
-    parser.add_argument(
-        'command',
-        nargs='?',
-        choices=['summary', 'web', 'export', 'list', 'version'],
-        help='Command to execute'
-    )
-    
-    parser.add_argument(
-        'subcommand',
-        nargs='?',
-        help='Subcommand for list command (repos|models|all)'
-    )
-    
-    parser.add_argument(
-        '--format', '-f',
-        choices=['json', 'table', 'csv'],
-        default='table',
-        help='Output format for list/export (default: table)'
-    )
-    
-    parser.add_argument(
-        '--limit', '-l',
-        type=int,
-        default=50,
-        help='Limit number of items to display (default: 50)'
-    )
-    
-    parser.add_argument(
-        '--verbose', '-v',
-        action='store_true',
-        help='Enable verbose output'
-    )
-    
-    # If no arguments provided, show help
-    if len(sys.argv) == 1:
-        parser.print_help()
-        sys.exit(0)
-    
-    args = parser.parse_args()
-    
-    # Handle help for specific commands
-    if args.command == 'list' and args.subcommand in [None, 'help', '-h', '--help']:
-        print("List command usage:")
-        print("  python ov.py list repos       # List GitHub repositories")
-        print("  python ov.py list models      # List Hugging Face models")
-        print("  python ov.py list all         # List both repos and models")
-        print("\nOptions for list command:")
-        print("  --format table|json|csv       # Output format (default: table)")
-        print("  --limit NUMBER               # Limit results (default: 50)")
-        print("  --verbose                    # Show detailed information")
-        sys.exit(0)
-    
-    # Initialize client
-    client = OuterVoidClient()
-    
-    try:
-        if args.command == 'summary':
-            if args.verbose:
-                print("🔍  Verbose mode enabled - gathering detailed organization data...")
-            show_org_summary(client)
-            
-        elif args.command == 'web':
-            open_web_dash()
-            
-        elif args.command == 'export':
-            export_data(args.format, client, args.limit)
-            
-        elif args.command == 'list':
-            if not args.subcommand:
-                print("❌  Please specify what to list: repos, models, or all")
-                print("💡  Use: python ov.py list --help for usage information")
-                sys.exit(1)
-            list_data(args.subcommand, args.format, args.limit, client, args.verbose)
-            
-        elif args.command == 'version':
-            print("Outer Void CLI v1.0.0 - Precision Edition")
-            
-        else:
-            parser.print_help()
-            
-    except KeyboardInterrupt:
-        print("\n⚠️  Operation cancelled by user")
-        sys.exit(1)
-    except Exception as e:
-        print(f"💥  Unexpected error: {e}")
-        if args.verbose:
-            import traceback
-            traceback.print_exc()
-        sys.exit(1)
-    
-    def fetch_json_with_retry(self, url: str) -> Optional[Dict[Any, Any]]:
-        """Robust JSON fetching with retry logic and precise error handling"""
-        for attempt in range(MAX_RETRIES):
-            try:
-                response = self.session.get(url, timeout=REQUEST_TIMEOUT)
-                response.raise_for_status()
-                
-                # Validate JSON content type
-                content_type = response.headers.get('content-type', '')
-                if 'application/json' not in content_type:
-                    print(f"⚠️  Unexpected content type from {url}: {content_type}")
-                    return None
-                
-                return response.json()
-                
-            except requests.exceptions.Timeout:
-                print(f"⏰  Timeout fetching {url} (attempt {attempt + 1}/{MAX_RETRIES})")
-            except requests.exceptions.ConnectionError as e:
-                print(f"🔌  Connection error fetching {url}: {e}")
-            except requests.exceptions.HTTPError as e:
-                print(f"🚨  HTTP error fetching {url}: {e.response.status_code} - {e.response.reason}")
-                # Don't retry on client errors
-                if 400 <= e.response.status_code < 500:
-                    break
-            except json.JSONDecodeError as e:
-                print(f"📄  JSON decode error from {url}: {e}")
-                break
-            except Exception as e:
-                print(f"❓  Unexpected error fetching {url}: {e}")
-            
-            if attempt < MAX_RETRIES - 1:
-                time.sleep(RETRY_DELAY * (2 ** attempt))  # Exponential backoff
-        
-        return None
-
-    def gather_organization_data(self) -> OrgStats:
-        """Precisely gather all organization data with comprehensive error handling"""
-        print("🔄  Gathering Outer Void organization data...")
-        
-        # Hugging Face data
-        hf_data = self.fetch_json_with_retry(HF_BASE)
-        if hf_data:
-            self.stats.hf_members = len(hf_data.get('members', []))
-            # Handle different possible structures for models
-            models = hf_data.get('models', [])
-            if isinstance(models, list):
-                self.stats.hf_models = len(models)
-            else:
-                self.stats.hf_models = 0
-        else:
-            print("🤗  Hugging Face data unavailable.")
-        
-        # GitHub data with pagination support
-        gh_repos = self._fetch_all_github_repos()
-        if gh_repos is not None:
-            self.stats.gh_repos = len(gh_repos)
-            # Sort by update time and take top 10
-            sorted_repos = sorted(gh_repos, 
-                                key=lambda x: x.get('updated_at', ''), 
-                                reverse=True)
-            self.stats.gh_top_repos = sorted_repos[:10]
-        else:
-            print("🐙  GitHub data unavailable.")
-        
-        self.stats.last_updated = time.time()
-        return self.stats
-    
-    def _fetch_all_github_repos(self) -> Optional[List[Dict[str, Any]]]:
-        """Fetch all GitHub repos with pagination support"""
-        all_repos = []
-        page = 1
-        per_page = 100
-        
-        while True:
-            try:
-                url = f"{GH_BASE}?page={page}&per_page={per_page}&sort=updated"
-                repos = self.fetch_json_with_retry(url)
-                
-                if not repos or not isinstance(repos, list):
-                    break
-                    
-                all_repos.extend(repos)
-                
-                # Check if we've got all repos (GitHub returns empty list when done)
-                if len(repos) < per_page:
-                    break
-                    
-                page += 1
-                
-            except Exception as e:
-                print(f"⚠️  Error in GitHub pagination: {e}")
-                break
-        
-        return all_repos if all_repos else None
-
-
-def show_org_summary(client: Optional[OuterVoidClient] = None):
-    """Display a precise and formatted organization summary"""
-    if client is None:
-        client = OuterVoidClient()
-    
-    stats = client.gather_organization_data()
-    
-    print(f"\n🌌  Outer Void Organization Overview")
-    print("=" * 50)
-    
-    # Hugging Face section
-    print("🤗  Hugging Face Hub:")
-    print(f"   ├─ Organization: {ORG_NAME}")
-    print(f"   ├─ Members: {stats.hf_members}")
-    print(f"   └─ Models: {stats.hf_models}")
-    
-    # GitHub section
-    print(f"\n🐙  GitHub Organization:")
-    print(f"   └─ Total Repositories: {stats.gh_repos}")
-    
-    if stats.gh_top_repos:
-        print(f"\n📚  Recently Updated Repositories:")
-        for i, repo in enumerate(stats.gh_top_repos, 1):
-            name = repo.get('name', 'Unknown')
-            description = repo.get('description', 'No description')
-            stars = repo.get('stargazers_count', 0)
-            updated = repo.get('updated_at', '').split('T')[0]  # Just the date part
-            
-            print(f"   {i:2d}. {name}")
-            if description:
-                print(f"       📝 {description[:60]}{'...' if len(description) > 60 else ''}")
-            print(f"       ⭐ {stars} stars | 📅 Updated: {updated}")
-    
-    # Quick links
-    print(f"\n🔗  Quick Links:")
-    print(f"   ├─ Hugging Face: https://huggingface.co/{ORG_NAME}")
-    print(f"   ├─ GitHub: https://github.com/{ORG_NAME}")
-    print(f"   └─ This report generated: {time.strftime('%Y-%m-%d %H:%M:%S')}")
-    print()
-
-
-def open_web_dash():
-    """Precisely open web dashboard with validation"""
-    urls = [
-        f"https://huggingface.co/{ORG_NAME}",
-        f"https://github.com/{ORG_NAME}"
-    ]
-    
-    print("🌐  Opening Outer Void organization pages...")
-    for url in urls:
-        try:
-            webbrowser.open(url)
-            print(f"   ✅ Opened: {url}")
-        except webbrowser.Error as e:
-            print(f"   ❌ Failed to open {url}: {e}")
-
-
-def export_data(format_type: str = "json", client: Optional[OuterVoidClient] = None):
-    """Precise data export with multiple format support"""
-    if client is None:
-        client = OuterVoidClient()
-    
-    stats = client.gather_organization_data()
-    
-    if format_type.lower() == "json":
-        output_file = Path("outervoid_org_data.json")
-        data = {
-            "metadata": {
-                "organization": ORG_NAME,
-                "generated_at": time.strftime('%Y-%m-%d %H:%M:%S UTC'),
-                "source": "Outer Void CLI"
-            },
-            "huggingface": {
-                "members": stats.hf_members,
-                "models": stats.hf_models,
-                "url": f"https://huggingface.co/{ORG_NAME}"
-            },
-            "github": {
-                "total_repositories": stats.gh_repos,
-                "recent_repositories": stats.gh_top_repos
-            }
-        }
-        
-        try:
-            output_file.write_text(json.dumps(data, indent=2, ensure_ascii=False))
-            print(f"💾  Data successfully exported → {output_file.resolve()}")
-            print(f"    📊 Contains: {stats.hf_members} members, {stats.hf_models} models, {stats.gh_repos} repos")
-        except Exception as e:
-            print(f"❌  Failed to write export file: {e}")
-    
-    else:
-        print(f"❌  Unsupported export format: {format_type}")
-        print("    Supported formats: json")
-
-
-def main():
-    """Precision main function with enhanced argument parsing"""
-    parser = argparse.ArgumentParser(
-        description="Outer Void Ecosystem CLI - Precision Interface",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog="""
-Examples:
-  python ov.py summary          # Show detailed organization overview
-  python ov.py web              # Open organization web pages
-  python ov.py export           # Export data as JSON
-  python ov.py export --format json  # Explicit JSON export
-        """
-    )
-    
-    parser.add_argument(
-        'command',
-        choices=['summary', 'web', 'export', 'version'],
-        help='Command to execute'
-    )
-    
-    parser.add_argument(
-        '--format', '-f',
-        choices=['json'],
-        default='json',
-        help='Export format (default: json)'
-    )
-    
-    parser.add_argument(
-        '--verbose', '-v',
-        action='store_true',
-        help='Enable verbose output'
-    )
-    
-    args = parser.parse_args()
-    
-    # Initialize client
-    client = OuterVoidClient()
-    
-    try:
-        if args.command == 'summary':
-            if args.verbose:
-                print("🔍  Verbose mode enabled - gathering detailed organization data...")
-            show_org_summary(client)
-            
-        elif args.command == 'web':
-            open_web_dash()
-            
-        elif args.command == 'export':
-            export_data(args.format, client)
-            
-        elif args.command == 'version':
-            print("Outer Void CLI v1.0.0 - Precision Edition")
-            
-    except KeyboardInterrupt:
-        print("\n⚠️  Operation cancelled by user")
-        sys.exit(1)
-    except Exception as e:
-        print(f"💥  Unexpected error: {e}")
-        if args.verbose:
-            import traceback
-            traceback.print_exc()
-        sys.exit(1)
-
-def main():

pyproject.toml

@@ -1,141 +0,0 @@
-[build-system]
-requires = ["setuptools>=61.0", "wheel"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "outer-void-cli"
-version = "1.0.0"
-description = "Outer Void Ecosystem CLI - Precision Interface for Hugging Face and GitHub organizations"
-readme = "README.md"
-authors = [
-    {name = "Outer Void Team", email = "contact@outer-void.org"},
-]
-license = {text = "MIT"}
-keywords = ["cli", "huggingface", "github", "organization", "ai", "models"]
-classifiers = [
-    "Development Status :: 4 - Beta",
-    "Intended Audience :: Developers",
-    "Intended Audience :: Science/Research",
-    "License :: OSI Approved :: MIT License",
-    "Operating System :: OS Independent",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
-    "Programming Language :: Python :: 3.9",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Topic :: Utilities",
-    "Topic :: Scientific/Engineering",
-    "Topic :: Software Development :: Libraries :: Python Modules",
-]
-
-dependencies = [
-    "requests>=2.28.0",
-    "rich>=13.0.0",
-    "python-dotenv>=1.0.0",
-    "tabulate>=0.9.0",
-    "colorama>=0.4.6; sys_platform == 'win32'",
-]
-
-requires-python = ">=3.8"
-
-[project.optional-dependencies]
-dev = [
-    "pytest>=7.0.0",
-    "pytest-cov>=4.0.0",
-    "black>=23.0.0",
-    "isort>=5.12.0",
-    "flake8>=6.0.0",
-    "mypy>=1.0.0",
-    "pre-commit>=3.0.0",
-]
-docs = [
-    "mkdocs>=1.4.0",
-    "mkdocs-material>=9.0.0",
-    "mkdocstrings[python]>=0.22.0",
-]
-all = [
-    "outer-void-cli[dev]",
-    "outer-void-cli[docs]",
-]
-
-[project.urls]
-Homepage = "https://github.com/Outer-Void/outer-void-cli"
-Documentation = "https://outer-void.github.io/outer-void-cli"
-Repository = "https://github.com/Outer-Void/outer-void-cli"
-Issues = "https://github.com/Outer-Void/outer-void-cli/issues"
-"Changelog" = "https://github.com/Outer-Void/outer-void-cli/releases"
-
-[project.scripts]
-outer-void = "ov:main"
-ov = "ov:main"
-
-[tool.setuptools.packages.find]
-where = ["."]
-include = ["*"]
-
-[tool.black]
-line-length = 88
-target-version = ['py38']
-include = '\.pyi?$'
-extend-exclude = '''
-/(
-  # directories
-  \.eggs
-  | \.git
-  | \.hg
-  | \.mypy_cache
-  | \.tox
-  | \.venv
-  | build
-  | dist
-)/
-'''
-
-[tool.isort]
-profile = "black"
-multi_line_output = 3
-line_length = 88
-
-[tool.mypy]
-python_version = "3.8"
-warn_return_any = true
-warn_unused_configs = true
-disallow_untyped_defs = true
-disallow_incomplete_defs = true
-check_untyped_defs = true
-disallow_untyped_decorators = true
-no_implicit_optional = true
-warn_redundant_casts = true
-warn_unused_ignores = true
-warn_no_return = true
-
-[tool.pytest.ini_options]
-minversion = "7.0"
-addopts = "--verbose --color=yes --cov=ov --cov-report=term-missing --cov-report=html"
-testpaths = ["tests"]
-python_files = ["test_*.py"]
-python_classes = ["Test*"]
-python_functions = ["test_*"]
-
-[tool.coverage.run]
-source = ["ov"]
-omit = [
-    "*/tests/*",
-    "*/test_*",
-    "*/__pycache__/*",
-]
-
-[tool.coverage.report]
-exclude_lines = [
-    "pragma: no cover",
-    "def __repr__",
-    "if self.debug:",
-    "if settings.DEBUG",
-    "raise AssertionError",
-    "raise NotImplementedError",
-    "if 0:",
-    "if __name__ == .__main__.:",
-    "class .*\\bProtocol\\b":,
-    "@(abc\\.)?abstractmethod",
-]

quick-install.sh

@@ -1,15 +0,0 @@
-#!/bin/bash
-set -e
-
-echo "🚀 Quick installing Outer Void CLI..."
-
-# Check for Python
-if ! command -v python3 &> /dev/null; then
-    echo "❌ Python 3 required. Install from https://python.org"
-    exit 1
-fi
-
-# Install via pip
-pip3 install outer-void-cli
-
-echo "✅ Installed! Use: outer-void --help"

requirements-dev.txt

@@ -1,18 +0,0 @@
-# Production dependencies
-requests>=2.28.0
-python-dotenv>=1.0.0
-
-# Enhanced output (optional but recommended)
-rich>=13.0.0
-tabulate>=0.9.0
-
-# Development tools
-pytest>=7.0.0
-black>=23.0.0
-flake8>=6.0.0
-mypy>=1.0.0
-pre-commit>=3.0.0
-
-# Documentation
-mkdocs>=1.4.0
-mkdocs-material>=9.0.0

requirements.txt

@@ -1,18 +0,0 @@
-# Core dependencies
-requests==2.31.0
-urllib3==2.0.4
-
-# CLI enhancements
-rich==13.5.2
-argcomplete==3.1.2
-tabulate==0.9.0
-colorama==0.4.6
-click==8.1.7
-
-# Configuration & data
-python-dotenv==1.0.0
-pyyaml==6.0.1
-
-# Utilities
-tqdm==4.65.0
-python-dateutil==2.8.2

tests/__init__.py

@@ -1 +0,0 @@
-# Test package