Skip to main content

Geometric Flow Networks: A Physics-Informed Paradigm for Sequential Intelligence

Project description

The current project documentation is out of date; in the next version, we will focus more on documentation, usage, testing, etc.

GFN: Geometric Flow Networks

A Physics-Informed Paradigm for Sequential Intelligence

Framework: GFN Models: Hugging Face DOI: 10.5281/zenodo.19141133 Status: Active Package: GFN PyPi


What is GFN?

Geometric Flow Networks (GFN) treat intelligence not as statistical pattern matching, but as the evolution of a state through a learned geometry. Where traditional architectures compute correlations between tokens, GFN computes trajectories through a manifold where state transitions follow paths of minimal resistance.

Core Distinction

┌─────────────────────────────────────────────────────────────┐
│  Statistical Models                 GFN (Geometric Flow)      │
├─────────────────────────────────────────────────────────────┤
│  Token → Correlation → Token      State → Geodesic Flow →   │
│  (weighted similarity)            (trajectory through space) │
│                                                             │
│  ❌ Statistical transformation      ✅ Geodesic state flow     │
│  ❌ Memory buffer (KV-cache)        ✅ Persistent world      │
│  ❌ Global correlation (O(N^2))     ✅ Causal locality       │
│  ❌ Probabilistic constraints       ✅ Structural invariance │
│  ❌ Likelihood coherence            ✅ Physics-grounded      │
└─────────────────────────────────────────────────────────────┘

The difference is ontological: statistical models manipulate tokens; GFN evolves a world.


The Five Pillars of Geometric Flow Networks

The GFN paradigm is defined by five structural pillars that capture its philosophical essence rather than prescribing specific implementations. These pillars distinguish GFN from both statistical models (attention, SSMs) and generic continuous models (Neural ODEs) by articulating what the paradigm fundamentally is, not how it must be computed:

1. Geodesic State Flow

The state evolves as a continuous trajectory through a learned geometry, not as a statistical transformation of tokens. This pillar captures the essential nature of GFN computation: the system computes transitions as flow along geodesics in a manifold where valid transitions correspond to trajectories of minimal resistance.

Unlike attention which computes weighted correlations, GFN computes how state moves through semantic curvature. The state possesses "semantic inertia": history manifests as trajectory shape, not as explicit storage.

2. Persistent Internal World

The state exists as a geometric configuration that persists independently of inputs; inputs perturb the trajectory without replacing the state. This pillar articulates an ontological distinction: the internal world is not a memory buffer that stores history (like a KV-cache), but a reality that is.

Inputs do not add information to a list; they curve the space-time where the state orbits. A Transformer without KV-cache forgets everything; the GFN world exists as geometry itself, not as a record of events.

3. Structural Invariance

At least one conservation law (physical, logical, or topological) governs valid transitions, making certain states structurally impossible rather than merely improbable. This is the paradigm's most philosophically distinctive pillar.

Invariants are not soft regularization or probabilistic normalization (like softmax in attention), but physical laws encoded in geometry. In logical domains (XOR), the space has toroidal topology: invalid transitions are geometrically impossible. In semantic domains, invariants are "soft" but remain structural, not statistical.

4. Causal Locality

Dynamics emerge from local interactions (forces, curvature, couplings), not from global correlation over the entire sequence. This pillar distinguishes GFN from architectures requiring simultaneous access to all historical context.

Locality here is not necessarily spatial (as in CNNs) but causal: the next state depends on forces acting on the current state, not on computing similarity with all prior tokens. This enables memory without memory buffers.

5. Physics-Grounded Computation

Validity constraints are geometric and topological, not statistical; coherence is measured in terms of curvature and conservation, not likelihood. This pillar articulates that GFN is not "more of the same with a different name".

Constraints are not learned statistics or probabilistic normalization, but validity conditions encoded in geometry. The system "knows" which states are invalid because they are topologically inconsistent, not because they are statistically improbable.


Formal Definition

A Geometric Flow Network is a neural architecture satisfying all five pillars above.

Mathematically:

$$ W_{t+1} = \mathcal{T}(W_t, f_{ext}; \theta) $$

Where:

  • $W_t$ is the internal world state at time $t$
  • $f_{ext}$ is the external input (perturbation)
  • $\mathcal{T}$ is a transfer operator that:
    • Preserves at least one invariant
    • Operates on $W_t$ and $f_{ext}$ ONLY (no history access)
    • Is differentiable with respect to a coherent metric

Comparison to Related Approaches

Architecture Persistent World Invariant Integrity O(1) Update Metric
Transformer + KV-cache No (buffer) No No No No
Mamba / SSM Yes No No Yes No
World-State Networks Yes No No Yes No
GFN Yes Yes Yes Yes Yes

Key Distinctions

GFN vs Transformer:

  • Transformer: Relies on statistical correlation → Pattern matching
  • GFN: Follows physical trajectories → Physics-constrained evolution

GFN vs SSM:

  • SSM: State can collapse or explode without constraints
  • GFN: State orbits around physically coherent solutions

GFN vs World-State Networks:

  • World-state without invariants degrades over time
  • GFN maintains coherence through geometric constraints

Latent Planning Capability

The five pillars enable a significant emergent property:

GFN can anticipate future states without token-by-token generation, by moving the state vector through the geometric flow.

This allows:

  • Future state computation through manifold flow
  • Non-autoregressive planning
  • Causal structure encoded in geometry

Complexity Characteristics

Requirement Impact
Temporal Locality O(1) inference memory
Structural Integrity Intrinsic gradient stability
All Pillars No KV-cache, no O(N^2) attention

Documentation

Citation

@article{sturtz2026geometry,
  title={Geometric Flow Networks: A Physics-Informed Paradigm for Sequential Intelligence},
  author={St{\"u}rtz, Joaqu{\'i}n},
  journal={Zenodo Preprints},
  year={2026},
  doi={10.5281/zenodo.19141132},
  url={https://doi.org/10.5281/zenodo.19141132}
}

Quick Start

pip install gfn

Or from source:

git clone https://github.com/DepthMuun/gfn.git
cd gfn
pip install -e .

Intelligence flows through geometry

Author: Joaquín Stürtz, DepthMuun Research
Version: 2.7.2
License: Apache 2.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gfn-2.7.2.tar.gz (152.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gfn-2.7.2-py3-none-any.whl (224.5 kB view details)

Uploaded Python 3

File details

Details for the file gfn-2.7.2.tar.gz.

File metadata

  • Download URL: gfn-2.7.2.tar.gz
  • Upload date:
  • Size: 152.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.3

File hashes

Hashes for gfn-2.7.2.tar.gz
Algorithm Hash digest
SHA256 1927d2c1793f41da073edb0881e6c796b51c2b870250756f3206221211f5bbdf
MD5 b24a897a282cc7328014e76d3b7f5a5d
BLAKE2b-256 d9c44df2f3a11444b184324d693605c41508c6264887b1ed3617f3c0bf26305b

See more details on using hashes here.

File details

Details for the file gfn-2.7.2-py3-none-any.whl.

File metadata

  • Download URL: gfn-2.7.2-py3-none-any.whl
  • Upload date:
  • Size: 224.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.3

File hashes

Hashes for gfn-2.7.2-py3-none-any.whl
Algorithm Hash digest
SHA256 07d4a79bd8f430c857cb9f7e1e9a3158f4944aee73951a24ec9909526f6a7eae
MD5 b24627b4b0e04d9177729228eb22aa4e
BLAKE2b-256 470fb32efae5706d9cedf00bcde644be1eda10632498e24b89786c7d6ed1c096

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page