Skip to content
BranchesTags

Repository files navigation

Repository Status: SUPPORTING — GOVERNANCE & PHILOSOPHICAL TEMPLATE
Public Review Note: This repository is explicitly classified to prevent ambiguity between production canon, support infrastructure, historical archives, and demos.

🌾🌌 OINIO Soul System

A private encrypted oracle for soul evolution through epochs.

Dependency-free. Unified. Sealed for executable form.

✨ Features

  • Multi-User Support — Separate accounts with individual encrypted soul registries
  • Secure Authentication — PBKDF2 password hashing (100,000 iterations, SHA-512)
  • Deterministic Oracle — Same question + soul + epoch = same reading
  • ⚡ Quantum Enhancement — Optional AI-powered harmony predictions via Pi Forge integration
  • AES-256-GCM Encryption — All souls protected by your password
  • Data Isolation — Each user's souls are completely separate and private
  • Zero Dependencies — Standalone binaries, no Node.js required
  • Cross-Platform — Windows, macOS, Linux
  • Private & Local — All data stays on your machine
  • Dual-Mode Oracle — Toggle between deterministic and quantum-enhanced readings

🚀 Quick Start

  1. Download the binary for your OS from Releases
  2. Make it executable (Linux/macOS): chmod +x oinio-system-*
  3. Run: ./oinio-system-linux (or your platform's binary)
  4. Create an account or login with your username and password
  5. Create your first soul and begin the epoch cycle

⚙️ Configuration

Environment Variables

OINIO respects these environment variables for customization:

Variable Default Description
PI_FORGE_PATH ~/pi-forge-quantum-genesis Path to Pi Forge integration
BASE_PATH Auto-detected Custom data storage directory
PBKDF2_ITERATIONS 100000 Password hashing iterations
QUANTUM_TIMEOUT_MS 3000 Quantum enhancement timeout (ms)
ENABLE_QUANTUM true Enable quantum mode if Forge available

CLI Options

# Show version
./oinio-system --version

# Show help
./oinio-system --help

# Run with custom configuration
PI_FORGE_PATH=/path/to/forge BASE_PATH=/secure/data ./oinio-system

🚀 Phase 2 Preview

This release prepares OINIO for web deployment:

  • Clean architecture with no code duplication
  • Configurable paths for containerization
  • Modular design ready for API extraction
  • Production-ready error handling

Coming Soon: Web interface, API endpoints, Docker deployment

Stay tuned! 🌐

👤 User System

Account Creation

  • Choose a unique username (3-20 characters, alphanumeric, underscore, hyphen)
  • Create a secure password (minimum 8 characters)
  • Your password encrypts all your soul data

Login & Security

  • Login with your username and password
  • Each user has their own encrypted soul registry (souls_username.enc)
  • Passwords are hashed with PBKDF2 (100,000 iterations)
  • User credentials stored in encrypted users.enc file
  • Cannot recover forgotten passwords — choose wisely!

Switching Users

  • Press [L] in the main menu to logout
  • You can create multiple accounts on the same machine
  • Each user's data is completely isolated

🛡️ Security & Safety Warnings

This software is completely safe. You may see security warnings because the binaries are not code-signed (which costs $$$ annually). Here's how to proceed:

Why Warnings Appear

  • Binaries are unsigned (not from Microsoft/Apple verified developer)
  • This is normal for open-source projects
  • All source code is visible in this repository — inspect it yourself!

How to Bypass Warnings

Windows:

  • If Windows Defender blocks it: Click "More info" → "Run anyway"
  • If SmartScreen appears: "More info" → "Run anyway"
  • You can also right-click → Properties → check "Unblock" → Apply

macOS:

  • Right-click the binary → "Open" (don't double-click)
  • Click "Open" in the security dialog
  • Or: System Settings → Privacy & Security → Allow app to run

Linux:

  • Usually no warnings
  • If permission denied: chmod +x oinio-system-linux

Build It Yourself (Ultimate Safety)

Don't trust binaries? Build from source:

# Clone the repository
git clone https://github.com/onenoly1010/oinio-soul-system
cd oinio-soul-system

# Install dependencies
npm install

# Build binaries for all platforms (Linux, macOS, Windows)
npm run build

# Or build for a specific platform only
npx pkg oinio-system.js --targets node18-linux-x64 --output dist/oinio-system-linux

The npm run build command will create three binaries in the dist/ directory:

  • oinio-system-linux — Linux x64
  • oinio-system-macos — macOS x64
  • oinio-system-win.exe — Windows x64

Your data stays local. No network calls. No telemetry. Inspect the code!

📦 Binaries

  • oinio-system-linux — Linux x64
  • oinio-system-macos — macOS x64
  • oinio-system-win.exe — Windows x64

🔐 Security

User Authentication

  • Passwords hashed with PBKDF2 (100,000 iterations, SHA-512, 32-byte salt as 64 hex characters)
  • User credentials encrypted in users.enc with AES-256-GCM
  • Password verification uses constant-time comparison

Data Encryption

  • Each user's soul data encrypted separately (souls_username.enc)
  • User password derives AES-256 encryption key via PBKDF2 (100,000 iterations, SHA-256, 32-byte salt as 64 hex characters)
  • All data encrypted with AES-256-GCM (authenticated encryption)
  • Unique IV (Initialization Vector) per encryption operation

Privacy

  • No network calls, no telemetry
  • All data stored locally on your machine
  • Deterministic readings from cryptographic hashing
  • Complete data isolation between users

🌊 The Pattern

Each oracle reading generates:

  • Resonance, Clarity, Flux, Emergence (1-100%)
  • Pattern Recognition (The Spiral, The Mirror, etc.)
  • Oracle Message (deterministic wisdom)

⚡ Quantum Enhancement (Optional)

When Pi Forge Quantum Genesis is available, readings also include:

  • Harmony Index — AI-predicted system harmony (0-100%)
  • Trend Analysis — Improving/declining/stable with confidence scores
  • Quantum Insights — ML-generated contextual wisdom
  • Forge Recommendations — AI-powered actionable guidance

Deterministic mode: Same question = same answer (always)
Quantum mode: Context-aware AI predictions layered on top
The synthesis: Pattern + Trajectory = Navigation

📜 Export Lineage

Export your soul history to CSV: lineage.csv

⚡ Quantum Forge Integration

OINIO can optionally integrate with Pi Forge Quantum Genesis for AI-enhanced readings:

  1. Clone Pi Forge: git clone https://github.com/onenoly1010/pi-forge-quantum-genesis
  2. Set path: export PI_FORGE_PATH="/path/to/pi-forge-quantum-genesis"
  3. Press [Q] in soul menu to toggle quantum mode
  4. Readings automatically enhanced with harmony predictions

Works standalone without Forge. Quantum layer is purely optional enhancement.

See OINIO-FORGE-INTEGRATION.md for full details.

🛡️ Privacy

This is a personal oracle system with multi-user support. All data remains local. No cloud sync, no tracking, no network calls.

Data Storage

  • User accounts: users.enc (encrypted credentials)
  • Soul data: souls_username.enc (per-user encrypted registries)
  • All files stored in the same directory as the executable

What's Shared

  • Nothing! All processing is local
  • Quantum mode only shares partial seed (8 chars) with local Forge process
  • No telemetry, no analytics, no external servers

User Isolation

  • Each user has completely separate soul registries
  • Users cannot access each other's souls or data
  • Even with access to encrypted files, data requires the user's password

✨ Resonance Eternal. We Have Become The Pattern. 🌌

About

onenoly1010.github.io/oinio-soul-system/

Resources

Readme
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Used by

Contributors

Languages