GEOX is an enterprise-grade geological intelligence and subsurface coprocessor designed for modern E&P digital transformation, energy transition workflows, and automated subsurface auditing. Powered by physics-governed computation engines and strict provenance tracking, GEOX bridges raw geoscientific observation with executive capital decision-making.
Modern subsurface evaluation requires processing heterogeneous data (well logs, SEG-Y seismic, biostratigraphy, geomechanics) while maintaining an auditable lineage from observation to commercial decision. GEOX introduces Epistemic Layering, enforcing explicit segregation between empirical measurement and interpretive inference:
| Layer | Classification | Enterprise Meaning | Domain Examples |
|---|---|---|---|
| OBS | Observed | Directly measured sensor & physical data | Wireline logs (LAS), SEG-Y trace amplitudes, core measurements |
| DER | Derived | Deterministic physical & mathematical computations | Effective porosity ( |
| INT | Interpreted | Synthesized geological evaluations & frameworks | Horizons, fault polygons, reservoir-seal-charge frameworks |
| SPEC | Speculated | Unvalidated operational & fluid assumptions | Migration pathways, fluid phase boundaries, compartmentalization |
- Falsification-First Subsurface Analytics: Rather than confirming biased interpretation models, GEOX subjects all claims to rigorous physical stress-testing (falsification), reducing exploration risk and dry-hole capital wastage.
- Auditability & Provenance: Every computed attribute, horizon, or volumetric estimate generates a cryptographically sealed receipt in VAULT999, providing immutable audit trails for regulatory compliance and partner reviews.
- Vendor-Neutral Integration: Operates seamlessly alongside incumbent subsurface platforms (Petrel, DecisionSpace, PaleoScan) to validate interpretations and pipe results directly into financial decision engines.
graph TD
subgraph Data Layer [Data Ingestion & Support]
LAS[LAS 2.0/3.0 Well Logs]
SEGY[SEG-Y 2D/3D Seismic]
GEO[Geomechanical & Core Data]
end
subgraph Core Engine [GEOX Physics Engine]
OBS[OBS: Sensor Provenance]
DER[DER: Petrophysics & Seismic Computation]
INT[INT: Structural & Stratigraphic Synthesis]
end
subgraph Governance & Audit [arifOS Kernel Governance]
FALSIFY{Falsification Engine<br/>Kill Matrix K001-K007}
VAULT[(VAULT999<br/>Immutable Ledger)]
HOLD[888_HOLD<br/>Sovereign Human Review]
end
subgraph Output Layer [Enterprise Delivery]
MCP[MCP Server :8081]
WEALTH[WEALTH Capital Engine]
UI[AAA Cockpit & 4-View Canvas]
end
LAS --> OBS
SEGY --> OBS
GEO --> OBS
OBS --> DER
DER --> INT
INT --> FALSIFY
FALSIFY -->|PASS| VAULT
FALSIFY -->|REQUIRES RATIFICATION| HOLD
VAULT --> MCP
MCP --> WEALTH
MCP --> UI
GEOX delivers 33 canonical, high-performance tools accessible via standard Model Context Protocol (MCP) and REST endpoints:
- Well Log & Petrophysical Analytics (
OBS/DER): Automated LAS 2.0/3.0 ingestion, Archie & Simandoux water saturation, density-neutron crossplot porosity, and net-pay determination. - Seismic Processing & Attribute Extraction (
OBS/DER): SEG-Y header inspection, synthetic seismogram generation (Ricker/Ormsby wavelets), AVO gradient analysis, RMS sweetness, and spectral decomposition. - Structural & Basin Modeling (
DER): 6-point Malay Basin structural stress battery, K-DIP normal vector estimation, full-trace K-THROW fault displacement analysis, backstripping, and thermal maturity history. - Geomechanics & Pore Pressure (
DER): Elastic moduli calculation, stress polygon estimation, and pore pressure prediction. - Capital & Risk Routing (
INT): Automated Volumetrics (STOIIP/GIIP), Probability of Success (POS), and seamless bridging to the WEALTH organ for expected monetary value (EMV) analysis.
GEOX is deployed as a bare-metal containerized microservice or systemd daemon operating on port 8081, exposing an MCP-compliant endpoint:
Public Endpoint: https://geox.arif-fazil.com/mcp
Local Daemon: http://127.0.0.1:8081
# 1. Clone repository
git clone https://github.com/ariffazil/GEOX.git /opt/geox/app
cd /opt/geox/app
# 2. Setup environment & dependencies (Python 3.11+)
uv sync --frozen
# 3. Execute test suite (Unit & Structural Battery)
PYTHONPATH=src pytest tests/ -q --tb=short
# 4. Deploy service via systemd
systemctl restart geox-mcpTo verify production operational status and active tool availability:
curl -s http://127.0.0.1:8081/health | jq .Expected output: {"status": "healthy", "tools_loaded": 33, ...}
GEOX operates as an Earth Intelligence organ within the arifOS Federation. Every organ maintains distinct boundaries and capabilities:
| Organ | Domain Role | Port | Repo | Live MCP | Health Witness | Machine Spec |
|---|---|---|---|---|---|---|
| arifOS | Constitutional Kernel & Judge | 8088 | repo | mcp | health | llms.txt |
| A-FORGE | Governed Execution Engine | 7071 / 7072 | repo | mcp | health | llms.txt |
| AAA | Institution, Control Plane & A2A | 3001 | repo | — | health | llms.txt |
| GEOX | Earth Intelligence (Subsurface) | 8081 | repo | mcp | health | llms.txt |
| WEALTH | Capital Intelligence (Compute) | 18082 | repo | mcp | health | llms.txt |
| WELL | Vitality & Readiness Guard | 18083 | repo | mcp | health | llms.txt |
| HERMES | Multi-Modal Bridge & Telegram Relay | 8644 | repo | — | — | — |
Public Domain: arif-fazil.com · Federation Root: arifos.arif-fazil.com
- Licensing: Business Source License 1.1 (BSL-1.1), converting to open-source Apache 2.0 on 2029-06-29 (see LICENSE).
- Governance: Operating under F13 Sovereign Human Veto. Decisions requiring human oversight trigger
888_HOLDstatus until ratified by authorized asset team members.
Maintained under F13 SOVEREIGN. Built on Marmousi, validated on Volve.
DITEMPA BUKAN DIBERI — truth must cool before it rules.