Data

Tools

Indexes

Applications

Experiments

Open Source Science

https://github.com/ayjays132/resonance-sandbox

A research-grade toolkit for Semantic–Physical Resonance: flux→manifold deformations, energy & stability analysis, meta-learning, and human-in-the-loop exploration.

https://github.com/ayjays132/resonance-sandbox

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ○
    CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ○
    DOI references
  • ○
    Academic publication links
  • ○
    Academic email domains
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (10.2%) to scientific vocabulary
Last synced: 10 months ago · JSON representation

Repository

A research-grade toolkit for Semantic–Physical Resonance: flux→manifold deformations, energy & stability analysis, meta-learning, and human-in-the-loop exploration.

Basic Info
  • Host: GitHub
  • Owner: ayjays132
  • License: apache-2.0
  • Language: Python
  • Default Branch: main
  • Size: 509 KB
Statistics
  • Stars: 1
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 1
Created about 1 year ago · Last pushed about 1 year ago
Metadata Files
Readme License

README.md

<!DOCTYPE html>

🚀 Resonance Sandbox Toolkit

An open-source Python framework for prototyping semantic-physical resonance, providing: flux→manifold deformation operators, energy & stability diagnostics, meta-learning routines, and interactive CLI and asset generation scripts.

📂 Included Modules & Scripts

  • resonancesandbox/flux.py – RelationalFlux: high-dimensional semantic vectors with perturb, normalize, serialization.
  • resonancesandbox/manifold.py – ContextualManifold: dynamic adjacency matrix with symmetric deformations and energy.
  • resonancesandbox/operator.py – ResonanceOperator: maps flux→deformation with guaranteed nonzero effect, diagnostics, serialization.
  • resonancesandbox/stability.py – stabilitytest: measure energy changes under flux perturbations.
  • resonancesandbox/energy.py – computeenergy: Frobenius norm + optional spectral and graph metrics.
  • resonancesandbox/metalearning.py – randomsearch: lightweight meta-learning over operator weights.
  • resonancesandbox/humaninterface.py – texttoflux & humantest: convert text→flux, show adjacency snippets & metrics.
  • resonancesandbox/scripts/generateassets.py – CSV/PNG/JSON asset generator with CLI overrides and progress bar.
  • resonancesandbox/sandbox.py – resonance-sandbox CLI: null/positive/stability/energy/meta-learn/human-test commands.

⚙️ Installation & Setup

  1. Clone or unzip this repo.
    git clone https://github.com/ayjays132/resonance-sandbox.git
cd resonance-sandbox
  2. Create & activate a venv: 
    python -m venv .venv
    


    Windows PowerShell
    


    ..venv\Scripts\Activate.ps1
    


    macOS/Linux
    


    source .venv/bin/activate
  3. Install dependencies and editable package: 
    pip install --upgrade pip wheel
pip install -r requirements.txt
pip install -e .

👩‍💻 CLI Usage

All commands use config/config.yaml by default. Example flags:

  • --null-test: verify zero-flux yields zero deformation
  • --positive-test: ensure nonzero flux deforms manifold
  • --stability-test: sweep noise scales for energy stability
  • --energy-monitor: measure a single random-flux energy
  • --meta-learn: random‐search optimization of operator weights
  • --human-test "Your text here": text→flux→3×3 snippet + full metrics

🖥️ Example Session

(.venv) PS D:\AGITruly\resonancesandbox_windows> & ..venv\Scripts\Activate.ps1



==> Running pytest ==
pytest -q
.... [100%] 4 passed



==> Generating assets ==
python -m resonancesandbox.scripts.generateassets
[2025-05-12 ...] INFO: Generating 5 assets to 'assets/data'…
Assets: 100% 5/5
[2025-05-12 ...] INFO: Saved metadata JSON: assets/data\metadata.json



==> Assets folder contents ==
ls .\assets\data
adj000.csv  graph000.png  ... metadata.json



==> CLI: --null-test ==
resonance-sandbox --null-test
Null Test Δ-max: 1e-15



==> CLI: --positive-test ==
resonance-sandbox --positive-test
Positive Test Δ-max: 0.07



==> CLI: --stability-test ==
resonance-sandbox --stability-test
Noise 0.0001: E0=0.0, E1=25701.47
Noise 0.001 : E0=0.0, E1=9636.25
Noise 0.01  : E0=0.0, E1=28627.68



==> CLI: --energy-monitor ==
resonance-sandbox --energy-monitor
Energy: 0.0801



==> CLI: --meta-learn ==
resonance-sandbox --meta-learn
Meta-learned best fitness: 4207.04



==> CLI: --human-test ==
resonance-sandbox --human-test "The quick brown fox"
[INFO] Human test on text: 'The quick brown fox'
Human Test snippet: [[0.00196, -0.00008, 0.00107], …]
Metrics: {'frobeniusnorm':0.0072, 'spectralradius':0.0072, …}

📦 Installation Without a Virtual Environment

To install system-wide or into your user site (no venv):

# From the project root (where Dockerfile resides)
pip install --upgrade pip
pip install --user dist\resonance_sandbox-0.2.0-py3-none-any.whl

Ensure %USERPROFILE%\AppData\Roaming\Python\Python310\Scripts is in your PATH so resonance-sandbox is available globally.

📜 License

Released under the MIT License. Free to use, modify, and share.

Owner

  • Login: ayjays132
  • Kind: user

GitHub Events

Total
  • Release event: 1
  • Watch event: 1
  • Push event: 5
  • Create event: 1
Last Year
  • Release event: 1
  • Watch event: 1
  • Push event: 5
  • Create event: 1