🐜 GEIANT
Geo-Identity Agent Navigation & Tasking
The first AI orchestrator that knows where it is.
What is GEIANT?
GEIANT is a geospatial AI agent orchestration runtime built on the GNS Protocol. It is a direct competitor to LangChain, CrewAI, and AutoGen — with one structural difference: every agent has a cryptographic identity bound to an H3 territory, and every task is routed through a compliance enforcement layer before dispatch.
LangChain doesn't know where it is. GEIANT does.
The Ant Metaphor
In GEIANT, agents are ants. Ants are the canonical model of emergent collective intelligence from simple agents following spatial rules. Ant Colony Optimization (ACO) is a real algorithm used in routing and pathfinding. The colony is the orchestrated workflow. The territory is the H3 grid.
- An ant (
AntIdentity) is an agent with a GNS Ed25519 keypair + H3 territory + facet scope + trust tier
- The colony is a multi-agent workflow where ants delegate and collaborate
- The nest is the Agent Registry — the directory of available ants
- The trail is the Virtual Breadcrumb chain — the Proof-of-Jurisdiction audit log
Architecture
L6 Multi-Agent Orchestration — task graph, delegation chain enforcement
L5 IDUP Settlement Layer — Stellar payment routing per operation
L4 MCP GIS Switchboard — GDAL / PostGIS / ArcGIS / QGIS / EO models
L3 Perception Layer — IBM Prithvi, Microsoft Clay (EO Foundation Models)
L2 Geometry Validation Layer — GEOS-backed guardrails, self-intersection detection
L1 Geospatial Router — H3 jurisdiction matching, TierGate enforcement
L0 Agent Identity & Registry — Ed25519 + H3 + GNS-AIP (LIVE in gns-node)
Phase 0 (this repo): L0 + L1 + L2 core logic, tests, and API scaffold.
Monorepo Structure
geiant/
├── packages/
│ ├── core/ @geiant/core — types, router, validation, registry, jurisdiction
│ └── sdk/ @geiant/sdk — developer-facing SDK (Phase 1)
├── apps/
│ └── api/ @geiant/api — Express REST API
└── docs/ Architecture docs, ADRs
The Four Router Gates
Every task passes through four gates before any ant is selected:
- Signature Verification — Ed25519 signature over canonical task JSON
- Jurisdiction Resolution — H3 cell → country → regulatory frameworks (GDPR, EU AI Act, FINMA, CCPA...)
- Delegation Chain Validation — human GNS identity → delegation cert → scope cells + facets + expiry
- Geometry Pre-flight — GEOS-backed validation: self-intersection, coordinate transposition, unclosed rings
Only tasks that pass all four are dispatched. The router is a compliance enforcement point, not a load balancer.
Getting Started
# Install dependencies
pnpm install
# Run tests
pnpm test
# Start dev API
pnpm dev
# Test routing endpoint
curl http://localhost:3100/health
curl http://localhost:3100/registry
curl http://localhost:3100/jurisdiction/8728d55ffffffff # Rome H3 cell
curl http://localhost:3100/route/test
Competitive Position
| Feature | LangChain | CrewAI | GEIANT |
|---|
| Agent identity | API key | API key | Ed25519 GNS keypair |
| Task routing | Capability + cost | Capability + cost | H3 jurisdiction + compliance |
| Audit trail | Logs | Logs | Virtual breadcrumbs (crypto) |
| Geometry validation | None | None | Built-in guardrails |
| Human accountability | None | None | Delegation chain |
| Regulatory compliance | Manual | Manual | Proof-of-Jurisdiction |
Patent & IP
GNS Protocol Provisional Patent #63/948,788 (Proof-of-Trajectory).
GEIANT's Proof-of-Jurisdiction is a second patentable claim extending this.
License
Protocol spec: CC-BY
Core library: Apache 2.0
Managed runtime: Proprietary
GNS Foundation | Globe Crumbs Inc. | ULISSY s.r.l.
Via Gaetano Sacchi 16,
... View full README on GitHub
